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
- Configuration to toggle
gui.enabled - Commands and Permissions for equivalent commands
- Integrations for external plugin hooks