Tutorial / Tools > Building
Teleporters
Pads or zones that teleport players who walk into them.
What it does
Teleporters sends players somewhere when they walk into it. A teleporter is either a pad (a plate on the ground) or a zone (no prop, only a glowing ring).
A teleporter goes to one of two destinations. A linked pair connects an entrance to an exit, one-way or two-way. A warp teleporter sends players to a saved warp point.
Blue teleporters are active. Orange ones are exit only and send nobody anywhere. Permanent teleporters are saved for the map and come back after map cleanups and restarts.
Where to find it
Q menu > KGX's Admin Toolbox > Building > Teleporters.
Admins can use it, and players who are given it in Settings > Player Access. Players can only go to, rename or remove their own teleporters (from the list and with right click), and send teleporters only to public warps.
Given to a player (v3.6.11.3): Placed where they stand, small pads and zones, public warps only, never saved for the map; their own teleporters only.
Controls
| Key | What it does |
|---|---|
| Left click | Place a teleporter (pairs: entrance first, then exit) |
| Right click | Remove the teleporter nearest to where you aim |
| Reload | Cancel an unfinished pair |
While the tool is out, a yellow ring at your crosshair shows the trigger radius. The text under the crosshair says "Place the ENTRANCE", "Now place the EXIT (reload cancels)" or the warp new teleporters go to.
Options
| Option | What it does | Default |
|---|---|---|
| Style | Pad (plate on the ground) or Zone (no prop, glowing ring). | Pad |
| Destination | Linked pair (place entrance, then exit) or Saved warp point. | Linked pair |
| Two-way pair (exit also sends back) | Off makes a one-way pair: the exit does not send players back. | On |
| Trigger radius | How close players must be to trigger it. Slider 16 to 256. | 40 |
| Cooldown per player (s) | Time before the same player can teleport again. Slider 0.5 to 30. | 2 |
| Permanent (saved for this map; admins only) | Saves the teleporter for this map. Off makes it undoable instead. Players' teleporters are never saved. | On |
| Name for new teleporters (shown above them, optional) | A name shown above the teleporter, up to 32 characters. | Empty |
| Warp list | The warp that Saved warp point teleporters go to. Click a row to pick it. | None |
| Reset to defaults | Puts every option back to its default. |
Teleporters on this map
The list shows Name, Goes to and Saved for every teleporter. Goes to reads "warp: name", "pair", or "exit only".
| Control | What it does |
|---|---|
| Double-click a row | Go there. |
| Right-click a row | Go there, Rename... or Remove. |
| Rename selected teleporter... | Names the selected teleporter. Empty clears the name. |
| Refresh list | Reloads the list. |
How to use it
Link two rooms both ways
- Set Destination to Linked pair and tick Two-way pair.
- Left-click the floor in the first room. You get "Entrance placed. Left-click again to place the exit."
- Left-click the floor in the second room. Both teleporters turn blue.
Send players to a warp point
- Make the warp first with Functions > Warp Points.
- Set Destination to Saved warp point and click the warp in the list.
- Left-click where the teleporter should go.
Cancel or remove
- Press reload to remove an entrance whose exit you have not placed.
- Right-click near any teleporter to remove the nearest one within 96 units.
Settings and commands
| Setting | What it does | Default | Range |
|---|---|---|---|
kgxat_limit_teleporters |
Most teleporters a non-admin player may have (Settings > Limits). 0 = not allowed. | 6 | 0 to 100 |
Tips and limits
- Permanent teleporters are stored in
data/kgx_admin_toolbox/teleporters_<map>.json. - A player who arrives on a teleporter must step out of it before it can send them again.
- Dead, jailed, ragdolled and spectating players, and players in vehicles, are not teleported.
- A teleporter frozen with Functions > Freeze does not send anyone.
- Nobody can pick up teleporters with the physgun or gravity gun.
- Removing one teleporter of a pair turns its partner into an exit only (orange).
- Left click with Saved warp point and no warp picked gives "Pick a warp in the tool menu first."
- A pad lies flat on the aimed surface.
- Teleporters that are not permanent can be removed with your undo key.