UltimateDonutSmp V2

Free Paper, Purpur, Pufferfish, Spigot, and Folia plugin for DonutSMP-style Minecraft servers. Economy, PvP, marketplace, staff tools, menus, and network utilities in one production-focused plugin.

▶️ Click the image above to watch the UltimateDonutSMP V2 showcase video

Overview

UltimateDonutSmp V2 is a complete Paper Minecraft server plugin built for DonutSMP-style survival networks. It combines player economy, teams, homes, warps, random teleport, shop, sell, worth, crates, shards, PvP systems, staff utilities, network communication, and GUI-driven workflows into one plugin.

The goal is to reduce the number of separate plugins required for a modern SMP server while keeping configuration, player data, permissions, placeholders, and staff operations consistent across the entire server experience.

Highlights

Screenshots

Feature comparisons (UltimateDonutSMP V2 vs Original DonutSMP):

UltimateDonutSMP V2	Original DonutSMP

Feature panels and in-game menus:

Gameplay clips:

Requirements

Required plugins (the server will not enable UltimateDonutSmp V2 without them):

• PlaceholderAPI
• ProtocolLib

Optional integrations:

• LuckPerms
• Vault
• Apollo
• SkinsRestorer
• Multiverse-Core
• floodgate
• Simple Voice Chat (voicechat)

The plugin starts without the optional integrations. Their related permission, economy, client, skin, world, voice chat, and Bedrock features activate only when the corresponding plugin is installed.

Installation

1. Stop the Minecraft server.
2. Place the plugin jar into the server plugins/ directory.
3. Start the server once so the default configuration files are generated.
4. Configure storage in database.yml.
5. Review the core gameplay files such as config.yml, menus.yml, shop.yml, worth.yml, rtp.yml, and languages/<locale>.yml.
6. Restart the server after first setup.

For production networks, MySQL plus Redis is recommended. For a single-server setup, SQLite is usually enough.

Configuration

Language files are stored under languages/:

• en_US.yml
• es_ES.yml
• id_ID.yml
• pt_BR.yml
• de_DE.yml
• fr_FR.yml
• ru_RU.yml
• zh_CN.yml

On startup and reload, missing bundled configuration paths are merged into existing files. Existing files are backed up under config-backups/ before an automatic update. Live crate definitions, duel/FFA arenas, and deployment-specific network server entries are treated as user-managed data and are not restored after removal.

Commands

Commands can be disabled through their related feature toggle. Arguments in <angle brackets> are required; arguments in [square brackets] are optional. Every command has a dedicated permission node registered in plugin.yml. Most follow the ultimatedonutsmp2.command.<command> pattern; a few staff commands use a ultimatedonutsmp2.staff.* node instead, as listed below.

Temporary punishment durations accept combined values such as 30s, 15m, 2h, 5d, or 5d 15m 30s.

Running /baltop with no arguments opens the money leaderboard directly instead of the leaderboard type menu.

Permissions

true means the permission is granted by default to all players, op means it defaults to server operators, and false means it must be granted explicitly. ultimatedonutsmp2.admin is the main admin parent node, and ultimatedonutsmp2.command.* grants access to all plugin commands.

Main Parent Nodes

System & Staff Permissions

Staff Moderation & Alert Permissions

Player & Feature Permissions

Placeholders

UltimateDonutSmp V2 includes built-in PlaceholderAPI expansion modules for player economy, statistics, locations, countdowns, leaderboards, player ranks, and disguise states.

Placeholder expansion identifiers supported: %economy_*%, %uds_*%, %ultimatedonutsmp2_*%, %economylb_*%, %economyrank_*%, and %hide_*%.

Economy & Player Placeholders (%economy_*% / %uds_*% / %ultimatedonutsmp2_*%)

Leaderboard Placeholders (%economylb_*% / %economy_top_*%)

Syntax: %economylb_<type>_<position>_<property>% or %economy_top_<type>_<position>_<property>%

• Leaderboard Types (<type>): money, shards, kills, deaths, killstreak, highestkillstreak, playtime, blocksplaced, blocksbroken, mobskilled, moneyspent, moneymade
• Positions (<position>): Rank index starting from 1 (e.g. 1, 2, 3, 10)
• Properties (<property>):
  • name: Username of the player at position
  • value: Full un-truncated value of the player at position
  • value_short / short: Compact formatted value (e.g. 15.4M)
  • rank: Rank number index
  • display: Pre-formatted entry line e.g. #1 Notch: $15.4M

Examples:

%economylb_money_1_name%       -> Notch
%economylb_money_1_value%      -> $15,400,000.00
%economylb_money_1_value_short% -> 15.4M
%economylb_kills_3_display%     -> #3 Alex: 450
%economy_top_shards_1_name%    -> EnderKing

Rank Leaderboard Placeholders (%economyrank_*%)

Syntax: %economyrank_<type>%

Returns the player's personal rank position number on the specified leaderboard type (e.g. 1, 15, or 0 if unranked).

Examples:

• %economyrank_money% -> 5
• %economyrank_kills% -> 1

Hide & Disguise Placeholders (%hide_*%)

Syntax: %hide_<property>%

Support

When reporting an issue, include:

• Plugin version and jar file name
• Server software and version (Paper, Purpur, Pufferfish, Spigot, or Folia)
• Java version
• Relevant configuration snippets with secrets removed
• Console errors or stack traces
• Steps to reproduce the issue

Do not share database credentials, Redis passwords, Discord webhook URLs, or other sensitive server data in public channels.