Commands and Permissions

Base command: /sf (alias: /soapsfloor). Version 1.2.4.

Player how-to

1. /sf menu or /sf list / /sf join <id> / /sf quickjoin. Spectate with /sf spectate <id>.
2. In lobby: /sf ready (toggle) or /sf skip (majority vote) to end the wait early when enabled.
3. /sf leave to exit a session or the quick-join queue.
4. /sf vote <n> during weakness voting; /sf lives during a run; /sf stats for records.
5. Host-only: /sf start when auto-start is off (after lobby unlocks).

Staff how-to

1. Wand: /sf wand create|edit|finish|… (see Room Creation Guide).
2. /sf setreward <room> <table|none>, /sf rewards list|info, /sf reload, /sf debug.
3. Join signs: place matching join-signs pattern (soapsfloor.admin.sign).
4. Grant soapsfloor.admin / wand nodes via LuckPerms as needed.

All commands

Command	Permission	Console	Description
/sf	None	No	Show help page 1
/sf help [page]	None	Partial	Player: pages 1-3. Console: reload/help/version hint only
/sf version	None	Yes	Show SoapsFloor version (ver alias)
/sf reload	soapsfloor.admin.reload	Yes	Reload all configs
/sf menu	soapsfloor.player.menu	No	Open main hub GUI
/sf stats	soapsfloor.player.stats	No	Open stats GUI
/sf settings toggle feedback	soapsfloor.player.settings*	No	Toggle editor feedback mode
/sf debug [info]	soapsfloor.admin.debug	No	Show debug status
/sf vote <number>	None	No	Cast weakness vote during active vote
/sf setreward <room> <table|none>	soapsfloor.admin.setreward	No	Assign reward table
/sf rewards list	soapsfloor.admin.setreward	No	List reward tables
/sf rewards info <table>	soapsfloor.admin.setreward	No	Inspect a reward table
/sf schematics	soapsfloor.admin.wand.schematics	No	Open the schematic browser (GUI required).
/sf schematics done|cancel|rotate|dist|ylock|undo	soapsfloor.admin.wand	No	Paste preview controls (also clickable in chat). dist needs a number; chat done / ylock still work.
/sf schematics pack create|edit|list|info|delete|validate|menu|browser|save|cancel [id|all]	soapsfloor.admin.wand	No	Weighted floor packs. Create/edit opens Pack weights GUI. Chat while editing: add / weight / remove / preview / save / cancel / list.

*soapsfloor.player.settings is defined in plugin.yml (default true). Used by /sf settings and the hub Settings button.

Room commands

Command	Permission	Description
/sf join <room_id>	soapsfloor.player.room.join	Join or enter waiting session as a fighter
/sf join <room_id> spectate	soapsfloor.player.room.join	Alias for spectate (does not take a fighter slot)
/sf spectate <room_id>	soapsfloor.player.room.join	Join as a lobby spectator (soft cap: spectator-max)
/sf ready	soapsfloor.player.room.join	Toggle ready while waiting; all fighters ready ends the wait early
/sf skip	soapsfloor.player.room.join	Vote to skip the wait; majority of online fighters ends it early
/sf quickjoin	soapsfloor.player.room.join	Join any open room as a fighter, or enter the queue if all are full
/sf list	soapsfloor.player.room.list	List all rooms (entries are clickable to join)
/sf info <room_id>	soapsfloor.player.room.info	Room details (includes party lives when a run is active)
/sf lives	None	Show shared party lives for your current run
/sf leave	soapsfloor.player.room.leave	Leave current session and teleport to the room exit (or leave the quick-join queue)
/sf start	Host of the session	Start the run when auto-start is off (after lobby unlocks)
/sf delete <room_id>	soapsfloor.admin.room.delete	Delete room (not in use)

Wand commands (/sf wand ...)

Command	Permission	Description
/sf wand create <id>	soapsfloor.admin.wand.create	Start room creation
/sf wand edit <id>	soapsfloor.admin.wand.edit	Edit existing room
/sf wand remove <id>	soapsfloor.admin.wand.remove	Delete room
/sf wand rename <old> <new>	soapsfloor.admin.wand.rename	Rename room
/sf wand status	soapsfloor.admin.wand	Session status
/sf wand list	soapsfloor.admin.wand	List floors in session
/sf wand floors	soapsfloor.admin.wand	Floor schematic config
/sf wand finish	soapsfloor.admin.wand	Save and exit editor
/sf finish	soapsfloor.admin.wand	Alias for wand finish (creators only; hidden from players without wand perm)
/sf wand leave	soapsfloor.admin.wand	Alias for finish
/sf wand cancel	soapsfloor.admin.wand	Cancel without saving
/sf wand settings toggle feedback	soapsfloor.admin.wand.settings	Toggle chat/actionbar feedback
/sf wand settings toggle actionbar	soapsfloor.admin.wand.settings	Toggle editor actionbar hints
/sf wand settings toggle preview	soapsfloor.admin.wand.settings	Toggle ghost previews

Editor hotbar: wand, starter/floor gap, Floor Editor, Falling Hazard, Room Settings (nether star; includes max players). See Room Creation Guide.

Parent soapsfloor.admin.wand is required before sub-permissions apply for status, finish, leave, cancel, list, and floors.

Join signs

Place a sign matching join-signs.lines in config.yml (default: empty / [SF] / room id / empty). Creating a join sign requires soapsfloor.admin.sign. Right-click joins the room. Breaking a join sign requires soapsfloor.admin.sign.break.

Permission tree

Permission	Default	Description
soapsfloor.*	op	All permissions
soapsfloor.admin	op	All admin permissions
soapsfloor.admin.reload	op	Reload config
soapsfloor.admin.wand	op	Parent wand access
soapsfloor.admin.wand.create	op	Create rooms
soapsfloor.admin.wand.edit	op	Edit rooms
soapsfloor.admin.wand.remove	op	Remove rooms via wand
soapsfloor.admin.wand.rename	op	Rename rooms
soapsfloor.admin.wand.settings	op	Wand editor settings
soapsfloor.admin.wand.schematics	op	Schematic browser
soapsfloor.admin.room.delete	op	Delete via /sf delete
soapsfloor.admin.debug	op	Debug command
soapsfloor.admin.gui	op	Admin control GUI
soapsfloor.admin.setreward	op	Set reward tables
soapsfloor.admin.sign	op	Create join signs
soapsfloor.admin.sign.break	op	Break join signs
soapsfloor.bypass.protection	op	Break/place in protected rooms
soapsfloor.player	true	All player permissions
soapsfloor.player.menu	true	/sf menu
soapsfloor.player.stats	true	/sf stats
soapsfloor.player.room.join	true	Join rooms
soapsfloor.player.room.leave	true	Leave rooms
soapsfloor.player.room.list	true	List rooms
soapsfloor.player.room.info	true	Room info
soapsfloor.player.settings	true	Hub settings / /sf settings

LuckPerms examples

/lp group admin permission set soapsfloor.admin true
/lp group default permission set soapsfloor.player true
/lp group builder permission set soapsfloor.admin.wand true
/lp user Steve permission set soapsfloor.bypass.protection true

Role templates

Role	Permissions
Player	soapsfloor.player
Builder	soapsfloor.admin.wand, soapsfloor.admin.wand.schematics
Moderator	soapsfloor.admin.room.delete, soapsfloor.bypass.protection
Admin	soapsfloor.admin

Command blocking during runs

From countdown through celebrating, players without soapsfloor.admin can only run /sf / /soapsfloor (including namespaced /soapsfloor:…). Waiting lobby is unrestricted. Message key: error.command-blocked.

This blocks Essentials/CMI/Admin teleports and utilities without maintaining per-alias lists. Full soft-compat details: Integrations.