config.yml

Global settings - save interval, timezone, claimable glow and menu sounds.

Global settings. After editing, run /giftsadmin reload. This file is small on purpose: gifts carry their own colors, names and lore, so there is no global rarity or state-lore table here. The temporary icons shown on blocked clicks live in gifts-menu.yml.

A key you remove falls back to the shipped default below.

Settings

Settings:
  Save-Interval: 60
  Timezone: "UTC"
  Claimable-Glow: true

Key	Default	Description
`Save-Interval`	`60`	Seconds between saves of player data to SQLite. `0` or lower turns the timer off (data is then saved on quit, on shutdown and on claims and admin commands only). Claims are always saved immediately.
`Timezone`	`UTC`	The zone the daily reset happens in. Any region id works (`UTC`, `Europe/Berlin`, `America/New_York`, `Asia/Jakarta`, …). Gifts refresh at 00:00 in this zone, and `{refreshes-in}` counts down to it.
`Claimable-Glow`	`true`	Adds an enchant glint to every gift’s `Claimable` icon. Set `false` to rely on each icon’s own `Glow` field.

Inventories-Sounds

Named sounds in "NAME;volume;pitch" form. Names are XSeries sound names, which stay stable across Minecraft versions; a namespaced key such as minecraft:block.note_block.pling also works. Volume and pitch are optional and default to 1. Set a key to "" to silence it.

Inventories-Sounds:
  "MENU-OPEN": "ENTITY_BAT_TAKEOFF;1;0.5"
  "CLAIM": "ENTITY_PLAYER_LEVELUP;1;1.5"
  "GIFT-UNLOCKED": "ENTITY_PLAYER_LEVELUP;1;1"
  "DENY": "ENTITY_VILLAGER_NO;1;0.5"

Key	Default	Played when
`MENU-OPEN`	`ENTITY_BAT_TAKEOFF;1;0.5`	`/gifts` opens the menu.
`CLAIM`	`ENTITY_PLAYER_LEVELUP;1;1.5`	A gift is successfully claimed.
`GIFT-UNLOCKED`	`ENTITY_PLAYER_LEVELUP;1;1`	A gift reaches its playtime requirement (alongside the `GIFT-UNLOCKED` message).
`DENY`	`ENTITY_VILLAGER_NO;1;0.5`	A click is refused (gift locked or already claimed).

An unknown sound name stops the load with an error naming it.