Alpha-Fox Teleport Systems Manual

Contents

• Section 1 - Setting up your Teleporters
  • 1.1 - Basic Setup
  • 1.2 - Customization
  • 1.3 - Tips on Placement
  • 1.4 - Custom Objects (rings)
• Section 2 - Using your Teleporters
  • 2.1 - Basic Usage
  • 2.2 - Object Transportation
• Section 3 - Online Interface
  • 3.1 - Teleporter Information Page
  • 3.2 - Customizing and Controlling
• Section 4 - Teleporter API
  • 4.1 - Incoming
  • 4.2 - Outgoing
• Section 5 - Official Addons
  • 5.1 - Apez Integration
  • 5.2 - Custom Rings
• Section 6 - Updating your Teleporters
  • 6.1 - Update Policy
  • 6.2 - Types of Updates
  • 6.3 - How to Update
• Section 7 - Troubleshooting
  • 7.1 - Common Issues
  • 7.2 - Contact
• Section 8 - Information
  • 8.1 - Disclosure
  • 8.2 - Copyright

Alpha-Fox Teleport Systems
v1.0

In order to receive the latest updates and other important information, be sure that you join the Alpha-Fox User Group. You can also access the forums at http://www.alpha-fox.com/community/ .

Section 1 - Setting up your Teleporters

1.1 - Basic Setup

To setup a basic teleporter system, you need only follow these steps:

1. Choose your teleporter from your inventory and drag it in-world.
2. Move the teleporter into the position you want it in.

Repeat the above steps for every teleporter you want rezzed in-world.

Script Monkey says, "Do not deed these teleport platforms to a group. It may end badly."

Note: Without changing any settings, your teleporter is set to "Public" therefore they will interface with any other teleporter in the region. It also will have a generic name based on the position. If you want to change this, see Section 1.2 on how to customize your teleporters.

Back to Top

1.2 - Customization

Once you follow the steps above, you are ready to go. However, if you want to attempt some more advanced customization, you can do this easily from in-world. The in-world interface is not the only method of customizing your teleporters. See Section 4 for more information about the online interface.

There are currently two ways to customize your teleporters via the in-world interface:

1. The admin menu obtained by clicking and holding the teleporter for 3 seconds
2. The Teleporter API

This section of the guide is going to detail the menu-method of customizing your teleporter.

When you click the teleporter and hold for 3 seconds, you will obtain a menu. You should see a menu with buttons in the top-right hand corner of your screen. All of the customizations you are going to want to do are in the Settings portion of the menu, so click that button. On the next menu that pops up, you have several choices. We will try to document each choice below.

Main Menu

• Reset - Resets the transport platform.
• UUID - Outputs the UUID of the transport platform.
• Update - Checks the update server for a new version of the transport platform.
• Website - Directs you to the main page for the Alpha-Fox Teleport Systems.
• Upload - Forces an upload / download of all settings for the teleport platform.
• Online / Offline - Changes the status of the teleport platform.
• Delete - Deletes the platform in a way that reduces server stress and removes it from the list immediately.
• Settings - Provides the two submenus "Set" and "Change" below.

Set

• Name - Allows you a quick way to change the name of your teleporter.
• Description - Allows you to change the description of your teleporter. This is an easy way to sort in which order the teleporters appear on the menu. They sort ASCENDING meaning 1 - 9 and A - Z.
• Text Color - This will allow you to change the color of the online / offline hovertext.
• Text Body - The same as the text color, except with the body of the hovertext.
• Group - Allows you to change the grouping that teleporter is within. It will then show up in that group on the menu.
• Ring Number - [RINGS] Allows you to change the number of rings that should be commanded to go up / down. This is particularly useful for the Custom rings.
• Offset - [RINGS] Allows you to change the offset that the rings are rezzed at. This will allow you, for example, to make rings that come down from the ceiling. Set it to a higher number and they rez up higher and drop down to the platform.

Change

• Other - The new teleporters have the ability to teleport to an arbitrary destination within the current simulator. This is off by default due to security.
• Sit Menu - This will toggle whether the menu is brought up by a teleporter when you sit on the teleport beam. This is on by default.
• Privacy - This can be set to 2 settings, Private or Public. Private only shows your rings on the list and will not let anybody else teleport to your platforms. Public will allow your platform to display to other public platforms in the region regardless if you own them.
• Access - Allows you to change the access settings. There are 4 access settings. All will let anybody teleport to that platform. Group will allow you to set a specific group ( from apez.groups) to have access to that platform. List allows you to have a full list of people who you can allow / deny access to your platform. Please note in order to have group support, you must rez the Apez Integration object. See Section 5.1 for more details.
• Debug - This is not really intended for public usage; it is just an easy way for us to debug problems if they arise by displaying all HTTP traffic.
• Style - [RINGS] Allows you to change the ring style to one of the 5 choices.

Back to Top

1.3 - Tips on Placement

There is nothing that you may hate more than teleporting somewhere with no way out. These tips will allow you to set up your teleporter to give the most pleasing experience to a traveler.

• Do not place your teleporter in the air — Putting a random teleporter in the air with nothing to go to ... you probably don't want to do that. Most people don't like it.
• Place your teleport platform above the ground — The rings cannot rez below the ground, so they need space so they show up below the doors. Please leave around 0.5m of space between the ring platform and the ground if using the doors.

Back to Top

1.4 - Custom Objects [RINGS]

Some people wish to customize the rings differently from those provided. This is why the Custom rings are available. All you need to do is the following:

1. Make a ring model.
2. Rez one of the included ring styles from the inventory of the ring platform, and copy the af.movement.lsl script into your inventory.
3. Create 5 rings, and name each description ring1, ring2, ring3, and so on. Copy af.movement.lsl into each ring.
4. Move all rings to the same position, so they can all rez in the same position.
5. Select every ring and make sure to tick the "Temporary" flag on object permissions.
6. Take the rings in inventory, and name them Custom.

Just drop the Custom ring package into the inventory of the rings and set the style to Custom. Your rings should then work as any other style.

Back to Top

Section 2 - Using your Teleporters

2.1 - Basic Usage

Using the teleporters is very easy. Walk up to the teleporter and click yourself, and you will be presented with a menu. For those of you familiar with the crazyLabs teleporters, you may also click the teleporter to get the same menu.

When clicking the menu, you may see a list of groups. This is shown when there are multiple "Groupings" of teleporters within a region. This makes for a lot easier organization if you are using the teleporters for a massive build. You may also see a button called "Other". This button, if enabled, will allow you to teleport yourself to an arbitrary position within the current simulator.

Note: There is no cross-region teleporting, due to the unreliability of sim crossing.

When you have found the number of the teleporter you want to go to, click its respective number on the menu. Please be sure you are sitting on the teleport platform before doing this, as teleportation will commence after you press that button.

Back to Top

2.2 - Object Transportation

Back by popular demand is the ability to transport objects. All you need to do is drop our (included) script ( af.teleport_beacon.lsl**) into your object, and place it within the teleporter and choose a location. The object will teleport to the destination when a teleport is commenced.

Back to Top

Section 3 - Online Interface

3.1 - Teleporter Information Page

The online interface is not yet complete; more to come soon!

Back to Top

3.2 - Customizing and Controlling

The online interface is not yet complete; more to come soon!

Back to Top

Section 4 - Teleporter API

The teleporters are equipped with an "Application Programming Interface" or API which allows you to interface with our teleporters in both basic and advanced levels. There are two levels of the API, Public and Private. Public allows for anybody to submit the command to your teleporter, while Private is limited to only the teleporter's owner.

4.1 - Incoming

The incoming API consists of commands that you can send to the teleporters in order to control it, change things within it, etc. The channel to interface with is -704000.

The commands currently accepted on this channel are below. Bold commands are public commands while italic commands are private commands.

Please note that ALL API commands must start with the UUID of the system you are talking to. For example: