Commands and Permissions

Complete reference for SoapsTeleporter 1.0.5. Main command: /st (aliases: /soapsteleporter, /teleporter).

/st help shows paginated help. /st help <command> shows detail for one subcommand. Tab completion respects permissions.

---

Portal Creation

Command	Description	Permission
/st wand	Get the portal selection wand	st.command.wand (also st.command.tool)
/st set p1	Set position 1 at your location	st.command.set
/st set p2	Set position 2 at your location	st.command.set
/st add <name>	Create a portal from selection	st.command.add
/st remove <portal>	Delete a portal	st.command.remove
/st shapepreview <preset|rotate|mirror|undo|place [material]>	Preview and place portal frames	st.command.shapepreview

Shape presets: rectangle, square, circle, oval, triangle, hexagon, octagon, random_rift.

---

Portal Connections

Command	Description	Permission
/st connect <source> <target>	Link two portals	st.command.connect
/st unlink <portal>	Remove connection	st.command.unlink
/st setrouting <portal> <fixed|random|weighted|permission>	Set routing mode	st.command.setrouting
/st setdestinations <portal> <list>	Set destination list (comma-separated; weight with weighted mode)	st.command.setdestinations

---

Portal Management

Command	Description	Permission
/st enable <portal>	Enable a portal	st.command.enable
/st disable <portal>	Disable a portal	st.command.disable
/st rename <portal> <newname>	Rename a portal	st.command.rename
/st move <portal>	Enter move mode	st.command.move
/st move cancel	Cancel move mode	st.command.move
/st reset <portal>	Reset settings to defaults	st.command.reset
/st manage [portal]	Open management UI	st.manage

---

Visual Settings

Command	Description	Permission
/st setparticle <portal> <particle>	Set particle type (DEFAULT resets)	st.command.setparticle
/st setcolor <portal> <r> <g> <b>	DUST color (0-255)	st.command.setcolor
/st setcount <portal> <count>	Particle count	st.command.setcount
/st setspread <portal> <tight> <wide>	Particle spread	st.command.setspread
/st setinterval <portal> <ticks>	Particle refresh interval	st.command.setinterval
/st setsound <portal> <sound> [volume] [pitch]	Teleport sound (NONE, DEFAULT)	st.command.setsound
/st setdirection <portal> <direction>	Exit facing	st.command.setdirection

Directions: NORTH, SOUTH, EAST, WEST, UP, DOWN, PLAYER, NONE, DEFAULT.

---

Portal Behavior

Command	Description	Permission
/st settype <portal> <standard|rtp|oneway> [world] [min] [max]	Change portal type	st.command.settype
/st setcost <portal> <amount> [type]	Set usage cost	st.command.setcost
/st setcooldown <portal> <seconds>	Cooldown between uses	st.command.setcooldown
/st setwarmup <portal> <seconds>	Warmup before teleport	st.command.setwarmup
/st setdisablesafecheck <portal> <true|false>	Toggle safety checks	st.command.setdisablesafecheck
/st setcommand <portal> <enter|exit> <command>	Add enter/exit command	st.command.setcommand

---

Conditions

Command	Description	Permission
/st setcondition <portal> <condition> [value]	Set a condition	st.command.setcondition
/st addcondition <portal> <condition> [value]	Add a condition	st.command.addcondition
/st removecondition <portal> <condition|all>	Remove condition(s)	st.command.removecondition or st.admin

Condition names: day, night, rain, thunder, clear, sun, storm, level, sneak, fly, world, biome, gamemode, item, money, advancement, playtime.

---

Information

Command	Description	Permission
/st list	List all portals	st.command.list
/st info <portal> [page]	Portal details (paginated)	st.command.info
/st tp <portal>	Teleport to a portal (/st teleport alias)	st.command.tp
/st help [command]	Help overview or command detail	None

---

Admin

Command	Description	Permission
/st reload	Reload configs and run self-test	st.command.reload
/st backup	Backup portal data	st.command.backup
/st debug	Interactive debug overview	st.command.debug or st.debug
/st debug <0-3>	Set debug log level	st.command.debug
/st debug analyze <portal>	Deep portal analysis	st.command.debug
/st debug player [name]	Player diagnostics	st.command.debug
/st debug performance	Performance report	st.command.debug
/st debug issues	Issue scanner	st.command.debug
/st debug economy	Economy status	st.command.debug
/st debug overlay	Runtime render metrics overlay	st.command.debug

Hidden from tab completion (GUI internals): manage-delete, manage-confirm-delete, teleport (use tp).

---

Permission Nodes

Broad access

Permission	Default	Description
st.admin	OP	Full admin access
st.manage	OP	Management GUI and chat UI
st.debug	OP	Debug subcommands

Command permissions

All st.command.* nodes default to OP in plugin.yml. Grant them individually to delegate staff roles:

st.command.set, st.command.add, st.command.connect, st.command.remove, st.command.list, st.command.disable, st.command.enable, st.command.reload, st.command.tp, st.command.wand, st.command.tool, st.command.info, st.command.backup, st.command.debug, st.command.setdirection, st.command.setrouting, st.command.setdestinations, st.command.shapepreview, st.command.settype, st.command.setcommand, st.command.setcondition, st.command.addcondition, st.command.reset, st.command.rename, st.command.move, st.command.unlink, st.command.setparticle, st.command.setcolor, st.command.setcount, st.command.setspread, st.command.setinterval, st.command.setsound, st.command.setcost, st.command.setcooldown, st.command.setwarmup, st.command.setdisablesafecheck

Also used in code: st.command.removecondition (not listed in plugin.yml; add manually for staff).

Player usage

Permission	Default	Description
st.portal.use	Everyone	General portal use
st.portal.use.<name>	Everyone	Per-portal access when per-portal-permissions is true
st.portal.bypass.warmup	OP	Skip warmup
st.portal.bypass.cooldown	OP	Skip cooldown
st.portal.limit.bypass	OP	Bypass creation limits
st.portal.group.*	false	Group gates (st.portal.group.<groupname>)
st.protection.bypass	OP	Break/place inside protected portal areas

---

Next Steps

• Interactive Management for GUI workflows
• Placeholders for scoreboard tokens
• Examples for practical setups