Default Config Files

Last updated Jul 27, 2026

Default Config Files

Bundled YAML ships inside the SoapsAdmin jar and is copied into plugins/SoapsAdmin/ on first run when the file is missing. Edit the server copies. Jar defaults are not re-applied over existing files.

Reload after edits: /sa reload, /sa reload <target>, or module-specific reloads listed in Getting Started.

Core

File Purpose
config.yml Bootstrap: storage, help visibility, soft integration toggles, GUI master switch pointers
modules.yml Enable/disable feature modules
messages.yml Player-facing MiniMessage text
customcommands.yml Typed aliases, overrides, disabled built-ins, blocked vanilla commands

Split Feature Configs

File Purpose
staff.yml Staff mode tools, vanish, spectator, inventory snapshots
teleport.yml Warmups, homes, warps, TPA, spawn, death respawn, claim hooks
server.yml Backups, worlds, broadcasts, announcements, tickets, spawnmob limits
player.yml AFK, friends, nicknames, playtime, double doors, weather vote, death coords, seek item

Economy / Shop / Kits

File Purpose
economy.yml Currencies, Vault primary, mob/Mythic drops
prices.yml Shop catalog buy/sell prices
kits.yml Kit definitions and cooldowns
daily.yml Daily reward settings
trade.yml Player-to-player trade

Chat / Moderation

File Purpose
chat.yml Filter, spam, slowmode, staff chat, spy
moderation.yml Punishments, freeze, reports, item blacklist, QP templates
jails.yml Jail room definitions
rules.yml /sa rules content

Teleport Extras / QoL

File Purpose
rtp.yml Random teleport bounds and cooldown
waypoints.yml Waypoint markers / display
player-utilities.yml Item filter, autopickup, autosell, privacy toggles
playervaults.yml Extra vault sizes, limits, autopickup

Content / Server Tools

File Purpose
recipes.yml Custom / Crucible recipes
clearlag.yml Clearlag intervals, exclusions, min age
mining-audit.yml Mining stats / xraycheck
deathmessages.yml Custom death messages
joinmessages.yml Join/quit messages

GUI

File Purpose
gui/_settings.yml GUI folder master toggle, filler, border, click sound
gui/system-gui.yml Panel cosmetics (material, name, lore, slot) for Java GUIs; copied on first run

Cosmetics only — see GUIs and Menus. Reload: /sa reload gui.

Data (created at runtime)

Not jar templates for editing feature defaults, but common paths:

Path Purpose
data/server/spawners.yml Spawner overrides
data/social/mail/{uuid}.yml Per-player mail
data/storage/vaults/{uuid}.yml Player vaults
data/settings/prefs.yml Player preferences
Discord