====== How to set up an on-contact teleporter ======

Firstly, you will need to enable two modules to make use of an on-contact teleporting object

  * Go to Configuration and enable the Teleportation and Objects modules.

Next you will need to define a "landmark" for the system

  * Go in world, attach a HUD, and go to where you wish to set the landmark (including look direction)
  * Run the command to create a landmark - you can set this up on a menu or whatever you fancy but at the simplest type in ''/1teleportation.createLandmark <name>''
  * Note if the name contains spaces you'll need to surround it with quotes ("), e.g. ''/1teleportation.createLandmark Home''  is fine, but you'd need quotes for e.g. ''/1teleportation.createLandmark "Somewhere Else"''

You can now already directly use this by calling ''Teleportation.Go'' with the name of your landmark, and could put this on menus, call it in character logon scripts, or even send people different places based on factions, groups or similar.

To complete the objective, we'll also need to set up a phantom "on collision" object to act as the teleporter (it could also be set to on click or other options)

  * In the web page, go to Configuration, Objects 
  * Click "Create new object type"
  * Give it a name, e.g. "Teleport to landing point"
  * Set the behaviour to "Teleport user on collision; becomes phantom."
  * Click Create, and then specify a Target Landmark on the next page (the one created above!)
  * You can optionally enter text for the teleporter to say ("shimmers faintly as it's teleportation threshold is crossed", or whatever)
  * You can optionally enter text to say to the teleported user ("You step through the portal and feel space fly past you, suddenly you find yourself somewhere else.")
  * Press Update  (the page won't go away, just press update and ignore it for now)

Now we need a scripted object in world.  Create your prim that users will collide with.  We will add a script to it

  * We recommend naming your object so you can identify it later in the web page
  * With your HUD on, say ''/1Objects.getDriver''
  * The region server for your region should send you an Object Driver script
  * Open your prim and place the script in the inventory.

Now to connect the object to the objecttype (behaviour) we set up earlier:

  * Go to the web page, Configuration, Objects
  * At the top, under "Connected Objects", find the object you just put the script in, and change the "Object Type" drop down list to the name you created earlier (we used "Teleport to landing point" in the example earlier)