Transporter: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
mNo edit summary
 
(49 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Menu}}
{{Menu}}
{|align=right
  |__TOC__
  |}


== <span style="color:#00528c">'''Buy the Transporter''' </span>==
== <span style="color:#00528c">'''About the Transporter''' </span>==
You can find it in these locations:  
The transporter is an easy to use auto-configuring teleporter.
 
Don't have one? You can find it in these locations:  
: On the '''[https://marketplace.secondlife.com/p/CasperTech-Transporter-Teleport-System/1272903 SL Marketplace]'''
: On the '''[https://marketplace.secondlife.com/p/CasperTech-Transporter-Teleport-System/1272903 SL Marketplace]'''
: On '''[https://www.primbay.com/product.php?id=1 PrimBay] '''
: On '''[https://www.primbay.com/product.php?id=1 PrimBay] '''
: In the '''[http://maps.secondlife.com/secondlife/Izanagi/184/85/134 Second LIfe Grid]'''
: In the '''[http://maps.secondlife.com/secondlife/Izanagi/184/85/134 Second LIfe Grid]'''


==Basic Transporter Setup==
== <span style="color:#00528c">'''Basic Transporter Setup'''</span>==
# Rez one Transporter pad where you want to start
# Rez one Transporter pad where you want to start
# Rez additional Transporter pads where you want them
# Rez at least one additional Transporter pads where you want them
# Wait a minute for them to communicate with each other
# Wait a few seconds for them to communicate with each other


CONGRATULATIONS,  you now have a fully working teleport system!  
CONGRATULATIONS,  you now have a fully working teleport system!  


For further customisation options, keep reading!
For customisation options, keep reading!


==How to change the name of the teleport locations==
== <span style="color:#00528c">'''Customisation Options'''</span>==
==== Name Change ====
----
Simply rename the pad inworld, and the network will update automatically. You need to use the "Name" field, not the "description" field, as shown in the image below:<br />
:: [[File:Transporter_-_rename.png]]


==== Name Length ====
----
The maximum number of characters that fit on a popup menu button is somewhere around 11 characters. If you are seeing ''((destinationname 1))'', ''((destinationname 2))'', ''((destinationname 3))'' and so on, it means those first 11 characters are duplicated across multiple destination points.


Simply change the name of the TP pad objects, the system will auto update instantly.
You will need to keep those first 11 characters different between all the Transporter pads out, in order to not confuse the users of your Transporter system.


==== Location Change ====
----
Simply move the pad to the new location, and the network will update automatically.


==How to change the position of the teleport locations==
==== Texture Customisation ====
----
:* '''Mesh:''' Look for the Transporter AO Bake for the mesh Transporter. If it's not in the shipping crate, ask Casper Warden or Sphynx Soleil for a copy.
:* '''Prim:''' The sculpted edging prim is simply tinted - you can retint it to whatever color you like. The logo prim is just a flat cylinder, so you can retexture that as you would any other legacy prim.


==== Hover/Floaty Text ====
----
Hover/Floaty text is on by default. This picks up the wording you have in the "description" field of the Transporter pad. To change this, follow these steps:


Simply move them, the system will auto update instantly.
# Open the ACCESSLIST notecard and set '''floatytext''' to either "YES" or "NO" depending on whether you want hover text or not.
# Save the notecard
# Change the text in the "description" field to match what you want the hover text to say.  


This image will show you what needs to be changed to alter the hover text: <br />
:: [[File:Transporter_-_Description.png]]


==How to prevent other people's teleport pads from linking with yours==
==== Use Your Own Objects ====
----
If you wish to use your own object as a teleporter, simply copy the contents of any Transporter to your inventory and then drop in the object of your choosing. If you make changes to the contents, allow a minute for the script to re-read the notecard configuration.


Currently, the contents of the Transporter are as follows:
    '''ACCESSLIST''' notecard
    '''Flasher''' object
    '''IMREzEffects''' script
    '''TeleportBeacon''' object (This is the ball that is sat on for teleportation)
    '''TP anim''' animation
    '''Transporter''' script


Open the notecard contained inside the transporter pads and change "mode = PUBLIC"  to "mode = PRIVATE"
The TeleportBeacon object contains:
  '''Beam''' script
  '''TP anim''' animation


What is absolutely required for operation?
    * Both scripts
    * The "TeleportBeacon" object, for the ''click > menu > choose destination > sit'' method of operation.
    * The "ACCESSLIST" notecard, for Transporter configuration


==How to link your pads with teleport pads owned by other people==
The scripts will look for the "Flasher" object and the "TP anim" animation, and will throw a script error if they are not there, but the transporter '''will still work.'''


If you wish to use your own animation, the name will need to be '''TP anim''' (thus it will need to be modifiable so you can rename it), but otherwise you can use any animation. (The "TeleportBeacon" object is not modifiable, so you won't be able to change the animation within that object.)


Open the notecard contained inside the transporter pads and change "mode = PRIVATE" to "mode = PUBLIC". This will need to be set on the destination pad also.
Once you have the required items in your own objects, follow the usual setup procedures outlined in the rest of this document. You will always need at least 2 on the same channel, whether it's a custom object or a default Transporter.


== <span style="color:#00528c">'''Privacy Options'''</span>==
==== Whitelist ====
----
# Open the '''ACCESSLIST''' notecard and set default = "DENY"
# Then add the names of the people you wish to allow under the '''''[WHITELIST]''''' section. 
# Save the notecard


==How to ban people from using your pads, but allow everyone else==
==== Blacklist ====
----
# Open the '''ACCESSLIST''' notecard and set default = "ALLOW"
# then add the names of the people you wish to ban under the '''''[BLACKLIST]''''' section
# Save the notecard
==== Group Only ====
----
# Open the '''ACCESSLIST''' notecard and set default = "DENY"
# '''''[WHITELIST]''''' section must contain the word the word "GROUP"
# Transporter pad must be '''set to the group''' (it needs to be able to compare the worn group tag versus the group it was rezzed under/set to.)
# Save the notecard


==== Age Restriction ====
----
# Open the '''ACCESSLIST''' notecard and set default = "DENY"
# Set "minimumage" or "maximumage" options to the number of days. '''0 means disabled / no age restriction.'''
# Save the notecard


Open the notecard contained inside the transporter pads and set "default = ALLOW",  then add the names of the people you wish to ban under [BLACKLIST]
==== Tenant Access Only (When Connected Rental Unit is Rented) ====
----
# Open the "ACCESSLIST" notecard
# Change '''accesscontrolonly''' to '''YES'''
# Change '''casperlet''' to '''YES'''
# Save the notecard
# Repeat steps for every Transporter you have connected to a rental unit


When the unit is '''not''' rented, the Transporter pad will allow anyone to use it.


==How to ban everyone except certain people from using your pads==
==== One-Way Inbound/Outbound ====
----
# Open the '''ACCESSLIST''' notecard and set default = "DENY"
# Set "block" to either OUTBOUND or INBOUND depending on which way you want to block TP's.
# Save the notecard


==== Block Linking To/From Pads Owned by Others ====
----
# Open the '''ACCESSLIST''' notecard and set "mode = PRIVATE"
# This will need to be set individually on all pads you don't want linkable 
# Save the notecard


Open the notecard contained inside the transporter pads and set "default = DENY",  then add the names of the people you wish to allow under [WHITELIST]
==== Cannot Hide Destinations ====
----
Everyone will see all the available destinations on the transporter - they just will not be able to teleport to ones that they are restricted from.


The reason there are no hidden locations is because doing so causes that pad to check with ALL the other pads, and see whether or not that avatar / that group tag is allowed for each destination. This casues an unacceptable delay before the teleport menu is shown.


==How to restrict access to a group==
'''Workaround:''' Have "hidden" destinations on a different teleport network (see "networking" section below) and put the start location pad for the other network in a hidden location that only the appropriate people know about.


# Default must be "Deny"
== <span style="color:#00528c">'''Networking Options'''</span>==
# "Access" in configuration notecard must be changed to '''"group"'''
==== Linking To/From Pads Owned by Others ====
# Transporter pad must be set TO the group (it needs to see the group tag on users, and make sure it matches.)
----
# Open the '''ACCESSLIST''' notecard and set "mode = PUBLIC"
# This will need to be set individually on all pads you want publicly linkable
# Save the notecard


==How to create separate (independant) TP networks==
==== Separate Transporter Networks ====
----
# Open the '''ACCESSLIST''' notecard and set "mode = PUBLIC"
# Change the "channel" number in the notecard.
# Save the notecard


'''NOTE:''' By default all Transporter pads use "Channel = 0". If you change a pads to a specific OTHER channel, it will ONLY be able to communicate with pads on the SAME specific channel. (It will only listen on '''a single channel''', not multiple.)


Just change the "channel" in the notecard.  All TP pads with a channel 0 will be on one network, all TP pads with a channel 1 will be on another, etc.
== <span style="color:#00528c">'''CasperLet Integration'''</span>==


'''NOTE: YOU NEED CASPERLET 1.15 OR HIGHER TO USE THIS FUNCTIONALITY.'''


==How to restrict access based on age==
# Set the "CasperLet" value in the notecard to YES, and save.
# Wait a few seconds until the notecard has finished reading.
# Touch the transporter.
# Touch the rental unit you want to link the transporter to
# Watch the stream of particles which should now be emitting from your transporter. Are they going to the right unit? Click "yes" or "no". If they're not, start again from step #3.
# That's it! The transporter pad will now work in conjunction with your rental meter.


(Note this is avatar age, not RL age!)  
The CasperLet functionality will let ANYONE use the transporter when the unit is "available" - but ONLY the tenant(s) when it's rented.


Simply set "minimumage" or "maximumage" to the number of days. 0 means disabled.
By default, the transporter will ONLY take them to the location of the rental meter, however you can change this by setting "ACCESSCONTROLONLY" to YES. This will make the transporter behave as normal, except it will use the CasperLet unit to determine who can TP and who cannot.


If you like, you can set "acceptpayments" to YES which will allow people to pay the transporter pad to rent the rental unit it's linked to (if it's available). If this mode is enabled, the transporter will also duplicate any floating text which appears on the unit.


==How to use your Transporter for one-way access==
==== Popups vanishing====
 
----
: '''"The popup menu screen goes away too quick when I'm linking transporters - I can't click yes or no!"


Set "block" to either OUTBOUND or INBOUND depending on which way you want to block TP's.
No, the script did '''not''' close the popup menu. That is not currently possible within LSL at this time.  


This is part of the programming behind the delivery issues with viewers like SL's "Viewer 3", where any incoming messages just *vanish* if you're not watching for them. '''[[Viewer_Non-Delivery_Issues | see this video]]''' to understand the problem.


==How to use your Transporter with CasperLet==
Firestorm, Singularity and Cool VL Viewer all keep popups where you can see them without any issue. Other viewers beyond these three are unknown at this time.


=== Limitations ===
----
The Transporter cannot connect to a "remote relay" rental unit - only the primary/main unit. (The "remote relay" unit simply passes commands to the primary unit, and does not actually DO anything by itself.) You may attempt to connect to a remote relay unit, but what's really happening is the connection will be made to the primary/main unit instead.


'''NOTE: YOU NEED CASPERLET 1.15 OR HIGHER TO USE THIS FUNCTIONALITY.'''
=== Setting Transporter to Only Work When Rented ===
----
In the notecard, change the setting
  '''Default access setting which applies to everyone NOT on the whitelist or blacklist'''
from "allow" to "deny"


# Set the "casperlet" value in the notecard to YES, and save.
== <span style="color:#00528c">'''Video Tutorial'''</span>==
# Wait a few seconds until the notecard has finished reading.
# Touch the transporter.
# Touch the rental unit you want to link the transporter to
# Watch the stream of particles which should now be emitting from your transporter. Are they going to the right unit? Click "yes" or "no". If they're not, start again from step #3.
# That's it!  The transporter pad will now work in conjunction with your rental meter.


The CasperLet functionality will let ANYONE use the transporter when the unit is "available" - but ONLY the tenant(s) when it's rented.
{{#ev:youtube|jw7j15zdoLg|600|center|Video tutorial for the Transporter}}


By default, the transporter will ONLY take them to the location of the rental meter, however you can change this by setting "ACCESSCONTROLONLY" to YES.  This will make the transporter behave as normal, except it will use the CasperLet unit to determine who can TP and who cannot.
== <span style="color:#00528c">'''About The Popup Menus'''</span>==


If you like, you can set "acceptpayments" to YES which will allow people to pay the transporter pad to rent the rental unit it's linked to (if it's available). If this mode is enabled, the transporter will also duplicate any floating text which appears on the unit.
The reason the destination popup has ">>> 9" is so that it shows the teleport destinations starting with #9 in it's internal list, used for the avatar that clicks the Transporter.  


==Video Tutorial==
List order is generated at the time of clicking, based on which Transporter units respond first. This '''may not''' be the same all the time. This eliminates the need to keep track of the last selection - information is stored for a variable time limit - and thus any number of people can use it at once without their choices interfering with each other.


{{#ev:youtubehd|jw7j15zdoLg|600|center|Video tutorial for the Transporter}}
If you have other questions on the menu buttons, look at the '''[http://wiki.secondlife.com/wiki/LlDialog relevant Second Life script wiki page.]'''


==FAQ / Troubleshooting==
== <span style="color:#00528c">'''FAQ / Troubleshooting'''</span>==


'''Q. Can I sort Transporter destinations into a certain order?'''
'''Q. Can I sort Transporter destinations into a certain order?'''

Latest revision as of 01:07, 14 February 2023

Template:Menu

About the Transporter

The transporter is an easy to use auto-configuring teleporter.

Don't have one? You can find it in these locations:

On the SL Marketplace
On PrimBay
In the Second LIfe Grid

Basic Transporter Setup

  1. Rez one Transporter pad where you want to start
  2. Rez at least one additional Transporter pads where you want them
  3. Wait a few seconds for them to communicate with each other

CONGRATULATIONS, you now have a fully working teleport system!

For customisation options, keep reading!

Customisation Options

Name Change


Simply rename the pad inworld, and the network will update automatically. You need to use the "Name" field, not the "description" field, as shown in the image below:

Name Length


The maximum number of characters that fit on a popup menu button is somewhere around 11 characters. If you are seeing ((destinationname 1)), ((destinationname 2)), ((destinationname 3)) and so on, it means those first 11 characters are duplicated across multiple destination points.

You will need to keep those first 11 characters different between all the Transporter pads out, in order to not confuse the users of your Transporter system.

Location Change


Simply move the pad to the new location, and the network will update automatically.

Texture Customisation


  • Mesh: Look for the Transporter AO Bake for the mesh Transporter. If it's not in the shipping crate, ask Casper Warden or Sphynx Soleil for a copy.
  • Prim: The sculpted edging prim is simply tinted - you can retint it to whatever color you like. The logo prim is just a flat cylinder, so you can retexture that as you would any other legacy prim.

Hover/Floaty Text


Hover/Floaty text is on by default. This picks up the wording you have in the "description" field of the Transporter pad. To change this, follow these steps:

  1. Open the ACCESSLIST notecard and set floatytext to either "YES" or "NO" depending on whether you want hover text or not.
  2. Save the notecard
  3. Change the text in the "description" field to match what you want the hover text to say.

This image will show you what needs to be changed to alter the hover text:

Use Your Own Objects


If you wish to use your own object as a teleporter, simply copy the contents of any Transporter to your inventory and then drop in the object of your choosing. If you make changes to the contents, allow a minute for the script to re-read the notecard configuration.

Currently, the contents of the Transporter are as follows:

   ACCESSLIST notecard
   Flasher object 
   IMREzEffects script
   TeleportBeacon object (This is the ball that is sat on for teleportation) 
   TP anim animation
   Transporter script

The TeleportBeacon object contains:

  Beam script
  TP anim animation

What is absolutely required for operation?

   * Both scripts
   * The "TeleportBeacon" object, for the click > menu > choose destination > sit method of operation. 
   * The "ACCESSLIST" notecard, for Transporter configuration

The scripts will look for the "Flasher" object and the "TP anim" animation, and will throw a script error if they are not there, but the transporter will still work.

If you wish to use your own animation, the name will need to be TP anim (thus it will need to be modifiable so you can rename it), but otherwise you can use any animation. (The "TeleportBeacon" object is not modifiable, so you won't be able to change the animation within that object.)

Once you have the required items in your own objects, follow the usual setup procedures outlined in the rest of this document. You will always need at least 2 on the same channel, whether it's a custom object or a default Transporter.

Privacy Options

Whitelist


  1. Open the ACCESSLIST notecard and set default = "DENY"
  2. Then add the names of the people you wish to allow under the [WHITELIST] section.
  3. Save the notecard

Blacklist


  1. Open the ACCESSLIST notecard and set default = "ALLOW"
  2. then add the names of the people you wish to ban under the [BLACKLIST] section
  3. Save the notecard

Group Only


  1. Open the ACCESSLIST notecard and set default = "DENY"
  2. [WHITELIST] section must contain the word the word "GROUP"
  3. Transporter pad must be set to the group (it needs to be able to compare the worn group tag versus the group it was rezzed under/set to.)
  4. Save the notecard

Age Restriction


  1. Open the ACCESSLIST notecard and set default = "DENY"
  2. Set "minimumage" or "maximumage" options to the number of days. 0 means disabled / no age restriction.
  3. Save the notecard

Tenant Access Only (When Connected Rental Unit is Rented)


  1. Open the "ACCESSLIST" notecard
  2. Change accesscontrolonly to YES
  3. Change casperlet to YES
  4. Save the notecard
  5. Repeat steps for every Transporter you have connected to a rental unit

When the unit is not rented, the Transporter pad will allow anyone to use it.

One-Way Inbound/Outbound


  1. Open the ACCESSLIST notecard and set default = "DENY"
  2. Set "block" to either OUTBOUND or INBOUND depending on which way you want to block TP's.
  3. Save the notecard

Block Linking To/From Pads Owned by Others


  1. Open the ACCESSLIST notecard and set "mode = PRIVATE"
  2. This will need to be set individually on all pads you don't want linkable
  3. Save the notecard

Cannot Hide Destinations


Everyone will see all the available destinations on the transporter - they just will not be able to teleport to ones that they are restricted from.

The reason there are no hidden locations is because doing so causes that pad to check with ALL the other pads, and see whether or not that avatar / that group tag is allowed for each destination. This casues an unacceptable delay before the teleport menu is shown.

Workaround: Have "hidden" destinations on a different teleport network (see "networking" section below) and put the start location pad for the other network in a hidden location that only the appropriate people know about.

Networking Options

Linking To/From Pads Owned by Others


  1. Open the ACCESSLIST notecard and set "mode = PUBLIC"
  2. This will need to be set individually on all pads you want publicly linkable
  3. Save the notecard

Separate Transporter Networks


  1. Open the ACCESSLIST notecard and set "mode = PUBLIC"
  2. Change the "channel" number in the notecard.
  3. Save the notecard

NOTE: By default all Transporter pads use "Channel = 0". If you change a pads to a specific OTHER channel, it will ONLY be able to communicate with pads on the SAME specific channel. (It will only listen on a single channel, not multiple.)

CasperLet Integration

NOTE: YOU NEED CASPERLET 1.15 OR HIGHER TO USE THIS FUNCTIONALITY.

  1. Set the "CasperLet" value in the notecard to YES, and save.
  2. Wait a few seconds until the notecard has finished reading.
  3. Touch the transporter.
  4. Touch the rental unit you want to link the transporter to
  5. Watch the stream of particles which should now be emitting from your transporter. Are they going to the right unit? Click "yes" or "no". If they're not, start again from step #3.
  6. That's it! The transporter pad will now work in conjunction with your rental meter.

The CasperLet functionality will let ANYONE use the transporter when the unit is "available" - but ONLY the tenant(s) when it's rented.

By default, the transporter will ONLY take them to the location of the rental meter, however you can change this by setting "ACCESSCONTROLONLY" to YES. This will make the transporter behave as normal, except it will use the CasperLet unit to determine who can TP and who cannot.

If you like, you can set "acceptpayments" to YES which will allow people to pay the transporter pad to rent the rental unit it's linked to (if it's available). If this mode is enabled, the transporter will also duplicate any floating text which appears on the unit.

Popups vanishing


"The popup menu screen goes away too quick when I'm linking transporters - I can't click yes or no!"

No, the script did not close the popup menu. That is not currently possible within LSL at this time.

This is part of the programming behind the delivery issues with viewers like SL's "Viewer 3", where any incoming messages just *vanish* if you're not watching for them. see this video to understand the problem.

Firestorm, Singularity and Cool VL Viewer all keep popups where you can see them without any issue. Other viewers beyond these three are unknown at this time.

Limitations


The Transporter cannot connect to a "remote relay" rental unit - only the primary/main unit. (The "remote relay" unit simply passes commands to the primary unit, and does not actually DO anything by itself.) You may attempt to connect to a remote relay unit, but what's really happening is the connection will be made to the primary/main unit instead.

Setting Transporter to Only Work When Rented


In the notecard, change the setting

  Default access setting which applies to everyone NOT on the whitelist or blacklist

from "allow" to "deny"

Video Tutorial

Video tutorial for the Transporter

About The Popup Menus

The reason the destination popup has ">>> 9" is so that it shows the teleport destinations starting with #9 in it's internal list, used for the avatar that clicks the Transporter.

List order is generated at the time of clicking, based on which Transporter units respond first. This may not be the same all the time. This eliminates the need to keep track of the last selection - information is stored for a variable time limit - and thus any number of people can use it at once without their choices interfering with each other.

If you have other questions on the menu buttons, look at the relevant Second Life script wiki page.

FAQ / Troubleshooting

Q. Can I sort Transporter destinations into a certain order?

A. The Transporter does not support destination sorting at this time. The pads only sort by the order in which the units receive messages from each other.

Q. I'm getting the error "llSetPrimitiveParams warning running rule #1 (PRIM_GLOW): PRIM_GLOW disallowed on agent."

A. You have an old version of the Transporter. Get the latest version from a handy redelivery terminal. If you use the terminal at the CasperTech store, it will sort all CasperTech purchases to the top of the list.