Configuration Reference

Configuration Reference

31 YAML files live in plugins/UltimateDonutSmp2/. Each one has its own page with every key, type, and shipped default. plugin.yml is not listed — edit commands through Commands & Permissions, not that file.

Rules that apply to every file

• Use spaces, never tabs.
• /ultimatedonutsmp2 reload (also /uds reload) picks up most edits. dialog.yml → PAUSE-SCREEN needs a full restart.
• Dialog screens need a Java client 1.21.6 or newer. 1.21.5 and older render a broken UI. See Dialog API & older clients.
• New keys from an update are merged in. Your old file is copied to config-backups/. Crates you defined, plus pvp.yml ARENA/KITS and the arena blocks in duels.yml / ffa.yml, are never overwritten.
• If a file is marked translated, change wording in languages/<locale>.yml and leave this file for layout and numbers. See Localization & Messages.

I want to…

…	Open
Change language, features, chat, combat, teleports	config.yml
Switch storage, or join servers with Redis	database.yml, network.yml
Change sell prices	worth.yml
Change the shop / shard shop	shop.yml
Move a menu button	menus.yml
Set up crates or spawners	crates.yml, spawners.yml
Set up ranked PvP, duels, or FFA	pvp.yml, duels.yml, ffa.yml
Change staff tools or punishments	staff-mode.yml, offenses.yml
Change the sidebar	scoreboard.yml
Change a sound	sounds.yml

Every file

File	What it is for	Translated?
amethyst-tools.yml	Timed Drill, Chopper, and other premium tools	Yes
anvil-moderation.yml	Block slurs and ads in anvil renames	No
auction-house.yml	Rules for /ah listings, claims, and bots	Yes
config.yml	Language, features, chat, combat, teleports, shards	No
crates.yml	Crate keys, animations, and weighted rewards	Yes
database.yml	SQLite / MySQL / MongoDB, plus optional Redis	No
death-messages.yml	Wording for custom death messages	Yes
dialog.yml	Native 1.21.6+ dialog screens (pay, homes, pause)	Yes
discord.yml	Punishment and staff webhooks (no bot)	No
duels.yml	1v1 queue, arenas, rollback, cross-server	Yes
enchantments.yml	Orders enchantment-picker layout	No
ender-chest.yml	Network ender chest size and /ecsee	Yes
ffa.yml	Instanced FFA rollback and player state	Yes
filter.yml	Item categories for AH / Orders browse buttons	No
freeze.yml	What a frozen player can still do	Yes
hide.yml	Scramble names and /disguise skins	No
invsee.yml	Staff inventory inspector layout	Yes
menus.yml	Every chest GUI layout	Yes
network.yml	This server's name, /servers, maintenance	Yes
offenses.yml	Preset /offend punishments and wipe flag	No
orders.yml	Buy-order board, matching, Bedrock forms	Yes
pvp.yml	Ranked arena, Elo, kits, schematic reset	Yes
rtp.yml	Random teleport worlds, cache, and queue	Yes
scoreboard.yml	Sidebar layouts (MODERN / LEGACY)	No
server-wipe.yml	Season reset worlds and confirmation token	Yes
shop.yml	Quick Buy + shard shop	Yes
sounds.yml	Every sound the plugin plays	No
spawn-stash.yml	Staff bait chests and alerts	Yes
spawners.yml	Stacked spawners that store drops	Yes
staff-mode.yml	Staff hotbar, vanish, fake players	Yes
worth.yml	Sell prices and worth tooltips	Yes

---

Option counts are generated from src/main/resources, so they track the shipped files exactly.