SnGifts changelog

Changes

• Reward names. A rewards.yml entry can now be a map with a command and an optional name. Plain command lines keep working exactly as before, and both forms can be mixed:

  rewards:
    - command: "pets admin givebox {player} Box_Basica 1 -sf"
      name: "&6Basic Box"
    - "give {player} diamond 1"

• {name} in messages.gift-claimed lists the names of the rewards the claim paid: A, A and B, A, B and C. Unnamed rewards are left out; a claim with no named reward shows reward-names.none.
• New lang section reward-names: (separator, last-separator, none), merged into existing language files on boot.
• Names are stored with the day's draw (new table sngifts_reward_names, created automatically), so a restart mid-day keeps them.

Upgrading from 2.0.0

• Your existing gift-claimed value is kept: add {name} to it where you want it.
• The current day's draw was made before names existed, so names appear from the next daily reset, or right away with /gifts resetgifts.
• rewards.yml is never rewritten by the plugin; add command/name entries by hand.

Requirements

Requires SnLib.jar 1.27.0 or newer.

Daily playtime gifts for Paper servers. Players accrue playtime, tiers unlock as they hit their thresholds, and each tier pays a set of rewards drawn fresh every gift day.

Requires SnLib 1.27.0 or newer

This is not optional and it is not a soft warning. The required API level is compiled into this jar, so SnGifts 2.0.0 refuses to enable on any server whose SnLib.jar is older than 1.27.0 and says so in the console. Update SnLib first.

What it does

• Playtime tiers. Any number of gift tiers, each with its own time-needed-minutes. Order is by threshold ascending, so inserting a tier never renumbers the ones players already know.
• A configurable menu. Placement lives entirely in guis/gifts.yml as a layout mask plus named regions - move, add or remove cells without touching a slot number.
• Reward pools. rewards.yml holds the pool; each gift day draws from it and persists the draw, so every player who claims a tier that day gets the same reward set. Supports console commands with {player} and vault:<amount> for economy payouts.
• A daily reset on your own schedule and timezone, with a server-wide announcement.
• Per-address claim limits to blunt alt farming, with a bypass permission for staff.
• Unclaimed reminders and unlock notifications, both on their own intervals.
• SQLite or MySQL, all I/O off the main thread.
• PlaceholderAPI and Vault are both optional and detected at runtime.

Commands

sngifts.use gates the whole command tree, including the admin subcommands. If you restrict it, grant it to staff as well.

Configuration

Every player-facing string lives in lang/messages_en.yml and every value in config.yml. Both are managed: new keys are merged in on update while your edits and comments are preserved, so you never have to diff a config by hand. There is no config-version key to maintain.

Notes

• claim.ip-limit-per-gift ships at 1. On a network behind a proxy without IP forwarding, or for households and CGNAT, set it to 0 to disable the limit - config.yml documents the trade-off inline.
• The jar is obfuscated and licence-gated. It checks its licence once at startup and does not phone home afterwards.