Interactive Management

Last updated Jul 6, 2026

Interactive Management

Edit portal settings without memorizing every subcommand. SoapsTeleporter offers two management modes controlled by gui.enabled in config.yml.


Opening the Manager

/st manage [portal]

Permission: st.manage

gui.enabled Behavior
true (default) Opens chest inventory menus from gui.yml
false Opens clickable chat categories and prompts

Without a portal name, the GUI shows the paginated portal list. Chat mode expects a portal name argument.


GUI Mode (Default)

When GUI is enabled, /st manage <portal> opens the main menu with categories:

Menu Purpose
Portal Info Dashboard with coordinates, stats, and quick actions
Visual Effects Particle type, color, count, spread
Audio Settings Sound, pitch, volume, disable sound
Economy and Timing Cost, cooldown, warmup
Connection Connect, unlink, type, direction selectors
Conditions Paginated condition list and add-condition wizard
Commands Enter and exit command lists
Admin Enable/disable, rename, move, delete

GUI actions

Many buttons open chat input for values (particle name, cost, rename, etc.). Type cancel to abort.

Connection menus include:

  • Connect selector (paginated portal picker)
  • Type selector (Standard, One-Way, RTP)
  • Direction selector (compass-style facing)

Confirm dialogs protect destructive actions like delete.

Customize menu text and layout in gui.yml. See Default Config Files.


Chat Mode (gui.enabled: false)

When GUI is disabled, /st manage <portal> prints clickable chat categories:

Category Settings
Visual Effects Particles, color, count, spread, interval
Audio Settings Sound, pitch, volume presets
Economy and Timing Cost, cooldown, warmup
Connection Settings Connect, unlink, type, direction, routing
Conditions and Requirements Full condition builder
Commands and Events Enter and exit commands
Administrative Enable, disable, rename, move, reset

Breadcrumbs show your location, for example: Portal Management > Conditions > Add Condition.

Paginated command and condition lists include previous/next navigation and per-item delete buttons.


Portal Commands in Management

Enter commands run when a player enters the source portal (before teleport).

Exit commands run when a player arrives at the destination.

Use %player% as the player name placeholder.

Examples:

say Welcome %player%!
give %player% diamond 1
effect give %player% speed 30 1

Add via GUI buttons, chat prompts, or:

/st setcommand <portal> enter <command>
/st setcommand <portal> exit <command>

Shape Preview (Command-Based)

Frame planning stays on commands (not a GUI menu):

/st shapepreview <preset>
/st shapepreview rotate
/st shapepreview mirror
/st shapepreview undo
/st shapepreview place [material]

See Portal Creation.


Internal Commands

These run from GUI delete confirmations and are hidden from tab completion:

  • /st manage-delete
  • /st manage-confirm-delete

Players should use the GUI or chat buttons instead of typing these directly.


Next Steps

Discord