Teleports

=Introduction=

A teleport is the transfer of a user's connection (represented in-world by their avatar) from one location to another. These locations can be


 * Within the same region.
 * Between different regions on the same simulator.
 * Between different simulators on the same network within the same grid (e.g. a grid hosted on a single network).
 * Between different networks within the same grid (e.g. between simulators hosted on OSGrid).
 * Between different networks on different grids (i.e. Hypergrid teleport).

In OpenSimulator 0.7.5 and for many releases previously, a teleport protocol called SIMULATION/0.1 was used. In OpenSimulator 0.7.6 and after, a teleport protocol called SIMULATION/0.2 is used by default. However, OpenSimulator can still use the SIMULATION/0.1 protocol required by older versions and will automatically inter-operate with them.

If you want to know an eye-watering amount of nitty-gritty about how this works, then please see the Teleport Protocol page.

=Configuration=

Normally, no configuration is required. However, from OpenSimulator 0.7.6 onwards, one can force the simulator to always use the older SIMULATION/0.1 protocol to send an avatar to another simulator, receive an avatar from another simulator or both.

Using SIMULATION/0.1 to send an avatar to another region
The protocol version used for outgoing teleports is controlled by the MaxOutgoingTransferVersion attribute in the [EntityTransfer] section of OpenSim.ini. Specifying

[EntityTransfer] MaxOutgoingTransferVersion = "SIMULATION/0.1"

here will make the simulator use this earlier protocol for outgoing teleports even if the destination has SIMULATION/0.2 available (all such simulators should also have SIMULATION/0.1 available). See OpenSimDefaults.ini for more details.

Using SIMULATION/0.1 to receive an avatar from another region
In this case, one needs to use the ConnectorProtocolVersion in the [SimulationService] section of StandaloneCommon.ini or GridCommon.ini as appropriate. For example

[SimulationService] ConnectorProtocolVersion = "SIMULATION/0.1"

=References=


 * Teleport Protocol - an extremely in depth look at the teleport protocol.