ВЕРСИИ (9)

# 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.

# 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