Quick Teleporters
An automated Teleporter/Change Level region creation tool, linking regions without requiring you to manually connect them, or copy their UUIDs between region sheets. Turn on QTR in the Region controls, draw a region, and select your teleporter type between four currently available (Stairs, Level Up/Down, In-Scene, External). If you selected Stairs or Level Up/Down, you're done. If you selected In-Scene/External teleporter, draw another one either on the same scene, or another one entirely. They will be connected automatically, assigned generated names with a clean convention so a region list stays readable.
quick-teleporters· v1.0.0 · Foundry VTT v14+ (verified 14.367) · Free · System-agnostic
Requires: Wayfinder Core 1.0.3+.
Installation
Classic manifest install:
- In Foundry, open Add-on Modules → Install Module.
- Paste this into the Manifest URL field:
https://wayfindermodules.com/releases/quick-teleporters/manifest - Click Install.
Install Wayfinder Core the same way first. Every module is listed at wayfindermodules.com.
The QTR Toggle
A QTR(Quick Teleporter Region) toggle is added to the Region Controls. While enabled, every region created opens a dialog window to quickly create a teleporter with a selection of teleporter types.
Create Teleporter confirms your settings and creates a teleporter, or its first step in case of in-scene/external teleporters. Normal Region creates the region exactly as Foundry would, with no teleporter attached. Closing the window cancels the region entirely.
Teleporter Types
| Type | Description |
|---|---|
| Stairs | Default Foundry Change Level setup: one region appearing on both levels, with a movement confirmation prompt and movement type selection. |
| Level Up/Down | A destination on the level above or below, at the exact same grid coordinates. Provides a Direction dropdown to pick Up or Down. |
| In-Scene | A region created where you draw, then another region drawn somewhere else on the same scene, linking the two. |
| External | The same, except the second region is created on another scene. |
Stairs and Level Up/Down need a scene with levels; they are created on the level you are currently viewing and the one directly above/below it.
For In-Scene and External teleporters, a bar appears above the hotbar once the first end is created. Cancel abandons the process and leaves the first region as an empty region.
Two-Way
Toggling Two-Way in the dialog makes either end connect to the other, so the teleporters function both ways. Toggle it off for a one-way teleporter.
Stairs are always two-way as per Foundry's Change Level region configuration.
Automatic Names
Regions are named automatically, so a region list tells you what each entry is and which entries are linked together:
| Type | Names |
|---|---|
| Stairs | Stairs A1 |
| Level Up/Down | Teleport Up A1 and Teleport Down A1 |
| In-Scene | Teleporter - In Scene A1a and Teleporter - In Scene A1b |
| External | Teleporter - External A1a → Absalom and Teleporter - External A1b → WorldMap |
Each type counts separately, and in-scene/external teleporters are additionally marked with a lowercase a or b to differentiate them.
Additional Settings
The dialog's Additional settings section displays options for the teleporter you are drawing. Changing anything here also updates your defaults.
| Option | Effect |
|---|---|
| Placement | Where to teleport the token to inside the destination region |
| Snap to Grid | Snap the token to the grid once its teleported |
| Confirm Teleport? | Show a teleport confirmation prompt to the player who moved the token. If off, token will teleport instantly upon entering the region. |
| Name Destination? | Reveal the destination's name or keep it hidden |
| Transition | The transition animation that is played when a token teleports to another scene |
| Duration | How long the transition lasts |
Teleporter Defaults
A Teleporter Defaults window in the Wayfinder Control Panel also allows you to configure the options mentioned above outside of the QTR Create Teleporter interface.
Teleporters
A Teleporters window in the Wayfinder Control Panel lists every teleporter on the current scene and what it is connected to, if anything.
| Status | Description |
|---|---|
| Two-way | Linked in both directions |
| One-way | Teleports tokens one way |
| Stairs | A default Foundry Change Level set-up |
| One-Level Stairs | Incorrectly configured stairs spanning only one level. |
| Broken | Destination is unreachable. The destination region might have been removed |
| Unfinished | The first of two connected teleporters, with the other yet to be placed |
Settings
| Setting | Default | Effect |
|---|---|---|
| Deleting a Teleporter | Ask | Ask, Delete, or Unlink. |
Deleting a Teleporter
Whenever you delete a teleporter, the other linked region will become non-functional, as per normal Foundry behavior. In that case you will be offered three choices: Unlink strips the connection between the teleporters and leaves an ordinary region, Delete removes the other region, and Leave closes the window and does nothing to the region. Closing the window is the same as selecting Leave.
Support
Questions, bug reports, and feature requests are welcome on the Wayfinder Society Discord.