Commands and Permissions

Library

SoapsCommon as a library does not register player commands for menus. Suite plugins own their commands. Common registers GUI action permissions used when menu YAML runs privileged work.

Permission	Default	Description
soaps.gui.action.console	op	Allow GUI YAML actions that run console commands
soaps.gui.action.broadcast	op	Allow GUI YAML actions that broadcast messages

Grant only to staff who author or use such menus. See GUI System.

---

Event Engine (module)

Nodes ship in plugin.yml.
The /soaps command has no root permission. Subcommands check their own nodes so players can use mute and me.

Staff commands

Command	Description	Permission
/soaps	Dashboard (admin) or player view	soaps.engine.admin / soaps.engine.player
/soaps gui	Staff dashboard	soaps.engine.admin
/soaps events	Event list GUI or CLI list	soaps.engine.events
/soaps events list	List saved events	soaps.engine.events
/soaps events start <id>	Start event	soaps.engine.events.start
/soaps events stop <id> [--cleanup]	Stop running event; --cleanup also runs the cleanup step Dos	soaps.engine.events.stop
/soaps join <code>	Join via clickable chat prompt	soaps.engine.player
/soaps events test <id>	Test run	soaps.engine.events.test
/soaps events info <id>	Validate / summary	soaps.engine.events
/soaps events enable|disable <id>	Toggle	soaps.engine.events.edit
/soaps events clone <from> <newId>	Duplicate	soaps.engine.events.create
/soaps events delete <id>	Delete	soaps.engine.events.delete
/soaps events extend <id> <duration>	Extend running step	soaps.engine.events.start
/soaps pools	List pools / open GUI	soaps.engine.events
/soaps pools start <id>	Start one event from pool (weight / chance / list)	soaps.engine.events.start
/soaps pools enable|disable <id>	Toggle pool	soaps.engine.events.edit
/soaps running	Running panel / list	soaps.engine.events
/soaps reload	Reload definitions / settings	soaps.engine.reload

Player commands

Command	Description	Permission
/soaps me	Player event browser	soaps.engine.player
/soaps mute	Mute event broadcasts and boss bars	soaps.engine.player

Aliases: /soapscommon, /scn.

Permissions (engine)

Permission	Default	Description
soaps.engine.admin	op	Full engine dashboard
soaps.engine.events	op	View / manage events
soaps.engine.events.create	op	Create / clone
soaps.engine.events.edit	op	Edit / enable
soaps.engine.events.delete	op	Delete
soaps.engine.events.start	op	Start
soaps.engine.events.stop	op	Stop
soaps.engine.events.test	op	Test
soaps.engine.reload	op	Reload engine data
soaps.engine.player	true	Player browser / mute

Dangerous Dos (console commands, large spawns) respect the command sandbox and admin perms. There is no separate GUI confirm checkbox in 2.0.1.

Staff Start (GUI or /soaps events start) ignores the event’s definition cooldown. Pool starts still honor pool and event cooldowns. Use Test for dry runs without requiring Enable.

---

See also

• Event GUI
• GUI System
• FAQ