DonutShards

A configurable shard economy and reward foundation for modern Paper and Folia servers.

DonutShards brings an original donut-and-cosmic currency system to Minecraft servers. Balances are stored in a durable SQL ledger, economy operations run asynchronously, and player-facing Bukkit interactions are routed through region-safe schedulers.

Current features

Virtual shard balances stored as 64-bit integers
Add, remove, set, and transfer operations
Atomic taxed player transfers
Negative-balance and overflow protection
Idempotent transaction keys and transaction history storage
SQLite storage by default
Optional MariaDB and compatible MySQL storage
HikariCP connection pooling
Basic recurring shard rewards
Original Cosmic Confection Exchange inventory GUI
MiniMessage-formatted messages
Asynchronous public Java API
Paper and genuine Folia scheduler abstraction
Configurable balance maximum and transfer tax

Commands

/shards balance [player]
/shards pay <player> <amount>
/shardshop
/afk leave
/shardmanager give <player> <amount>
/shardmanager take <player> <amount>
/shardmanager set <player> <amount>

Aliases for /shards are /donutshards and /dshards.

Compatibility

Server software: Paper and Folia
Minecraft: 1.20.1 through 26.1.2
Plugin bytecode: Java 21
Minecraft 26.1.2 runtime: Java 25, as required by Paper/Folia

Minecraft 26.2 is not currently claimed because a stable dual-platform Paper/Folia release was not available when this build was produced.

Installation

Download the DonutShards JAR.
Place it in the server's plugins directory.
Start the server and wait for the database-ready message.
Stop the server before editing generated configuration files.
Restart and verify the selected database connection.

SQLite works without additional setup. MariaDB/MySQL users should configure a dedicated, least-privilege database account in database.yml.

Important release status

Version 1.0.0 is an early functional foundation. Advanced AFK-zone management, persistent shop delivery reconciliation, transaction rollback commands, leaderboards, Vault/PlaceholderAPI hooks, migration tools, and administration editors are planned but are not complete in this build.

Support and bug reports

Include the following when reporting a problem:

DonutShards version
Paper or Folia version
Minecraft and Java versions
Sanitized relevant console logs
Exact reproduction steps

Never publish database passwords, private network addresses, or the contents of a production database.

Donut Shards