Subscribe to download
Teleporters: Players & Ships

Ever needed to just be on that other platform?
Want a quicker way to reach your ship on the other side of the map?
Teleporter beacons allow you to do just that.

Need to get your ship there too? Use a gate beacon, which is exactly the same but for ships.

How to use:
- Place a beacon
- Name the beacon with one of the tags
- Add a button or sensor that sets the beacon power to ON
- Place a similar setup somewhere else
- Activate one of the beacons to teleport to the other beacon
- Add yet another identical setup to create a teleporter chain
- Activate to travel to the next beacon in the chain.

A message will appear on world load and on renaming of a beacon.
Either to inform you a teleporter was added or removed.

You can separate teleporter chains by giving them the same text after teleporter.

Teleporter format: TAG <chain name>
TAGS: teleporter, teleport or tp
Chain name: the name of the network

Gate format: gate <chain name>

For example: teleport 1
Would link all teleporters named "teleport 1"
If you have three or more teleporters with the same name, it will find the source in the list and pick the next one.
This should result in a stable circular teleporter network.

You can mix the tags used to connect to a chain.
Examples:
- "TP" connects to the "" chain
- A chain called " A", with three teleporters: "TP A" connects to "tp A" which connects to "TeLePOrt a" which connects back to "TP A"
- "TPA" connects to the "A" chain and NOT the " A" chain

If you add something to the tag (like: TP Alpha) then all those teleporters will chain with identically named teleporters.
Teleporters in a chain will teleport you to the next one in the chain, this allows you to create multiple chains each with multiple locations.

Things to know:
- The teleporter triggers when power is turned on (it does not trigger if power is already on)
- The teleporter will turn itself off after use.
- To teleport you need to be within 7 meters of the beacon, this requires close proximity to the beacon.
- If you just teleported to a destination, that teleporter is put on a 3 second cool down, which prevents sensor based teleporters from immediately activating.
- Using a button or sensor, set it to toggle on/off, instead of just on, this makes life easier.
- Teleporter chains might get randomized on start, to solve this I would need to add file or database.
Currently it uses the offset to the source teleporter, then places you at the same offset to the destination teleporter.
I have not yet added orientation corrections here, so be careful.

I'm pretty sure gates are unsafe for use with large ships, so be warned.
The current range for gates is 100 meters.

Let me know what you think or would like to have improved.

TODO:
- Add a settings file to customize the settings (range, tags, cool down, etc)
- Add teleporter chain storage (so that they are consistent after a world reload).
- Add a teleport destination only block tagged: IN <name>
- Add a teleport source only beacon tagged: OUT <name>
- Optimize by using a dictionary instead of a single list (only an issue if you start using more then a thousand teleporters)
- Make teleporters safer and more fun (see known issues)
- Test / fix in (dedicated) multiplayer

Known issues:

Using the relative offset to the source beacon, allows for some creative implementation of the teleport beacon (you could for instance only want to use the top or bottom parts in your design. This is however a bit more complicated as the API is missing some convenience function to handle reorienting the player.

If you somehow end up in a block, Space engineers will move you out, at high velocity. Please test this out in creative.

If you use some of the contained code, please let me know I would like to know what you used it for ;-)

Thanks to Lorc for sharing his Teleporter Icon with the world http://game-icons.net/lorc/originals/teleport.html