SnReclaim changelog

A one-time, rank-based reclaim system built on SnLib. Every entry under ranks: names a Vault permission group; a player who belongs to that group can redeem that rank's reward exactly once, ever. /reclaim redeems every qualifying unclaimed rank at once.

Requirements

• Java 21+, Paper 1.20.4+
• SnLib.jar in plugins/. Updating SnLib always needs a full restart, never a reload.
• A license key in the shared plugins/.Sn-License/license.yml (bundle mode), not in the plugin's own folder - a server already running another bundle plugin needs nothing new.
• Vault and a groups-based permissions plugin such as LuckPerms. PlaceholderAPI is optional.

Commands

The admin subcommands are deliberately NOT nested under /reclaim admin, so macros, signs and console scripts keep working.

Permissions

Configuration

• config.yml holds redeem.*, join-notify.*, database.*, command.aliases and the ranks: table. SnLib merges new keys in on boot and preserves your values and comments; no config-version key exists. The ranks: section is owner-extensible: entries you delete stay deleted.
• command.aliases adds aliases. It cannot take away /rc, which plugin.yml registers at load time.
• Player-facing text lives in lang/messages_en.yml. Set lang: in config.yml to load a different lang/messages_<code>.yml.
• Claims are stored in SQLite (database.file, default data.db) in the table snreclaim_claims. database.type: mysql is supported.
• Update notices go only to holders of snreclaim.admin.update.

Reliability guarantees

• A failed claim read fails closed. It is never installed in the cache as "this player has claimed nothing" - the claims stay unknown and nothing is granted until they can be read, so a transient database error cannot re-grant rewards a player already redeemed.
• A claim whose write fails is retried through the cache's flush, so it survives a relog instead of living only in memory for the session.
• /reclaim and /reclaim reset report their failure paths instead of answering with silence.
• A reward command that kicks the player does not burn the remaining ranks' one-time claims.
• A rank that can grant nothing, and two rank keys that differ only in case, are skipped instead of consuming a claim.
• Join notifications never stack one task per relog.