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 Jul 27, 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 hub
/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 hub
player-dashboard Player hub
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 / baltop Economy
custom-command-settings Custom command editor
custom-command-builder Collect action/replace steps while creating
custom-command-type Create type picker
warps / friend-list / trade Player utilities
player-vault Player vault contents (dynamic rows)
spawner-editor / recipe-browser / itemeditor Content tools
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
Discord