Portal Actions

Portal actions define what happens when a player enters a portal. You can configure portals to teleport players, transfer them to other servers, execute commands, or link to other portals.

Command

Set Portal Action

Set the action that occurs when a player enters the portal.
Usage: /portal action <portal> <action> ...

Available Actions

Teleport to Coordinates

Teleports to specific coordinates in a world.
Usage: /portal action <portal> teleport <world> [<position>] [<rotation>]

Examples:

# Teleport to spawn coordinates
/portal action spawn-portal teleport minecraft:overworld

# Teleport with specific location
/portal action spawn-portal teleport minecraft:overworld 0 64 0

# Teleport with rotation
/portal action nether-portal teleport minecraft:the_nether 100 64 100 90 0

Link to Another Portal

Teleports to another portal's location.
Usage: /portal action <portal> teleport-portal <target>

Examples:

# Link portal-a to portal-b
/portal action portal-a teleport-portal portal-b

# Create bidirectional link
/portal action portal-a teleport-portal portal-b
/portal action portal-b teleport-portal portal-a

# Create one-way portal network
/portal action hub teleport-portal zone-1
/portal action zone-1 teleport-portal zone-2
/portal action zone-2 teleport-portal hub

Random Teleport

Teleports players to a random safe location within specified bounds or radius.
Usage: /portal action <portal> teleport-random <world> ([<from>]|[<center>]) ...

Examples:

# Random teleport without bounds
/portal action random-portal teleport-random minecraft:overworld

# Random teleport within 1000 block radius around 0, 64, 0 with a 100 block height limit
/portal action random-portal teleport-random minecraft:overworld 0 64 0 1000 100

# Random teleport with custom bounds
/portal action random-portal teleport-random minecraft:overworld -1000 -64 -1000 1000 319 1000

Random teleport locations are always evaluated for safety.
Players will only be teleported to safe locations (solid ground, no lava, etc.).
If you want to enable cave spawns, set the allowCaveSpawns option to true in the config.

Connect to Network Server

Connects players to another server in your BungeeCord/Velocity network.
Usage: /portal action <portal> connect <server>

Examples:

# Connect to lobby server
/portal action lobby-portal connect lobby

# Connect to survival server
/portal action survival-portal connect survival

# Connect to minigames server
/portal action games-portal connect minigames

This action requires a BungeeCord or Velocity proxy setup.
The server name must match the server name configured in your proxy.

Transfer to External Server

Transfers players to a server outside your proxy network using hostname and port.
Usage: /portal action <portal> transfer <hostname> [<port>]

Examples:

# Transfer to external server
/portal action transfer-portal transfer play.example.com

# Transfer to local test server on port 25566
/portal action test-portal transfer localhost 25566

# Transfer to partner server
/portal action partner-portal transfer partner.example.net

This action transfers players to servers outside your proxy network.
In order for this to work, the remote server must be configured to accept transfers.

Run Command as Player

Executes a command as the player who enters the portal.
Usage: /portal action <portal> run-command <command>

Examples:

# Join gungame
/portal action gungame-portal run-command gungame join

# Join a bedwars game
/portal action bedwars-portal run-command bedwars join duos

The command is executed as the player.
The player must have permission to run the command.

Run Console Command

Executes a command from the console when a player enters the portal.
Usage: /portal action <portal> run-console-command <command>

Examples:

# Give player an item from console
/portal action reward-portal run-console-command give <player> diamond 1

# Broadcast a message
/portal action event-portal run-console-command broadcast <player> entered the arena!

# Add player to a team
/portal action team-portal run-console-command team join red <player>

Use <player> as a placeholder for the player's name.

Remove Action

Removes the current action from a portal, making it inactive.
Usage: /portal action <portal> remove

Examples:

# Remove action from portal
/portal action spawn-portal remove

Portal Actions

On this page