Placeholders and Integrations

Placeholders & Integrations Guide

UltimateDonutSMP includes native PlaceholderAPI expansions, soft-dependency hooks, and network integrations.

---

🧩 PlaceholderAPI Expansion (%economy_*%)

Install PlaceholderAPI on your server to use these placeholders in scoreboards, tablists, chat formats, holograms, and DeluxeMenus.

Money & Economy Placeholders

Placeholder	Output Description
%economy_money%	Raw player money balance (e.g. 1500.50)
%economy_nicestMoney%	Compact money format (e.g. 1.5K, 2.3M)
%economy_money_short%	Short money format
%economy_money_formatted%	Formatted money with configured currency symbol
%economy_money_symbol%	Configured currency symbol (e.g. $)
%economy_money_symbol_color%	Currency symbol color code
%economy_money_color%	Money value color code
%economy_money_name%	Money currency singular name

Shards Placeholders

Placeholder	Output Description
%economy_shards%	Raw shard count
%economy_nicestShards%	Compact shard count format
%economy_shards_short%	Short shard format
%economy_shards_formatted%	Formatted shard count with symbol
%economy_shards_symbol%	Configured shard symbol (e.g. ✦)

Leaderboards Placeholders (<1-10>)

• Money Top: %economy_top_money_1_name%, %economy_top_money_1_value%, %economy_top_money_1_display%
• Shards Top: %economy_top_shards_1_name%, %economy_top_shards_1_value%, %economy_top_shards_1_display%
• Kills Top: %economy_top_kills_1_name%, %economy_top_kills_1_value%
• Deaths Top: %economy_top_deaths_1_name%, %economy_top_deaths_1_value%
• Playtime Top: %economy_top_playtime_1_name%, %economy_top_playtime_1_value%

Player Stats & Network Placeholders

Placeholder	Output Description
%economy_kills%	Player kill count
%economy_deaths%	Player death count
%economy_playtime%	Formatted player playtime
%economy_team%	Team name (or none)
%economy_ping%	Player latency in milliseconds
%economy_username%	Player name (respects vanish/hide settings)
%economy_keyall_countdown%	Time remaining until next Key-All broadcast
%economy_booster_countdown%	Time remaining for active server booster
%economy_rtp_countdown%	Time remaining for RTP zone cooldown
%economy_billford_countdown%	Time remaining until Billford trade rotation
%economy_shard_cuboid_display%	Shard cuboid HUD action text
%economy_shard_cuboid_status%	Shard cuboid state (inside / outside)
%economy_shard_cuboid_name%	Active Shard Cuboid region name
%economy_coords%	Player coordinates (X, Y, Z)

---

🔌 Soft Dependencies & Integrations

UltimateDonutSMP seamlessly hooks into the following plugins when installed:

1. Vault: Registers UltimateDonutSMP as the primary economy provider for third-party plugins.
2. LuckPerms: Inherits group ranks and checks permission nodes dynamically.
3. ProtocolLib: Used for packet-level entity lures, fast crystal placements, and disguise rendering.
4. Apollo (Lunar Client): Displays custom waypoints, team member markers, and combat cooldown indicators on Lunar Client.
5. SkinsRestorer: Preserves custom player skin textures in GUI menus and head skulls.
6. Multiverse-Core: Inherits world safety flags and spawn points.
7. Floodgate (Bedrock): Fixes form GUI layouts for Bedrock Geyser players joining from mobile or consoles.