Repository navigation
Home
One plugin for a DonutSMP-style survival network: money and shards, shops and auctions, homes and RTP, duels / FFA / ranked PvP, crates, spawners, and staff tools — one database, one config set.
Must install first: ProtocolLib and PlaceholderAPI. Without either, the plugin disables itself.
Java clients must be 1.21.6 or newer. Minecraft 1.21.5 and older cannot render the Dialog API
menus (broken /ah, /menu, /homes, and similar). That is a Mojang client limit, not a plugin
bug — block those versions on the proxy or ViaVersion. Bedrock players on Geyser have the same
Dialog API limit; /shop uses chest menus but pinning items needs Floodgate. See
Dialog API & older clients.
| Step | Page |
|---|---|
| 1. Install and first boot | Installation & Setup |
| 2. Pick a file to edit | Configuration Reference |
| 3. Grant commands | Commands & Permissions |
| 4. Learn one feature | The six pages under Features in the sidebar |
Stuck? Start at the FAQ. If menus look broken on an older client, read Dialog API & older clients.
| Page | What you set up |
|---|---|
| Economy & Marketplaces | Money, shards, /shop, /sell, Auction House, Orders |
| Crates & Spawners | Keys, chest crates, stacked spawners, Amethyst Tools |
| Duels & Instanced FFA | 1v1 queue and throwaway FFA instances |
| Ranked PvP Arena | Persistent arena, Elo, kits (ships off) |
| Cuboids & Portals | Regions for spawn, AFK, shards, RTP, portals |
| Staff & Security | Staff mode, freeze, vanish, punishments, wipes |
-
Placeholders & Integrations —
%economy_*%, Vault, Redis, Discord -
Localization & Messages — 8 languages; there is no
messages.yml -
Dialog API & older clients — Java 1.21.5-and-older clients and Bedrock (Geyser) dialog limits;
/shop+ Floodgate
/billford is listed in the jar but does nothing. Do not configure it. Details in the FAQ.
| Version | 1.0 |
| Servers | Paper, Purpur, Pufferfish, Spigot, Folia |
| Minecraft | Server 26.1.2–26.2 (checked on startup). Java clients 1.21.6+ — see Dialog API & older clients
|
| Java | Compiled for 21. Use the JDK your server build needs. |
| Storage | SQLite (default), MySQL, or MongoDB |
| Network | Redis, optional |
| Config | 31 YAML files, 8 language files |
| Commands | 143 declared; /billford has no handler |
UltimateDonutSMP V2 1.0 · Paper / Purpur / Pufferfish / Spigot / Folia · Minecraft 26.1.2–26.2 · Java clients 1.21.6+
- Economy & Marketplaces
- Crates & Spawners
- Duels & Instanced FFA
- Ranked PvP Arena
- Cuboids & Portals
- Staff & Security
Core
Menus & display
Economy
Progression
PvP
Staff