Donut Shards
A configurable shard economy and reward foundation for modern servers
Автор: NAIZO3,9 тыс.2обновлён 28 сент. 2026 г.
ЭкономикаМеханики игрыУтилиты
Описание
DonutShards is a configurable shard economy and reward foundation for modern Paper and Folia servers. It introduces an original donut-and-cosmic virtual currency system backed by a durable SQL ledger, asynchronous economy operations, safe player transfers, recurring rewards, and a Cosmic Confection Exchange GUI.
Features
| Feature | Description |
|---|---|
| Virtual Shard Economy | Player shard balances stored as 64-bit integers |
| Economy Operations | Add, remove, set, and transfer shard balances |
| Atomic Transfers | Taxed player transfers processed atomically |
| Balance Protection | Negative-balance and overflow protection |
| Transaction Ledger | Transaction history with idempotent transaction keys |
| SQLite Storage | Local SQLite database supported by default |
| MariaDB & MySQL | Optional MariaDB and compatible MySQL storage |
| HikariCP Pooling | Efficient SQL connection pooling |
| Recurring Rewards | Basic recurring shard reward functionality |
| Cosmic Confection Exchange | Original inventory GUI for shard-based interactions |
| MiniMessage Support | MiniMessage-formatted player-facing messages |
| Async Java API | Asynchronous public API for plugin integrations |
| Paper & Folia Support | Region-safe scheduler abstraction for both platforms |
| Configurable Economy | Configurable maximum balance and transfer tax |
Shard Economy
DonutShards provides a dedicated virtual currency that can serve as the foundation for rewards, shops, progression systems, and custom server mechanics.
Balances are stored as 64-bit integers in a durable SQL-backed ledger.
Economy Operations
- Add shards
- Remove shards
- Set balances
- Transfer shards between players
- Apply configurable transfer tax
- Enforce a configurable maximum balance
- Prevent negative balances
- Protect against numeric overflow
Player Transfers
Players can transfer shards directly to other players.
Transfers are handled atomically so the debit and credit operations are treated as one transaction.
Transfer Features
- Player-to-player shard payments
- Configurable transfer tax
- Atomic balance updates
- Negative-balance protection
- Overflow protection
- Transaction history
- Idempotent transaction keys
Transaction Ledger
DonutShards stores economy activity in a persistent SQL-backed transaction system.
The transaction foundation includes:
- Persistent player balances
- Transaction history storage
- Idempotent transaction keys
- Atomic economy operations
- SQL-backed durability
Idempotent transaction keys help prevent the same logical transaction from being applied multiple times when an operation is retried.
Storage
DonutShards supports multiple SQL storage options.
SQLite
SQLite is the default option and works without additional database infrastructure.
It is suitable for:
- Standalone servers
- Simple installations
- Development environments
- Servers that do not require an external database
MariaDB & MySQL
MariaDB and compatible MySQL storage can be used when an external database is preferred.
Database connections use HikariCP connection pooling.
Production installations should use a dedicated, least-privilege database account.
Recurring Rewards
DonutShards includes basic recurring shard rewards, providing a foundation for periodically rewarding players as part of a server economy or progression system.
Advanced AFK-zone management is planned but is not complete in version 1.0.0.
Cosmic Confection Exchange
DonutShards includes the original Cosmic Confection Exchange inventory GUI.
The interface provides a foundation for shard-based shop and reward interactions using Minecraft's familiar inventory system.
Persistent shop delivery reconciliation and advanced administration editors are planned but are not complete in version 1.0.0.
Performance & Safety
DonutShards is designed around asynchronous database operations and modern Minecraft scheduling requirements.
The plugin includes:
- Asynchronous economy operations
- Asynchronous public Java API
- HikariCP connection pooling
- Paper scheduler abstraction
- Genuine Folia scheduler abstraction
- Region-safe player-facing Bukkit interactions
- Atomic transfer handling
- Balance overflow protection
- Negative-balance protection
- Idempotent transaction processing
Commands
| Command | Description |
|---|---|
/shards balance [player] | View a shard balance |
/shards pay <player> <amount> | Transfer shards to another player |
/shardshop | Open the shard shop |
/afk leave | Leave the current AFK interaction |
/shardmanager give <player> <amount> | Give shards to a player |
/shardmanager take <player> <amount> | Remove shards from a player |
/shardmanager set <player> <amount> | Set a player's shard balance |
Aliases for /shards:
/donutshards/dshards
Java API
DonutShards exposes an asynchronous public Java API for integrations with other plugins.
The API is designed around asynchronous economy operations so integrations do not need to perform SQL work directly on server or region threads.
Configuration
Current configuration supports:
- Maximum shard balance
- Player transfer tax
- SQLite storage
- MariaDB/MySQL storage
- Database connection settings
- Recurring reward behavior
- MiniMessage-formatted messages
MariaDB/MySQL installations should configure a dedicated, least-privilege database account in database.yml.
Installation
- Download the DonutShards JAR.
- Place it inside the server's
plugins/directory. - Start the server and wait for the database-ready message.
- Stop the server before editing generated configuration files.
- Configure the desired database and economy settings.
- Restart the server.
- Verify that the selected database connection initializes successfully.
SQLite works without additional setup.
Compatibility
| Requirement | Version |
|---|---|
| Server Software | Paper & Folia |
| Minecraft | 1.20.1 through 26.1.2 |
| Plugin Bytecode | Java 21 |
| Minecraft 26.1.2 Runtime | Java 25 |
Minecraft 26.2 is not currently claimed because a stable dual-platform Paper/Folia release was not available when this build was produced.
Release Status
DonutShards 1.0.0 is an early functional foundation.
The following advanced functionality is planned but not complete in this build:
- Advanced AFK-zone management
- Persistent shop delivery reconciliation
- Transaction rollback commands
- Leaderboards
- Vault hooks
- PlaceholderAPI hooks
- Migration tools
- Administration editors
Why Choose DonutShards?
- Dedicated Shard Economy — Adds an independent virtual currency for custom progression and rewards.
- Durable Transactions — SQL-backed balances, transaction history, and idempotent keys provide a reliable foundation.
- Safe Transfers — Atomic transfers, balance protection, overflow protection, and configurable taxation protect currency operations.
- Flexible Storage — Use SQLite out of the box or connect to MariaDB/MySQL.
- Modern Performance — Economy and database operations are asynchronous and designed around Paper/Folia scheduling.
- Developer Friendly — An asynchronous public Java API provides a foundation for integrations.
- Expandable Foundation — The 1.0.0 release establishes core systems for future shops, rewards, leaderboards, hooks, and administration features.
Support & Bug Reports
When reporting a problem, include:
- DonutShards version
- Paper or Folia version
- Minecraft version
- Java version
- Sanitized relevant console logs
- Exact reproduction steps
Never publish database passwords, private network addresses, or the contents of a production database.
Community & Support
- Discord: https://discord.gg/TJc3CxR4jK
- GitHub: https://github.com/MeherBenSalem
- Website: https://nightbeam.dev
- Store: https://nightbeam.dev/store
- CurseForge: https://www.curseforge.com/members/nightbeamstudio/projects
- Modrinth: https://modrinth.com/organization/nightbeam
If you encounter a bug or have a feature request, please join the Discord community or report it through the appropriate project page.
License
DonutShards is licensed under the Apache License 2.0.
You are free to use, modify, and redistribute DonutShards in accordance with the terms of the Apache License 2.0.
Последние версии
Все версии →release
1.5.2
1.5.228 сент. 2026 г.1,9 тыс.Minecraft: 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
# 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.
release
1.5.2
1.5.228 сент. 2026 г.19Minecraft: 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
# 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.
release
1.5.1
1.5.127 авг. 2026 г.1,1 тыс.Minecraft: 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
# 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
release
1.5.0
1.5.027 авг. 2026 г.8Minecraft: 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
# 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
release
1.4.0
1.4.024 авг. 2026 г.111Minecraft: 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
# 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.
release
1.3.0 · paper · 1.20.1
1.3.0+paper-1.20.118 авг. 2026 г.36Minecraft: 1.20.1paper
Что нового
# 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.
release
1.2.0 · paper · 1.20.1
1.2.0+paper-1.20.112 авг. 2026 г.327Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
# 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.
release
Donut Shards 1.1.0
1.1.010 авг. 2026 г.30Minecraft: 1.20.1, 1.20.4, 1.20.6, 1.21, 1.21.1, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, folia, paper, purpur, spigot
Что нового
# 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.
release
Donut Shards 1.0.0
1.0.011 июл. 2026 г.389Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, purpur, spigot
Что нового
- init release