Donut Shards
Running a Minecraft server is about more than just blocks and mobs—it is about creating a world where players feel invested. The Donut Shards add-on delivers exactly that by introducing a whimsical, donut-and-cosmic currency system that turns everyday gameplay into a rewarding economic loop. Whether you manage a small community or a sprawling network, this plugin gives you the tools to build a stable, configurable shard economy on modern server platforms.
What Makes Donut Shards Stand Out?
Unlike simple scoreboard-based currencies, Donut Shards stores every balance in a durable SQL ledger. Economy operations run asynchronously, so your server’s main thread never lags during high-traffic moments. Player-facing interactions are routed through region-safe schedulers, making the plugin a perfect fit for both Paper and Folia servers. The result is a lightweight yet powerful foundation that you can trust with your community’s virtual wealth.
Core Features at a Glance
- Virtual shard balances stored as 64-bit integers for precision and scale.
- Add, remove, set, and transfer operations with atomic taxed transfers between players.
- Negative-balance and overflow protection to keep the economy fair.
- Idempotent transaction keys and a full transaction history for auditing.
- SQLite storage out of the box, with optional MariaDB and compatible MySQL support via HikariCP connection pooling.
- Recurring shard rewards that can be configured to drip-feed currency to active players.
- An original Cosmic Confection Exchange inventory GUI for immersive item purchases.
- MiniMessage-formatted messages for rich, colorful feedback.
- A public Java API for developers who want to extend the economy.
Compatibility and Server Requirements
Donut Shards is built for modern server software. It runs on Paper and Folia servers, supporting Minecraft versions from 1.20.1 up to 26.1.2. The plugin bytecode targets Java 21, and when running on Minecraft 26.1.2, it uses Java 25 as required by the latest Paper and Folia builds. Note that Minecraft 26.2 is not yet claimed because a stable dual-platform release was not available at the time of this build. Always check your server’s Java version before installation to avoid class compatibility issues.
How to Install Donut Shards
Getting started is straightforward. First, download Donut Shards as a JAR file from your trusted source. Place the JAR into your server’s plugins directory. Start the server and wait for the console message confirming the database is ready. Then stop the server before you edit any generated configuration files—this prevents accidental overwrites. Restart and verify the database connection. SQLite works immediately with no extra setup. If you prefer MariaDB or MySQL, open database.yml and configure a dedicated, least-privilege database account. That is all it takes to bring a cosmic economy to your world.
For those who want an even smoother experience, the foxygame.net launcher includes Donut Shards in its curated add-on catalog, letting you install the plugin with a single click while the launcher automatically matches the correct version to your server’s Minecraft release.
Commands and Player Interaction
Donut Shards ships with a clean set of commands that players and admins will find intuitive. The main player command is /shards, which also responds to the aliases /donutshards and /dshards. Here is what you can do:
/shards balance [player]– Check your own or another player’s shard count./shards pay <player> <amount>– Send shards to another player with a configurable tax./shardshop– Open the Cosmic Confection Exchange GUI to spend shards on items./afk leave– Mark yourself as away; integrates with the planned AFK-zone system.
Administrators have a separate /shardmanager command for direct economy control:
/shardmanager give <player> <amount>/shardmanager take <player> <amount>/shardmanager set <player> <amount>
All transactions are logged, and the idempotent transaction keys prevent duplicate payments even if a command is spammed.
Why Choose Donut Shards for Minecraft?
Many economy plugins are either too bloated or too fragile. Donut Shards for Minecraft strikes a balance by focusing on a single, well-executed currency system. The asynchronous design means it scales with your player count, and the SQL backend ensures that no shard is ever lost to a crash. The built-in Cosmic Confection Exchange gives players a tangible way to spend their earnings, which drives engagement far better than a simple number in a scoreboard.
Server owners who value stability will appreciate the careful scheduler abstraction that works identically on Paper and Folia. This means you can switch server software without rewriting your economy. The configurable balance maximum and transfer tax let you fine-tune inflation, while the recurring rewards system keeps casual players logging in daily.
Planned Features and Current Limitations
Version 1.0.0 is an early functional foundation. The developer, Nightbeam, has outlined a roadmap that includes advanced AFK-zone management, persistent shop delivery reconciliation, transaction rollback commands, leaderboards, Vault and PlaceholderAPI hooks, migration tools, and administration editors. These are not yet complete, so if you need deep integration with other plugins right now, you may need to wait. However, the core economy is fully operational and ready for production use on servers that want a clean, standalone currency.
Getting Support and Reporting Bugs
When you encounter an issue, include the Donut Shards version, your Paper or Folia version, Minecraft and Java versions, sanitized console logs, and exact reproduction steps. Never share database passwords, private network addresses, or production database contents. The plugin is copyright Nightbeam 2026, and redistribution or modification requires prior written authorization.
Donut Shards transforms the way your server handles value. With its cosmic theme, robust SQL storage, and player-friendly commands, it is an excellent choice for anyone looking to download Donut Shards and launch a fresh economy. Whether you install it manually or discover it through the foxygame.net launcher’s add-on catalog, you are giving your community a reason to play, trade, and collect.