?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Donut Shards

Donut Shards

A configurable shard economy and reward foundation for modern servers

3.9Kdownloads
2followers
3.9Kdownloads
2followers

Links

Report issues View source Join Discord server
Donate

Tags

Creators

Details

Licensed Apache-2.0
Published 3 months ago
Updated last month
All versions

1.4.0

Release
1.4.02 months ago 111
Download

Compatibility

Minecraft: Java Edition
26.2
26.1.x
1.21.x
1.20.1–1.20.6
Platforms
Bukkit
Folia
Paper
Purpur
Spigot

Changes

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.