config.yml

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.

Settings

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

Key	Default	Description
Save-Interval	60	Seconds between write-behind flushes of player data to SQLite. Claims are always written immediately regardless of this.
Timezone	UTC	The zone the daily reset happens in. Any ZoneId name 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 a gift’s claimable icon. Set false to rely on each icon’s own Glow field.

Timezone must be a valid zone id

The value is passed straight to ZoneId.of(...). An unknown name (or an abbreviation like EST) throws on load and the plugin fails to start. Use a full region id or UTC.

Temporary-Icons

Feedback icons that flash for about two seconds in the clicked slot when a click is refused, then restore the real gift icon. While a slot is flashing it is inert - further clicks are swallowed, so the deny sound and message can’t be spammed.

Both entries are optional. Remove one and that click simply plays the deny sound and sends its message with no icon flash. Each is a standard item definition.

Temporary-Icons:
  Locked:
    Material: BARRIER
    Name: "&c&lError!"
    Lore:
      - "&7You cannot claim this gift yet!"
  Already-Claimed:
    Material: BARRIER
    Name: "&c&lError!"
    Lore:
      - "&7You already claimed this gift!"

Key	Flashed when
Locked	The player clicks a gift whose playtime requirement is not met.
Already-Claimed	The player clicks a gift already claimed today.

Inventories-Sounds

Named sounds in "NAME;volume;pitch" form. Names are XSound names, which stay stable across Minecraft versions. 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	Played when
MENU-OPEN	/gifts opens the menu.
CLAIM	A gift is successfully claimed.
GIFT-UNLOCKED	A gift crosses its playtime requirement (alongside the GIFT-UNLOCKED message).
DENY	A click is refused (locked or already claimed).