SnReclaim changelog

Changes

{rango} now resolves PlaceholderAPI for the redeeming player. A rank whose display-name is itself a PlaceholderAPI token - display-name: '%snrankperks_prefix%' - reached chat as literal text at both places the rank name is rendered. Both are fixed:

• Broadcast (messages.redeem-broadcast): the announcement had no player to resolve against. The plain broadcast delivers with a null viewer, and a player-bound expansion placeholder has no answer for a null requester, so the token survived verbatim. The announcement now names the redeeming player as the broadcast subject (SnLib 1.34.0): PlaceholderAPI resolves against them once and every recipient sees their value.
• Private message: lines: PlaceholderAPI ran on the configured lines first and {player} / {rango} were spliced in afterwards, so a token carried by the display name was inserted after the PAPI pass. The pairs now travel into the config read ahead of PlaceholderAPI (order: locals, then PAPI), so a display name that is a token resolves in the private message too.

display-name accepting PlaceholderAPI is now documented in config.yml, the README and the GitBook page.

Requirements

Built against SnLib 1.34.0, API level 21. The plugin refuses to enable on an older SnLib and says so in the console with the API level handshake message - update SnLib.jar first (a full restart, never a /reload).

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.