Donut Shards

Changelog

1.5.2

- Compatibility: Minecraft 26.3 (Paper API 26.3.build.49-alpha; boot-tested on Paper 26.3 ALPHA build 133). Folia has no 26.3 build; Folia 26.2 remains supported. - Compile: JDK 25 is required to compile against the 26.3 API; plugin bytecode stays Java 21. - Fix: resolve sounds, particles, enchantments, and kill-reward entity types through Bukkit registries with valueOf/constant fallbacks (Sound.valueOf is deprecated-for-removal on 26.3). Particle lookup does not assume Keyed, which 1.20.1 Particle does not implement. - Publish: GitHub workflow builds with Java 25 and tags Modrinth/CurseForge with the full supported game-version and loader lists from release/supported-minecraft.json.

1.5.1

- Fix: /afk zone uses teleportAsync and runs sync/messages on the destination entity thread (Folia-safe). - Fix: bare /afk join no longer double-sends zone-enter + joined messages. - Fix: leaderboard GUI page-size capped at 45; Next paging no longer phantom-bounces at the SQL top-100 cap. - Docs: COMMANDS / CONFIGURATION / patch notes aligned with 1.5.0 command changes.

1.5.0

- Fix: Home AFK cancels on block-coordinate move, then zone presence syncs. - Feature: AFK zone enter/leave chat; bare /afk = home; reward titles; /afk zone teleport; GUI /shards top; convert currency-first; admin tab cleanup; /dshards/donutshards → /shardmanager.

1.4.0

- Feature: YamlKeyMerger deep-merges missing keys from jar defaults on enable and reload without overwriting operator values. - Feature: Shop items support confirmation: and post-purchase commands: with %player%, %uuid%, %item%, %price% placeholders. - Feature: /shards confirmation on|off toggles shop confirm GUI (stored in player-prefs.yml, default on); /shard command alias. - Feature: PlaceholderAPI expansion donutshard_* (balance, top names, top balances). - Feature: /shards top leaderboard command. - Feature: bStats metrics (plugin id 33616, shaded/relocated); bstats: true in config. - Feature: Modrinth update checker for project 4krPhA6H; update-check: true in config. - Compatibility: Paper/Folia/Purpur/Spigot/Bukkit · Minecraft 1.20.1–26.2; jar name …-mc1.20.1-26.2.jar.

1.3.0

- Fix: messages.yml is loaded and reloaded; user-facing strings can be customized via message keys. - Fix: shop.yml drives the shard shop (items, prices, layout); reload applies without restart. - Feature: Shop items support optional Bukkit enchantments in shop.yml. - Feature: Conversion rate-mode: dollar-batch ($100 = 1 shard), dollar-multiple validation, per-direction fees. Default servers keep 100 shards per dollar. - Feature: AFK zone boundary particles (configurable type, interval, view radius). - Tweak: AFK auto-rejoin when inside a zone after /afk leave (afk.auto-rejoin-in-zone, default true). - Docs: CONFIGURATION.md updated for conversion, shop, messages, and zone-particle keys.

1.2.0

- Vault-backed shard money conversion via /shards convert <amount> <shards|money> (shards.convert permission). - Stay-in-place AFK home mode (/afk home, /afk zone) with configurable reduced shard multiplier; rewards require zone or home when enabled. - Kill rewards for player and mob kills loaded from kills.yml, with per-player PvP cooldown and spawner-mob exclusion. - Reward loop now respects AFK zone/home eligibility and configurable interval/shard amounts in config.yml. - Release build copies jar to releases/; GitHub publish workflow added for Modrinth/CurseForge.

1.1.0

- AFK zones load and save from zones.yml with spherical regions (world, center, radius). - /afk list, /afk join [name], /afk leave, and /afk info work with configured zones. - /shardmanager zone create|delete|list persists zones in-game; /shardmanager reload reloads configuration. - Movement and join listeners auto-detect when players enter or leave AFK regions. - Expanded .gitignore for Gradle, IDE, database, and local env artifacts.

1.0.0

- Initial original DonutShards economy, scheduler abstraction, SQLite/MariaDB schema, asynchronous API, commands, grouped rewards, zone state, and inventory shop foundation.

# DonutShards 1.5.1 — Patch Notes Release date: August 2026 ## Summary Hotfix for Folia-safe /afk zone teleport after 1.5.0, plus small AFK join messaging and leaderboard paging fixes. Full 1.5.0 feature set is unchanged. ## Fixes - /afk zone uses teleportAsync; sync + success message run on the destination entity thread - Bare /afk join no longer doubles afk-zone-enter with afk-joined - /afk leave while in home mode shows afk-home-off - Leaderboard GUI page-size capped at 45; Next button respects the top-100 SQL cap - COMMANDS.md / CONFIGURATION.md / bundled patch notes updated for 1.5.x behavior ## Upgrade notes 1. Replace the 1.5.0 jar with 1.5.1 and restart (or reload after swap on a test server). 2. No new config keys required beyond 1.5.0. ## Compatibility - Platforms: Paper, Folia, Purpur, Spigot, Bukkit - Minecraft: 1.20.1 – 26.2 - folia-supported: true

# DonutShards 1.5.0 — Patch Notes Release date: August 2026 ## Summary DonutShards 1.5.0 fixes stay-in-place Home AFK not cancelling when you walk, and ships the AFK/leaderboard QOL from ticket-0020. The release jar targets Paper, Folia, Purpur, Spigot, and Bukkit on Minecraft 1.20.1 through 26.2. ## Bug fixes - Home AFK cancels on move — block-coordinate movement now disables home mode, sends afk-home-cancelled-move, then syncs zone presence so walking into a zone can auto-join. - Folia-safe messaging for the cancel notice via the entity scheduler. ## AFK | Change | Detail | |---|---| | Zone enter/leave chat | Auto presence sends afk-zone-enter / afk-zone-leave; command join/leave still use afk-joined / afk-left | | Bare /afk | Same as /afk home (status: /afk info) | | /afk zone | Teleports to closest zone center (or afk.zone-teleport.preferred-zone) | | Reward titles | Title reward-title + subtitle next-reward with <amount>, <time>, <next_reward> | ## Economy / commands | Change | Detail | |---|---| | /shards top | Opens leaderboard GUI (leaderboard.page-size); /shards top chat for chat list | | /shards convert | Now /shards convert <shards\|money> <amount> (currency then amount) | | Tab-complete | Admin suggests only give\|take\|set\|reload\|zone | | Aliases | /dshards and /donutshards move to /shardmanager; players keep /shards + /shard | ## Upgrade notes 1. Replace the jar and restart (or /shardmanager reload after swapping on a test server). 2. YamlKeyMerger adds new message/config keys without overwriting your values. 3. Update any scripts that used /shards convert <amount> <currency> to the new currency-first order. 4. Players who used /dshards as a balance command should switch to /shards or /shard. ## Build - Artifact: DonutShards-1.5.0-paper-folia-mc1.20.1-26.2.jar (shadow jar with relocated bStats). - Requires Java 21. ## Compatibility - Platforms: Paper, Folia, Purpur, Spigot, Bukkit - Minecraft: 1.20.1 – 26.2 (see release/supported-minecraft.json) - folia-supported: true

# DonutShards 1.4.0 — Patch Notes Release date: August 2026 ## Summary DonutShards 1.4.0 merges missing YAML keys on upgrade, adds shop purchase confirmations and post-purchase commands, registers PlaceholderAPI placeholders, and ships bStats metrics plus a Modrinth update checker. The release jar targets Paper, Folia, Purpur, Spigot, and Bukkit on Minecraft 1.20.1 through 26.2. ## Configuration merge On enable and /shardmanager reload, the plugin deep-merges missing keys only from jar defaults into existing config.yml, messages.yml, shop.yml, gui.yml, and other managed files. Operator values are never overwritten. Upgraded servers automatically gain keys such as afk-joined without losing a custom prefix. ## Shop | Feature | Detail | |---|---| | confirmation: per item | Opens confirm/cancel GUI from gui.yml when enabled | | /shards confirmation on\|off | Player toggle stored in player-prefs.yml (default on) | | commands: per item | Console commands after purchase with %player%, %uuid%, %item%, %price% | ## PlaceholderAPI Registered when PlaceholderAPI is present: | Placeholder | Meaning | |---|---| | %donutshard_balance% | Viewer balance | | %donutshard_top_<1-10>% | Player name at rank | | %donutshard_top_bal_<1-10>% | Balance at rank | ## Metrics and updates - bStats plugin id 33616 — set bstats: false in config.yml to opt out. - Modrinth update check — async check against project 4krPhA6H; ops are notified in-game when a newer release exists. Set update-check: false to disable. ## Commands - /shards top — shard balance leaderboard (top 10). - /shard alias for /shards. ## Build - Artifact: DonutShards-1.4.0-paper-folia-mc1.20.1-26.2.jar (shadow jar with relocated bStats). - Requires Java 21. ## Compatibility - Platforms: Paper, Folia, Purpur, Spigot, Bukkit - Minecraft: 1.20.1 – 26.2 (see release/supported-minecraft.json) ## Upgrade notes 1. Replace the jar and restart (or reload after swapping on a test server). 2. Run /shardmanager reload if you only need message/shop merges without restart. 3. Existing messages.yml and shop.yml keep your values; new keys appear automatically.

Changelog

1.3.0

- Fix: messages.yml is loaded and reloaded; user-facing strings can be customized via message keys. - Fix: shop.yml drives the shard shop (items, prices, layout); reload applies without restart. - Feature: Shop items support optional Bukkit enchantments in shop.yml. - Feature: Conversion rate-mode: dollar-batch ($100 = 1 shard), dollar-multiple validation, per-direction fees. Default servers keep 100 shards per dollar. - Feature: AFK zone boundary particles (configurable type, interval, view radius). - Tweak: AFK auto-rejoin when inside a zone after /afk leave (afk.auto-rejoin-in-zone, default true). - Docs: CONFIGURATION.md updated for conversion, shop, messages, and zone-particle keys.

1.2.0

- Vault-backed shard money conversion via /shards convert <amount> <shards|money> (shards.convert permission). - Stay-in-place AFK home mode (/afk home, /afk zone) with configurable reduced shard multiplier; rewards require zone or home when enabled. - Kill rewards for player and mob kills loaded from kills.yml, with per-player PvP cooldown and spawner-mob exclusion. - Reward loop now respects AFK zone/home eligibility and configurable interval/shard amounts in config.yml. - Release build copies jar to releases/; GitHub publish workflow added for Modrinth/CurseForge.

1.1.0

- AFK zones load and save from zones.yml with spherical regions (world, center, radius). - /afk list, /afk join [name], /afk leave, and /afk info work with configured zones. - /shardmanager zone create|delete|list persists zones in-game; /shardmanager reload reloads configuration. - Movement and join listeners auto-detect when players enter or leave AFK regions. - Expanded .gitignore for Gradle, IDE, database, and local env artifacts.

1.0.0

- Initial original DonutShards economy, scheduler abstraction, SQLite/MariaDB schema, asynchronous API, commands, grouped rewards, zone state, and inventory shop foundation.

# Patch Notes — 1.2.0 Three community-requested features ship together. Conversion: exchange shards and server money through Vault with configurable rates and fees (/shards convert). Home AFK: earn reduced shards anywhere with /afk home without standing in a zone; /afk zone returns to full zone rewards. Kill rewards: PvP and mob kills grant shards from kills.yml (PvP cooldown, no spawner farms). ## 1.1.0 AFK zones are now fully functional. Admins create spherical regions with /shardmanager zone create <name> at their location; zones persist in zones.yml. Players use /afk join (auto-detects when standing inside a zone), /afk leave, /afk list, and /afk info. Entering or leaving a region is tracked automatically for reward eligibility. /shardmanager reload refreshes zone and config data without a restart. ## 1.0.0 This first release establishes the Java 21 Paper/Folia-compatible architecture, persistent integer ledger, idempotent transaction keys, original Cosmic Confection Exchange, grouped reward loop, and public API. The validated build range is 1.20.1–26.1.2; 26.2 is intentionally not claimed.

# Patch Notes — 1.1.0 AFK zones are now fully functional. Admins create spherical regions with /shardmanager zone create <name> at their location; zones persist in zones.yml. Players use /afk join (auto-detects when standing inside a zone), /afk leave, /afk list, and /afk info. Entering or leaving a region is tracked automatically for reward eligibility. /shardmanager reload refreshes zone and config data without a restart. ## 1.0.0 This first release establishes the Java 21 Paper/Folia-compatible architecture, persistent integer ledger, idempotent transaction keys, original Cosmic Confection Exchange, grouped reward loop, and public API. The validated build range is 1.20.1–26.1.2; 26.2 is intentionally not claimed.

- init release