SoapsUniverse
SoapsAdmin
SoapsAdmin

Getting Started

Home

[Home](README.md)

IntroductionGetting StartedModulesConfigurationComparison: EssentialsX · CMI · SoapsAdminCommands IndexCommands: PlayerCommands: ModerationCommands: StaffCommands: EconomyCommands: AdminGUIs and MenusModerationEconomy and ShopSpawnersRecipes and CrucibleItem EditorFake Players / MannequinsMail and Player InfoChat and MessagingCustom CommandsPlayer VaultsTeleportationPermissionsPlaceholdersIntegrationsDefault Config FilesExamplesFAQChangelog

GUIs and Menus

Last updated Sep 18, 2026

GUIs and Menus

SoapsAdmin GUIs are Java-backed admin/staff panels. Cosmetics (material, display name, lore, slot) come from MERGED skins in system-gui.yml.

SoapsAdmin does not ship a general YAML menu builder. A future SoapsMenus plugin may cover that.

Global Toggles

Setting File Effect
gui.enabled config.yml Master kill switch for all GUIs
enabled gui/_settings.yml GUI folder master toggle
Filler/border/sounds gui/_settings.yml Defaults for all panels

Opening Panels

Command Description
/sa dashboard Player dashboard
/sa admin Admin dashboard
/sa admin <panel> Open a specific admin panel
/sa gui list List loaded system panel skins

/sa gui list shows built-in panel skins. Reload cosmetics with /sa reload gui.

Reskinning Built-in Panels

  1. Edit plugins/SoapsAdmin/gui/system-gui.yml (copied from the jar on first run)
  2. Change material, name, lore, and slot only
  3. /sa reload gui

Delete system-gui.yml and reload to restore jar defaults. Do not treat this file as a full menu scripting format. Click logic stays in Java.

Common system menu IDs

Menu ID Purpose
dashboard Admin dashboard
player-dashboard Player dashboard
staffpanel Online player browser
health Server health
reports Report list
ticket-list / ticket-view Support tickets
kit-list / kit-manager / kit-editor Kits
economy-admin / economy-baltop / economy-select / baltop Economy
shop-hub / shop-buy / shop-sell Shop
homes / warps / friend-list / trade Player utilities
custom-commands / custom-command-settings / custom-command-builder / custom-command-type / custom-command-disabled Custom commands
broadcast-templates Broadcast template browser
audit-hub / audit-browser Audit tools
gamerules Gamerule editor
attributes Attribute editor
waypoint-list / spawner-list Lists
player-vault / vault-list Player vaults
spawner-editor / recipe-browser / itemeditor Content tools
rtp-worlds RTP world picker
mail-inbox / rules / motd-editor Misc

Files in gui/

File Role
_settings.yml Global filler, border, sounds
system-gui.yml Cosmetic skins for built-in panels (jar default on first run)
README.txt Short note on reskinning