CasperSafe Security Orb: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
 
(272 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Critical|This is only a draft - the product is in ALPHA TESTING only right now'''}}
{|align=right
{|align=right
   |__TOC__
   |__TOC__
   |}
   |}
== <span style="color:#00528c">'''Features'''</span> ==
{{Warning|Orb not ejecting? Please see the [[#Checklist_for_Automatically_Ejecting_Avatars|Checklist for Automatically Ejecting Avatars]], particularly the "Disallow by default" option. This is the most common support query for CasperSafe.}}


* No notecards to edit!
= <span style="color:#00528c">'''About CasperSafe'''</span> =
* Fewer scripts! Only 4 scripts instead of 11-13 scripts!
* Configuration is a snap!
* ((insert moar features))


== <span style="color:#00528c">'''What's in the Box?'''</span> ==
CasperSafe is a high-tech security and visitor tracking system. Its features include:
 
* Self-contained configuration - no notecards
* Fewer scripts than competing products - 4 instead of 11-13 scripts
* CasperLet Support
* Visitor Tracking option
* Region-wide operation
* Capable of monitoring many parcels at once
 
{{Information|Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.}}
 
= <span style="color:#00528c">'''What's in the Box?'''</span> =
The following named items are in the shipping crate:  
The following named items are in the shipping crate:  
:: CasperSafe Enforcer
:: CasperSafe Enforcer
:: CasperSafe Parcel Link Tool
:: CasperSafe Parcel Link Tool
:: CasperSafe Psychic Link Script (Read the instructions!)
:: CasperSafe Security Orb
:: CasperSafe Security Orb
:: CasperSafe Psychic Link Script (Read the instructions!)


Along with a landmark to the CasperTech store.  
Along with a landmark to the CasperTech store.
 
= <span style="color:#00528c">'''What's with the 'war is peace' stuff?'''</span> =
 
The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.
 
= <span style="color:#00528c">'''Quick Setup Steps'''</span> =
:# Rez the shipping crate and unpack
:# Rez out the CasperSafe Security Orb
:# '''[[CasperSafe_Security_Orb#Add_Areas | Add areas]]''' and/or '''[[CasperSafe_Security_Orb#Link_to_Rental_Unit | link to rental unit]]'''
:# Rez (and deed if necessary) the '''[[CasperSafe_Security_Orb#CasperSafe_Enforcer | Enforcer unit]]'''
:# Add people to appropriate '''[[CasperSafe_Security_Orb#Access_Levels | access lists]]'''
:# Arm the orb
 
See the sections below for explanations of all the options.
 
= <span style="color:#00528c">'''Configuration Tips'''</span> =
 
CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.) 
 
:* Takes about 20-30 seconds to save configuration changes.
:* Configuration is kept when you "Take a copy" '''then''' Rez the copy
:* Configuration is '''NOT''' kept when you shift > drag > copy (this resets the script)
:* Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID.
:* Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list.
 
CasperSafe is '''not''' meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.
 
=== Checking Version Number ===
----
Because the UpgradeBee does '''NOT''' rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field.  See the '''[[Current_Versions | versions page]]''' for current version number and changelog information.
 
= <span style="color:#00528c">'''Security Settings & Levels'''</span> =
 
== '''Access Levels''' ==
 
When Admins click into the access menu, they will get the following options: 
{|
| [[File:CasperSafe - Access - Main.png|350px|thumb|left|Access main menu - click to see larger version.]]
|}
 
When Subadmins click into the access menu, their options will be a little different:
{|
| [[File:CasperSafe_-_Subadmin_-_Access_Version.png|350px|thumb|left|Subadmin version of access menu - click to see larger version.]]
|}
 
== '''Access Level Chart''' ==
 
{| class="wikitable"
|-
! Main Menu Option
! Guests
! SubAdmins
! Admins
|-
| Areas
| No
| No
| Yes
|-
| Arm / Disarm
| No
| Yes
| Yes
|-
| Lockdown
| No
| Yes
| Yes
|-
| Link / Unlink (rental units)
| No
| No
| Yes
|-
| Access Menu
| No
| Yes (subadmins / guests / ban list)
| Yes
|-
| Options
| No
| No
| Yes
|-
| Visitor Control Panel
| No
| Yes, no sales
| Yes, with sales
|}
 
: '''Admins:''' This is the owner, plus any additional designated avatars added to the orb's Admin list.
: '''SubAdmins:''' Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb.
: '''Guest:''' This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does '''not''' come with menu access to the orb.
: '''Temporary:''' Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region.
: '''Banned:''' This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.)
 
=== Security Notes ===
----
Each CasperSafe can only hold '''one''' set of security options.
 
If you need to have different security settings for different areas, then you'll need one orb per set of security settings.
 
Yes, you can rez multiple orbs on the same sim/region.


== <span style="color:#00528c">'''Initial Menu'''</span> ==
:* When used with CasperLet, the owner and any CasperLet managers are automatically admins
((Picture to be inserted later))
:* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list.
:* Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.
:* Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.


:: Arm
== '''Warning Times''' ==
:: Link
Minimum warning time of 10 seconds (default setting of 20 seconds).
:: Areas
:: Access
:: Options
:: Visitor


When the unit is armed, you will also have an extra "lockdown" option.  
Lockdown mode warning time of explicitly 0 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region.  


When the unit is disarmed, it automatically runs in "discreet mode" to save on region resources.  
If the avatar is explicitly on the orb's ban list they are also instantly ejected.


=== Access Levels ===
=== Ejected without warning? ===
----
----
: '''ADMIN''' - This is the system owner, and any defined managers/co-admins.  
CasperSafe '''always''' sends a warning first, before ejecting (when ejecting is properly configured) '''unless''' it is in "lockdown" mode.
: '''SUBADMIN''' - This is the primary tenant + any additional tenants.
 
The times a visitor may not see the warning are:
: 1) If they muted the orb
: 2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance.
 
Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.
 
== '''CasperSafe Enforcer''' ==


Tenants/Subadmins can access everything except the LINK and AREAS options, and can't change the ADMIN access list.  
{{Warning|The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are '''ejected'''. '''BE CAREFUL''' with this option - we accept no responsibility for any damage caused.}}


== <span style="color:#00528c">'''CasperSafe Enforcer'''</span> ==
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead.  
This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead.  


Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to properly function, the Enforcer widget must be owned BY THE LANDOWNER - so if the land is owned by an individual, that individual must rez out the Enforcer. If the land is owned by a group, the Enforcer must be rezzed under the land group tag, and then '''deeded''' to the group. If there are multiple land owners, then you'll need one Enforcer per land owner.  
Like the '''[[CasperLet/Prim_Counter#Prim_Counter_Basics | CasperLet Prim Counter]]''', in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.


== <span style="color:#00528c">'''Default Settings'''</span> ==
The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.


These are the default settings for the options menu, as it ships from CasperTech:
{{Critical|For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its '''owner''', or in the case of the enforcer being deeded to group, orbs belonging to the either '''the owner or the previous owner''' (because the land owner isn't always the orb owner.) }}
((Picture to be inserted later))  


:: Floaty text - '''OFF''' - This controls the radar
'''UPDATES:''' The enforcer only needs to be replaced when a new enforcer version goes out.
:: Disallow by default - '''OFF''' - Eject anyone not in the access list
:: Discreet mode - '''OFF''' - Slows down the timers to be kinder to region resources
:: Eject mode - '''OFF'''
:: Teleport home - '''OFF'''
:: Add to parcel ban list - '''OFF'''
:: Warning time: '''30 seconds''' - How long avatar can stay before being ejected
:: Age limit: '''NONE'''
:: Script limit: '''NONE'''


If an avatar is added to the parcel ban list, they will remain on the parcel ban for 6 hours, after which that avatar will be removed from the parcel ban list.
=== Using Enforcer On Group Land Where You're Only Renting ===
----
:# Rez the enforcer - this sets a "bit" so that it know you're the original owner
:# Rename it so you can find it in your inventory
:# Pick up the enforcer
:# Pass THAT copy of the enforcer to your landlord, so THEY can rez it out
:# Landlord will need to deed the enforcer to the group (if group owned land)


If Eject Mode is ON, then banned avatars will be ejected immediately.  
Do '''NOT''' pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.


=== Automatic Settings ===
=== Enforcer Must Stay Rezzed ===
----
----
: * When used with CasperLet, the owner and any CasperLet managers are automatically admins
The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer '''must stay rezzed.'''
: * When used with CasperLet, the primary tenant + additional tenants on that rental are added automatically to the SUBADMIN access list.
: * Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.


=== Warning time ===
=== One Enforcer Per Parcel ===
----
----
This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar.  
You only need one (1) enforcer '''per parcel''' - see the '''[[CasperLet/Prim_Counter#Sample_Land_Configurations | prim counter]]''' page for rezzing, when when you have to deed.
 
The enforcer will turn all black when it is '''properly''' deeded or rezzed - this is normal and does NOT mean it's broken.


=== Banned avatars===
=== Enforcer and Autoreturn ===
----
----
Any avatar on the ban list (either in CasperSafe or on the land) will be ejected immediately if Eject Mode is on.  
If you want the enforcer to utilize autoreturn, you must:
 
:# Rez the CasperSafe orb '''first'''.
:# Set up the autoreturn options in settings
:# '''Then''' rez and deed the enforcer.


=== Lockdown mode===
=== Enforcer, Group Detection, Autreturn and You ===
----
----
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the warning time to 10 seconds (reduced from the normal minimum of 30 seconds), and increases the scan frequency to account for the 10 second warning. This automatically disables itself when everyone ON the access list has left the region.  
If you are using '''group detection''', it is '''highly recommended''' that you '''do NOT''' use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.


There is no time limit beyond waiting for all the admins/subadmins/allowed guests to leave the region.  
= '''<span style="color:#00528c">Land Configuration - When Security Is Required</span>''' =
All examples are on a '''per-region''' basis, and the Enforcer is '''ONLY''' required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed.  


== <span style="color:#00528c">'''Pairing Mode'''</span> ==
Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel.


=== Pairing CasperSafe to a single Rental Unit ===
The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have.
 
{| class="wikitable"
|-
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners On Sim/Region
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Actions To Take With CasperSafe Enforcer
|-
| Shared land, one parcel <br />Owned by YOU
|
# Rez '''one''' CasperSafe Enforcer, on land YOU own
# No deeding required - just rez and wait
# Repeat on each additional sim/region you have
|-
| Shared land, one parcel <br />Owned by ONE other avatar
|
# Transfer the CasperSafe Enforcer to THAT avatar
# THEY must rez out ONE CasperSafe Enforcer on land owned by THEM
# No deeding required - just rez
# Repeat on each additional sim/region you have
|-
| Shared land, one parcel <br />Owned by ONE land group
|
# Rez out ONE CasperSafe Enforcer on land owned by that group
# Right-Click > Edit > "Share with group" > "Deed"
# Repeat on each additional sim/region you have
|-
| Shared land, multiple parcels <br />Some owned by YOU<br />Some by ONE land group
|
# Rez out one CasperSafe Enforcer on EACH group-owned parcel
# Right-Click > Edit > "Share with group" > "Deed"
# Rez out one CasperSafe Enforcer on EACH parcel owned by you
# No deeding required on the land YOU own - just rez
# Repeat on each additional sim/region you have
|-
| Shared land, multiple parcels <br />Owned by MULTIPLE land groups
|
# Rez one CasperSafe Enforcer PER land group, PER parcel
# Right-Click > Edit > "Share with group" > "Deed"
# Repeat on each additional sim/region you have
|}
 
== '''<span style="color:#00528c">CasperSafe 1.48 and UP - special feature</span>''' ==
 
Versions 1.48 AND UP have very very limited circumstances in which they can function without an enforcer. These circumstances are detailed below.
 
If your orb is 1.47 OR OLDER - Get the updated version to get the newest features!
 
{| class="wikitable"
|-
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Land Owners / Circumstances
! style="white-space: nowrap; background: #33CCFF; border: 2px solid #383838;" | Enforcer Notes
|-
| Parcel is <br />Owned by YOU<br /><i>'''NOT''' group deeded!</i>
|
&nbsp;&nbsp;No enforcer needed.
|-
| Shared land, one parcel <br />Deeded to land group
|
* Orb owner MUST have "Eject and Freeze Residents on parcels" role. &nbsp;
* Otherwise, an enforcer is needed.
|-
| If you want to use<br />"Add to parcel ban list" or <br />"Return prims when ejected" options.
|
&nbsp;&nbsp;You '''WILL''' need an enforcer - see previous table for how to rez.
|}
 
= <span style="color:#00528c">'''Monitoring Areas'''</span> =
Avatars are tracked by the area they're in. If an avatar is registered as entering two areas '''at the same time''' that have identical names, the system will end the first visit to avoid duplicates.
 
Please ensure each area that is defined has its own unique name to avoid this!
 
== When Do Areas Need to be Defined? ==
 
Areas ALWAYS need to be defined in order for visitor detection and security options to work PROPERLY.
 
Your area options are:
:* Region (entire region, ground to "ceiling")
:* Parcel (entirety of ground to "ceiling")
:* Range (Specific diameter from where the orb is located)
:* Custom (if you want a specific shape, or a certain height from x to y covered instead of the whole parcel)
 
== Orb and Security Settings ==
 
One orb can only hold ONE set of security settings. You WILL need multiple orbs if you need different security settings (such as only tracking visitors at your shop, vs setting a "nobody but my whitelist" for your build platform.)
 
== Automatic Settings ==
: * When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list.
: * When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list.
: * Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.
 
=== Note for Skyboxes ===
----
----


'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit.
If you only want to monitor an area NEAR a skybox, set the orb to monitor a '''range''' instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".
 
== Custom Areas ==
'''Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory'''


: '''1)''' Rez CasperSafe Security Orb near the rental unit
:* Click for menu
: '''2)''' Drop the "Psychic Link Script" into the corresponding rental unit
:* Select "Areas"  
: '''3)''' Watch messages in local chat. If all goes well, you should see:  
:* Select "Add"
  Okay, let's have a look here..
:* Select "Custom"
  Ooh, CasperLet! Good choice! Searching for the orb..
:* Corner markers will appear
  Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )
:* Drag the lower marker to the lowest corner of the area you want to monitor
  Pairing process ended.
:* Drag the upper marker to the uppermost corner of the area you want to monitor
: '''4)''' The orb will also add the CasperSafe system owner as an ADMIN automatically.
:* Click one of the markers
:* Select Save
:* Name the area
:* Done!


Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.
If you accidentally manually delete one marker, the corresponding one will self-delete as well.


=== Pairing CasperSafe to a Parcel ===
==== Custom Area Issues ====
----
----
:# "Object Entry" '''must be allowed''' for ALL parcels you are dragging custom markers across.
:# Parcels with autoreturn '''must''' give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.)
Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.
== Custom Range Radius ==
'''Custom Ranges: Number limited only by amount of available memory in the orb.'''
To set a custom area:
:* Click the orb
:* Select "Areas"
:* Select "Add"
:* Select "Range"
:* Enter in the detection range, in meters, and click "Send"
:* Enter name of the area, and click "Send"
:* Done!
Range = Radius. &nbsp;&nbsp;'''''[https://en.wikipedia.org/wiki/Radius What is a radius?]'''''
== Parcel Link ==
'''Number of Parcels: Limited only by amount of available memory in the orb.'''


The Parcel Link Tool allows CasperSafe to be paired with multiple parcels.  
The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be '''used''' on the parcel that will be linked to the CasperSafe orb, and '''ONLY''' by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.)  This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels.  


: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor
: '''1)''' Rez the CasperSafe Security Orb on the land you want it to monitor
Line 125: Line 361:
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.


== <span style="color:#00528c">'''Not Supported'''</span> ==
== Rental Unit Pairing ==
=== '''Ownership''' ===
----
Rental unit AND the CasperSafe orb '''must''' be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.)
 
=== '''Pairing Process''' ===
----
 
'''Pairing limit: 1 rental unit per orb'''
 
'''NOTE:''' CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit.
 
: '''1)''' Rez CasperSafe Security Orb near the rental unit
: '''2)''' Click CasperSafe for the main menu
{|
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]
|}
: '''3)''' Select "LINK". You'll get a popup with instructions:
{|
| [[File:CasperSafe - Link Menu.png|350px|thumb|left|Default main menu - click to see larger version.]]
|}
: '''4)''' Drop the "Psychic Link Script" into the corresponding rental unit
: '''5)''' Watch messages in local chat. If all goes well, you should see:
  Okay, let's have a look here..
  Ooh, CasperLet! Good choice! Searching for the orb..
  Cool! I'm paired with ''((name of rental unit))'' (Key: ''((uuid string))'' )
  Pairing process ended.
: '''6)''' The orb will also add the CasperSafe system owner as an ADMIN automatically.
 
Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.
 
=== CasperLet Manager Auto-Update Timing ===
----
 
CasperSafe will automatically pick up changes to CasperLet managers, '''HOWEVER''' it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.
 
= <span style="color:#00528c">'''Main Menus'''</span> =
 
=== Main Menu for Admins ===
----
 
By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources.
{|
| [[File:CasperSafe_-_Main_Menu_-_Unarmed.png|350px|thumb|left|Default main menu - click to see larger version.]]
|}
 
When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here:
{|
| [[File:CasperSafe - Main Menu - Armed Mode.png |350px|thumb|left|Armed mode - click to see larger version.]]
|}
When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the operation mode to instant eject (reduced from the normal minimum of 10 seconds), and increases the scan frequency in order to detect possible threats more quickly.
 
Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban.
 
=== Main Menu for SubAdmins ===
----
Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items:
:* Access list (to add fellow subadmins, guests and temporary guests)
:* Arm/Disarm/Lockdown
:* Visitor stats (if enabled)
 
Tenants will be automatically added to the subadmin role, provided that CasperSafe is paired properly with the rental unit the tenant has paid.
 
=== About Lockdown mode===
----
If the orb is currently '''in''' "lockdown" mode, the lockdown option will change to "stand down".
 
This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that.
 
Lockdown mode changes the operation to instant eject (from the normal minimum of 10 seconds), and uses slightly more script time than normal operation (see '''[[CasperSafe_Security_Orb#Script_Times | Script Times]]''' for details) in order to detect possible intrusions faster.
 
= <span style="color:#00528c">'''Security Menus'''</span> =
 
=== '''Configuration Options Menus''' ===
----
These are the default settings for the options menu, as it ships from CasperTech:
{|
| [[File:CS_Config_Options_Page_1.png|350px|thumb|left|Default Options page 1 - click to see larger version.]] | [[File:CS_Config_Options_Page_2.png|350px|thumb|left|Default Options page 2- click to see larger version.]]
|}
 
== '''Configuration Options Explanations''' ==
 
{| class="wikitable"
|-
! Options Items
! What it does
|-
| Floating Text
| This turns the radar on and off. Having the radar on will use more script time and processing.
|-
| Disallow by default
| When on, this will eject anyone who's not on the access list.
|-
| Discreet mode
| When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources.
|-
|  Eject from parcel
|  When on, this will eject unwanted visitors after the warning period has ended.
|-
| Teleport Home
| When on, this will teleport unwanted visitors to their home point.
|-
| Add to parcel ban list
| When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb).
|-
| Warning Time
| This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 10 seconds for normal operation. When in lockdown mode, there is no warning time.
|-
| Age Limit
| When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area.
|-
| Script Limit
| When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area.
|-
| Visitor Tracking
| When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an '''[[CasperSafe_Security_Orb#Monitoring_Areas | area defined]]''' before tracking will actually take place. (The orb needs to know where to keep watch.)
|-
| Group members are guests
| When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus.
|-
| Group members are subadmins
| When on, allows members of the group the orb is rezzed under both into the protected area '''and''' gives them subadmin access to the orb itself.
|-
| Limit detection to current parcel
| When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels.
|-
| Return prims when ejected
| When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects.
|-
| Don't send notifications to admins
| When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)
|-
| Don't send notifications to subadmins
| When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)
|-
| Send notifications to guests
| When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications.
|-
| No-Fly Zone
| When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home.  There is no height limit on flight detection.
|-
| Render Weight Limit
| When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. 
|}
 
=== Memory Limits ===
----
Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used.
 
You CAN rez multiple orbs if you are getting low in memory on the first one.
 
= <span style="color:#00528c">'''Render Weight'''</span> =
 
The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:
 
* It is '''not the same thing''' as avatar complexity, but represents the same thing.
* It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.
* A render weight of 500,000 is '''roughly''' equivalent to an avatar complexity of 1 million.
* Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.
 
Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we '''do not recommend''' that you enforce a render weight limit. However, the option is there if you require it.
 
We've '''[https://jira.secondlife.com/browse/BUG-100791 opened a Jira ticket]''' to request script access to avatar complexity. Vote if you want this feature!
 
= <span style="color:#00528c">'''Checklist for Automatically Ejecting Avatars '''</span> =
# Is the Enforcer rezzed out by the land owner?
# Is the enforcer ON the parcel?
# If it is group land, is the Enforcer deeded to the group?
# Is it multiple parcels - and is there one Enforcer PER PARCEL?
# Did you configure an area? (The orb needs to know where to kick avatars FROM...)
# Under Options > Disallow, did you turn "disallow by default" to '''ON'''?
# Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed)
# Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and '''don't''' move, they won't be ejected yet.
# Are you using '''only''' the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".)
 
=== Group Tag Issues ===
----
If you have the CasperSafe set to only allow group members, your group members '''MUST ALREADY''' be wearing the group tag when they teleport in. CasperSafe will not recognize if they change their group tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.
 
= <span style="color:#00528c">'''Visitor Tracking '''</span> =
 
:* Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.)
:* Visitor data WILL be sent to CasperTech servers when turned on.
:* When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.
:* You must also '''[[CasperSafe_Security_Orb#Monitoring_Areas | define an area]]''' for the tracking to monitor before visitor tracking will actually take place
:* Visitor tracking does '''not''' require land ownership. You can rent in a mall and still track your mall store visitors.
 
=== Missing or Ghosted Visitors ===
----
Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know.  It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left.
 
This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform | CasperTech support]]''' since there may be something wrong that we need to look at.
 
You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.
 
= <span style="color:#00528c">'''CasperVend and CasperSafe'''</span> =
There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit.
 
= <span style="color:#00528c">'''Customising Your Orb'''</span> =
The default CasperSafe Orb object has 1 prim and 2 faces:
:* The main decorative texture with triangular shapes is face #0
:* The "war is peace" strip is face #1
:* The orb does '''NOT''' check for prim creator - you can use any object to put the scripts in
 
=== Textures & Custom Objects ===
----
If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled '''DISABLE_TEXTURE_CHANGE''' - simply drop that in the orb's contents, and it will disable further color changes to that strip.
 
Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0.
 
'''NOTE:''' Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object.
 
=== Notifications ===
----
If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled '''Optional Plugin: Send IMs to staff''' into the orb object, and it will do the rest.
 
The optional plugin script is '''open source''' - therefore any changes you make to the script are '''your responsibility''', and are unsupported by CasperTech.
 
==== Popup Menu Notifications ====
----
You cannot turn these off at this time, but that functionality is expected to be added in the next release.
 
= <span style="color:#00528c">'''API Information'''</span> =
 
Per Casper:
  '''We haven't yet published the API for CasperSafe.'''
 
There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.
 
= <span style="color:#00528c">'''Limitations'''</span> =
:* No website configuration<br /> <i>All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.</i>
:* Shift-drag-copy loses configuration<br /><i>The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, '''take a copy''' of an orb with the desired configuration and rez as many additional copies of that as you please. </i>
:* Cannot filter visitor tracking by access level <br /><i>Access level of the avatar is not sent with the visit statistics. </i>
:* One orb per set of security settings<br /><i>While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region. </i>
:* Land bans limited to the parcel the CasperSafe Enforcer is on<br /><i>llAddToLandBanList only works for the parcel the enforcer is currently on.</i>
:* One CasperSafe Enforcer per parcel<br /><i>If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were '''[[CasperLet/Prim_Counter#How_to_Properly_Deed_a_Prim_Counter | deeding a prim counter.]]'''</i>
:* Deleting areas doesn't remove current visitors<br><i>If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.</i>
:* No avatar height restrictions<br /><i>CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many '''legitimate''' avatars.</i>
:* Cannot manually eject via the orb<br /><i>CasperSafe is only set up to eject in response to an allow prompt.</i>
 
= <span style="color:#00528c">'''Script Times'''</span> =
 
These timings were measured over a 24 hour period, on a relatively quiet full region. Your mileage may vary, and times may be higher on busy sims.


CasperSafe does not support any sort of avatar height restriction. The reason is because there are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions would therefore eliminate too many '''legitimate''' avatars.
: UNARMED - 0.003ms
: DISCREET - 0.003ms
: ARMED - 0.004ms
: LOCKDOWN - 0.005ms
: ARMED + RADAR - 0.006ms
: LOCKDOWN + RADAR - 0.007ms


== <span style="color:#00528c">''Still Need to Know....''</span> ==
= <span style="color:#00528c">'''Error Messages'''</span> =
: '''"Script asking non-owner for run time permissions only owner can grant" '''
:: This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.


1) How to use with other supported rental systems?
:'''ChangeQueue is full! Too many events to send to the server!'''
:: Casper needs to debug that. Please '''[[CasperVend_2/Getting_Help#2.29_When_Casper_is_offline:_By_IM-to-Webform_.28Preferred.29 | file a ticket]]''' and leave the orb out where Casper can access it.


2) How menus appear between owner and additional managers
= <span style="color:#00528c">'''Troubleshooting / FAQ'''</span> =
:'''Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.'''
::'''A.''' CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.

Latest revision as of 01:05, 28 October 2024

Orb not ejecting? Please see the Checklist for Automatically Ejecting Avatars, particularly the "Disallow by default" option. This is the most common support query for CasperSafe.

About CasperSafe

CasperSafe is a high-tech security and visitor tracking system. Its features include:

  • Self-contained configuration - no notecards
  • Fewer scripts than competing products - 4 instead of 11-13 scripts
  • CasperLet Support
  • Visitor Tracking option
  • Region-wide operation
  • Capable of monitoring many parcels at once
Depending on your viewer configuration (fonts, UI size, etc.) the length of the option names may not be identical to what's shown here. Popup menus shown here are from Viewer 3.

What's in the Box?

The following named items are in the shipping crate:

CasperSafe Enforcer
CasperSafe Parcel Link Tool
CasperSafe Psychic Link Script (Read the instructions!)
CasperSafe Security Orb

Along with a landmark to the CasperTech store.

What's with the 'war is peace' stuff?

The orb has been themed in several ways with tongue-in-cheek references to George Orwell's 1984, a novel about totalitarian control, monitoring and mind control. It's not a political statement, just a cultural reference.

Quick Setup Steps

  1. Rez the shipping crate and unpack
  2. Rez out the CasperSafe Security Orb
  3. Add areas and/or link to rental unit
  4. Rez (and deed if necessary) the Enforcer unit
  5. Add people to appropriate access lists
  6. Arm the orb

See the sections below for explanations of all the options.

Configuration Tips

CasperSafe will save its configuration on the server. Like CasperLet and SimpleSit, this is saves the information against the UUID of the device, barring a complete script reset (which makes it forget everything) or shift-drag-copy (the copy that is left behind has both reset the script AND has a new UUID and thus no old configuration.)

  • Takes about 20-30 seconds to save configuration changes.
  • Configuration is kept when you "Take a copy" then Rez the copy
  • Configuration is NOT kept when you shift > drag > copy (this resets the script)
  • Like CasperLet, the script tracks the UUID of the device. New device = new UUID, thus shift > drag > copy = New device and new UUID.
  • Information will NOT transfer between two unrelated or different version orbs. (This would be a hassle for landlords, where different orbs are expected to have different individual configurations depending on the renter.)
  • When used with CasperLet, the owner and any CasperLet managers are automatically admins
  • When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list.

CasperSafe is not meant to be configured via the website - while this may make it less convenient, this does ensure that it continues to function despite any website outage.

Checking Version Number


Because the UpgradeBee does NOT rename the object, if you wish to verify that your orb(s) have been updated, you will need to edit > contents tab > right-click on one of the scripts > select "Properties" > check the version number in the description field. See the versions page for current version number and changelog information.

Security Settings & Levels

Access Levels

When Admins click into the access menu, they will get the following options:

Access main menu - click to see larger version.

When Subadmins click into the access menu, their options will be a little different:

Subadmin version of access menu - click to see larger version.

Access Level Chart

Main Menu Option Guests SubAdmins Admins
Areas No No Yes
Arm / Disarm No Yes Yes
Lockdown No Yes Yes
Link / Unlink (rental units) No No Yes
Access Menu No Yes (subadmins / guests / ban list) Yes
Options No No Yes
Visitor Control Panel No Yes, no sales Yes, with sales
Admins: This is the owner, plus any additional designated avatars added to the orb's Admin list.
SubAdmins: Usually subadmins are the tenants of a landlord. As a result, they will not have access to the options list or other higher administrative functions of the orb.
Guest: This option allows you to add a mostly permanent "whitelist" of allowed guests. Guest level does not come with menu access to the orb.
Temporary: Like the "Guest" level, except that people added to the temporary list are automatically removed after they leave the sim/region.
Banned: This option allows you to add to a list of "never allowed" avatars. Anyone on the ban list will automatically be ejected/teleported home (provided they HAVE a home point set...) upon arrival, if ejection is on and an enforcer is out (and properly deeded if necessary.)

Security Notes


Each CasperSafe can only hold one set of security options.

If you need to have different security settings for different areas, then you'll need one orb per set of security settings.

Yes, you can rez multiple orbs on the same sim/region.

  • When used with CasperLet, the owner and any CasperLet managers are automatically admins
  • When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list.
  • Two CasperTech support avatars are added to the whitelist to make it easier to provide any needed support: Casper Warden and CasperHelp Resident.
  • Lockdown mode automatically ends when the entire sim is empty of all allowed avatars.

Warning Times

Minimum warning time of 10 seconds (default setting of 20 seconds).

Lockdown mode warning time of explicitly 0 seconds (instantly ejected), regardless of normal warning time setting. Lockdown mode ends automatically when all allowed avatars leave the sim/region.

If the avatar is explicitly on the orb's ban list they are also instantly ejected.

Ejected without warning?


CasperSafe always sends a warning first, before ejecting (when ejecting is properly configured) unless it is in "lockdown" mode.

The times a visitor may not see the warning are:

1) If they muted the orb
2) If what they think was CasperSafe is actually a neighbour's non-CasperTech orb set to the wrong distance.

Visitors normally receive a notice, either by popup or by local chat, indicating what they were ejected by.

CasperSafe Enforcer

The CasperSafe Enforcer may ask for permission to return objects. Objects will ONLY be returned IF permissions are granted AND the option to return prims is enabled on the CasperSafe Orb. If activated, the orb will return prims belonging to an avatar when they are ejected. BE CAREFUL with this option - we accept no responsibility for any damage caused.

This is the widget that actually does the ejecting / teleport home functions. Thus it is required if you actually want to be able to boot avatars out of the protected area - Otherwise CasperSafe operates in "Warning Mode" which basically nags the avatars instead.

Like the CasperLet Prim Counter, in order to function properly, the Enforcer widget must be owned by the LAND OWNER. If the land is owned by an individual, that individual must REZ the Enforcer widget. If the land is owned by a group, the Enforcer must be REZZED by an individual with the same group tag as the parcel, and they must then DEED the Enforcer to the group. If there are multiple land owners, then you will need one Enforcer per land owner.

The permissions of the Enforcer widget are copy & transfer so that it can be deeded to the appropriate land owners.

For security reasons, the enforcer will only respond to CasperSafe orbs belonging to its owner, or in the case of the enforcer being deeded to group, orbs belonging to the either the owner or the previous owner (because the land owner isn't always the orb owner.)

UPDATES: The enforcer only needs to be replaced when a new enforcer version goes out.

Using Enforcer On Group Land Where You're Only Renting


  1. Rez the enforcer - this sets a "bit" so that it know you're the original owner
  2. Rename it so you can find it in your inventory
  3. Pick up the enforcer
  4. Pass THAT copy of the enforcer to your landlord, so THEY can rez it out
  5. Landlord will need to deed the enforcer to the group (if group owned land)

Do NOT pass over a fresh one that you haven't rezzed first, because it will NOT recognize instructions from your CasperSafe orb.

Enforcer Must Stay Rezzed


The enforcer will not be able to eject avatars if it is only in your inventory, so yes, the enforcer must stay rezzed.

One Enforcer Per Parcel


You only need one (1) enforcer per parcel - see the prim counter page for rezzing, when when you have to deed.

The enforcer will turn all black when it is properly deeded or rezzed - this is normal and does NOT mean it's broken.

Enforcer and Autoreturn


If you want the enforcer to utilize autoreturn, you must:

  1. Rez the CasperSafe orb first.
  2. Set up the autoreturn options in settings
  3. Then rez and deed the enforcer.

Enforcer, Group Detection, Autreturn and You


If you are using group detection, it is highly recommended that you do NOT use the object return feature, because people will always forget their group tag, and having object return on may result in an individual having their objects returned.

Land Configuration - When Security Is Required

All examples are on a per-region basis, and the Enforcer is ONLY required when you need security on an area in a parcel. If you are simply using it for visitor tracking, no enforcer is needed.

Even if you have multiple CasperSafes on a parcel for different security settings, you only need ONE Enforcer per parcel.

The CasperSafe Enforcer cannot operate across sim boundaries; you will need to repeat the appropriate steps for each sim/region that you have.

Land Owners On Sim/Region Actions To Take With CasperSafe Enforcer
Shared land, one parcel
Owned by YOU
  1. Rez one CasperSafe Enforcer, on land YOU own
  2. No deeding required - just rez and wait
  3. Repeat on each additional sim/region you have
Shared land, one parcel
Owned by ONE other avatar
  1. Transfer the CasperSafe Enforcer to THAT avatar
  2. THEY must rez out ONE CasperSafe Enforcer on land owned by THEM
  3. No deeding required - just rez
  4. Repeat on each additional sim/region you have
Shared land, one parcel
Owned by ONE land group
  1. Rez out ONE CasperSafe Enforcer on land owned by that group
  2. Right-Click > Edit > "Share with group" > "Deed"
  3. Repeat on each additional sim/region you have
Shared land, multiple parcels
Some owned by YOU
Some by ONE land group
  1. Rez out one CasperSafe Enforcer on EACH group-owned parcel
  2. Right-Click > Edit > "Share with group" > "Deed"
  3. Rez out one CasperSafe Enforcer on EACH parcel owned by you
  4. No deeding required on the land YOU own - just rez
  5. Repeat on each additional sim/region you have
Shared land, multiple parcels
Owned by MULTIPLE land groups
  1. Rez one CasperSafe Enforcer PER land group, PER parcel
  2. Right-Click > Edit > "Share with group" > "Deed"
  3. Repeat on each additional sim/region you have

CasperSafe 1.48 and UP - special feature

Versions 1.48 AND UP have very very limited circumstances in which they can function without an enforcer. These circumstances are detailed below.

If your orb is 1.47 OR OLDER - Get the updated version to get the newest features!

Land Owners / Circumstances Enforcer Notes
Parcel is
Owned by YOU
NOT group deeded!

  No enforcer needed.

Shared land, one parcel
Deeded to land group
  • Orb owner MUST have "Eject and Freeze Residents on parcels" role.  
  • Otherwise, an enforcer is needed.
If you want to use
"Add to parcel ban list" or
"Return prims when ejected" options.

  You WILL need an enforcer - see previous table for how to rez.

Monitoring Areas

Avatars are tracked by the area they're in. If an avatar is registered as entering two areas at the same time that have identical names, the system will end the first visit to avoid duplicates.

Please ensure each area that is defined has its own unique name to avoid this!

When Do Areas Need to be Defined?

Areas ALWAYS need to be defined in order for visitor detection and security options to work PROPERLY.

Your area options are:

  • Region (entire region, ground to "ceiling")
  • Parcel (entirety of ground to "ceiling")
  • Range (Specific diameter from where the orb is located)
  • Custom (if you want a specific shape, or a certain height from x to y covered instead of the whole parcel)

Orb and Security Settings

One orb can only hold ONE set of security settings. You WILL need multiple orbs if you need different security settings (such as only tracking visitors at your shop, vs setting a "nobody but my whitelist" for your build platform.)

Automatic Settings

* When used with CasperLet, the owner and any CasperLet managers are added automatically to the ADMIN access list.
* When used with CasperLet, the primary tenant + additional subtenants on that rental are added automatically to the SUBADMIN access list.
* Lockdown mode automatically ends when the sim/region is empty of all allowed avatars.

Note for Skyboxes


If you only want to monitor an area NEAR a skybox, set the orb to monitor a range instead of the parcel. Parcel will assume you want to keep watch over all of the parcel, from "floor to ceiling".

Custom Areas

Custom Areas: Suitable for odd shaped parcels, or a specific square/rectangular size within a parcel - Limited only by available memory

  • Click for menu
  • Select "Areas"
  • Select "Add"
  • Select "Custom"
  • Corner markers will appear
  • Drag the lower marker to the lowest corner of the area you want to monitor
  • Drag the upper marker to the uppermost corner of the area you want to monitor
  • Click one of the markers
  • Select Save
  • Name the area
  • Done!

If you accidentally manually delete one marker, the corresponding one will self-delete as well.

Custom Area Issues


  1. "Object Entry" must be allowed for ALL parcels you are dragging custom markers across.
  2. Parcels with autoreturn must give you enough time to do what you need to do before it will send them back. (You can always set autoreturn back to 1 when you're done.)

Otherwise you'll see things like particles flying completely out of the parcel, and custom area markers/nodes being automatically returned.

Custom Range Radius

Custom Ranges: Number limited only by amount of available memory in the orb.

To set a custom area:

  • Click the orb
  • Select "Areas"
  • Select "Add"
  • Select "Range"
  • Enter in the detection range, in meters, and click "Send"
  • Enter name of the area, and click "Send"
  • Done!

Range = Radius.   What is a radius?

Parcel Link

Number of Parcels: Limited only by amount of available memory in the orb.

The Parcel Link Tool allows CasperSafe to be paired with one or more parcels. The Parcel Link Tool must be used on the parcel that will be linked to the CasperSafe orb, and ONLY by the owner of the orb. (Admins and subadmins cannot add a parcel using the Parcel Link Tool because the Tool is no-transfer.) This may be rezzed on any parcel and moved over, just be sure to allow a minute or two for it to pick up the change in parcels.

1) Rez the CasperSafe Security Orb on the land you want it to monitor
2) Rez the "Parcel Link Tool" - You will get these messages in local chat:
  Touch me to pair this parcel with your CasperSafe orb. 
  Make sure you have started pairing on the orb by choosing AREA -> ADD -> PARCEL, first.
  I'm now over parcel ((parcel name as seen in "about land" floater)). Touch to register with a CasperSafe Orb.
3) On the CasperSafe orb, click for the popup menu
4) Select "Areas"
5) Select "Add"
5) Select "Parcel"
6) Then click the Parcel Link Tool. You'll see the following messages in local chat:
  OK. Trying to find a CasperSafe orb, please stand by.
  Alright, all done!
  Pairing process ended.
7) The Parcel Link Tool will self-delete when the parcel pairing process is completed.

Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.

Rental Unit Pairing

Ownership


Rental unit AND the CasperSafe orb must be owned by the same avatar. This is for security reasons. (If anyone could do this, then anyone could control your security orb without your knowledge or permission.)

Pairing Process


Pairing limit: 1 rental unit per orb

NOTE: CasperSafe may be paired with only ONE rental unit. If you have multiple rental units out, AND you want to pair CasperSafe to the units, you'll need one CasperSafe per unit.

1) Rez CasperSafe Security Orb near the rental unit
2) Click CasperSafe for the main menu
Default main menu - click to see larger version.
3) Select "LINK". You'll get a popup with instructions:
Default main menu - click to see larger version.
4) Drop the "Psychic Link Script" into the corresponding rental unit
5) Watch messages in local chat. If all goes well, you should see:
  Okay, let's have a look here..
  Ooh, CasperLet! Good choice! Searching for the orb..
  Cool! I'm paired with ((name of rental unit)) (Key: ((uuid string)) )
  Pairing process ended. 
6) The orb will also add the CasperSafe system owner as an ADMIN automatically.

Pairing process usually takes 1-2 minutes, but may be longer if the region is heavily lagged.

CasperLet Manager Auto-Update Timing


CasperSafe will automatically pick up changes to CasperLet managers, HOWEVER it is not instant - It will take time to filter through, and will be the next time the rental unit updates info to/from the server.

Main Menus

Main Menu for Admins


By default, when you first rez out CasperSafe, the orb is in the "unarmed" state. When unarmed, the orb automatically runs in "discreet mode" in order to be kinder to region resources.

Default main menu - click to see larger version.

When you choose to arm the orb, you will also have an extra "lockdown" option, as shown here:

Armed mode - click to see larger version.

When CasperSafe is armed, the base menu will also show the option "Lockdown" - this changes the operation mode to instant eject (reduced from the normal minimum of 10 seconds), and increases the scan frequency in order to detect possible threats more quickly.

Also, when someone arrives who is not on any of the access lists, admins will get a popup asking them if they want to add the new arrival on a temporary or guest basis, or whether to ban.

Main Menu for SubAdmins


Subadmins will typically be tenants of a landlord, and will not have administrator access to the higher functions of the security orb; they will only have access to the following menu items:

  • Access list (to add fellow subadmins, guests and temporary guests)
  • Arm/Disarm/Lockdown
  • Visitor stats (if enabled)

Tenants will be automatically added to the subadmin role, provided that CasperSafe is paired properly with the rental unit the tenant has paid.

About Lockdown mode


If the orb is currently in "lockdown" mode, the lockdown option will change to "stand down".

This automatically disables itself when everyone ON the access list has left the sim/region - there is no time limit beyond that.

Lockdown mode changes the operation to instant eject (from the normal minimum of 10 seconds), and uses slightly more script time than normal operation (see Script Times for details) in order to detect possible intrusions faster.

Security Menus

Configuration Options Menus


These are the default settings for the options menu, as it ships from CasperTech:

Default Options page 1 - click to see larger version.
|
Default Options page 2- click to see larger version.

Configuration Options Explanations

Options Items What it does
Floating Text This turns the radar on and off. Having the radar on will use more script time and processing.
Disallow by default When on, this will eject anyone who's not on the access list.
Discreet mode When on, this slows down the timers to reduce lag. It won't be as responsive, but it will be kinder to region resources.
Eject from parcel When on, this will eject unwanted visitors after the warning period has ended.
Teleport Home When on, this will teleport unwanted visitors to their home point.
Add to parcel ban list When on, this will add ejected avatars to the parcel's land ban list (not the ban list in the orb).
Warning Time This controls how long the avatar can stay before being ejected, if eject mode is on. In "Warning mode" (which is the default, if there is no Enforcer present and/or properly deeded) this is how long before CasperSafe sends another warning to the intruding avatar. The shipped default is 30 seconds, and may be reduced to 10 seconds for normal operation. When in lockdown mode, there is no warning time.
Age Limit When on, you configure the minimum number of days of account age before avatars are allowed in to the protected area.
Script Limit When on, you configure the maximum amount of scripts an avatar may be wearing/using before they are allowed in to the protected area.
Visitor Tracking When on, this tracks visitors and sends visitor data to the CasperTech website. Visitors cannot (currently) be filtered by admin/subadmin/guest levels; access list data is not sent to the website. You must have an area defined before tracking will actually take place. (The orb needs to know where to keep watch.)
Group members are guests When on, allows members of the group the orb is rezzed under into the protected area. "Guest" access does not include any part of orb menus.
Group members are subadmins When on, allows members of the group the orb is rezzed under both into the protected area and gives them subadmin access to the orb itself.
Limit detection to current parcel When on, this limits detection ranges to within the borders of the parcel the orb is rezzed on. This prevents things like the orb's ejecting/banning from affecting users on other (unrelated) parcels.
Return prims when ejected When on, uses the scripted prim autoreturn feature. This is not recommended in combination with group detection, because people often forget their group tag when they try to rez objects.
Don't send notifications to admins When on, this prevents the orb from sending notifications to users on the "Admin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)
Don't send notifications to subadmins When on, this prevents the orb from sending notifications to users on the "SubAdmin" access level. By default, all messages are delivered via llRegionSay to prevent IM's from capping while you are offline. (If IM notifications are prefered, there is an optional script in the orb's shipping crate that will do this.)
Send notifications to guests When on, this will send notifications to users on the "Guest" access level. By default they don't receive notifications.
No-Fly Zone When on, the flying avatar is warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home. There is no height limit on flight detection.
Render Weight Limit When on, you set the maximum avatar complexity that individual avatars should be at. Users above that point will be warned. If "Eject" is on, then the user is ejected from the area. If "Teleport Home" is on, then the user is teleported home.

Memory Limits


Data about names for Admin/Subadmin/Guest lists are stored IN the device. Consequently every name that's added will cause the available memory to decrease, and it will give you a local chat message indicating how much memory is left. Once the available memory gets below a certain point (somewhere around 300 names), the orb will crash - so it's up to you to keep an eye on how much memory is being used.

You CAN rez multiple orbs if you are getting low in memory on the first one.

Render Weight

The CasperSafe orb has the ability to eject avatars if their render weight (ARC) is too high. However, please be aware that:

  • It is not the same thing as avatar complexity, but represents the same thing.
  • It has a maximum value of 500,000. If you set your limit higher than this, it'll have no effect.
  • A render weight of 500,000 is roughly equivalent to an avatar complexity of 1 million.
  • Render weight is calculated by viewers, not the simulator, so it will only work if there are other people nearby.

Please understand that this is not a predictable or reliable figure, it can vary based on many different factors, and can suffer from random "surges" with apparently no cause. For this reason, we do not recommend that you enforce a render weight limit. However, the option is there if you require it.

We've opened a Jira ticket to request script access to avatar complexity. Vote if you want this feature!

Checklist for Automatically Ejecting Avatars

  1. Is the Enforcer rezzed out by the land owner?
  2. Is the enforcer ON the parcel?
  3. If it is group land, is the Enforcer deeded to the group?
  4. Is it multiple parcels - and is there one Enforcer PER PARCEL?
  5. Did you configure an area? (The orb needs to know where to kick avatars FROM...)
  6. Under Options > Disallow, did you turn "disallow by default" to ON?
  7. Is the orb even armed? (You should see "disarm" in the popup menu if it IS armed)
  8. Has the avatar to be ejected been standing still BEFORE you turned on "disallow by default"? Once the avatar moves, they will be seen and ejected. If they stand still and don't move, they won't be ejected yet.
  9. Are you using only the "teleport home" option? (SL limitation: If the avatar does NOT have a home point set, or the home point no longer exists, the avatar cannot be "sent home".)

Group Tag Issues


If you have the CasperSafe set to only allow group members, your group members MUST ALREADY be wearing the group tag when they teleport in. CasperSafe will not recognize if they change their group tags once they arrive - they'll have to tp out then back to get the orb to see the proper group.

Visitor Tracking

  • Visitor tracking turns ON or OFF using the options menu (so only Admins may turn this on or off.)
  • Visitor data WILL be sent to CasperTech servers when turned on.
  • When visitor tracking is enabled, the "VISITORS" button will change to "CNTRL PANEL" - click the control panel button to get a link for the web-based visitor stats.
  • You must also define an area for the tracking to monitor before visitor tracking will actually take place
  • Visitor tracking does not require land ownership. You can rent in a mall and still track your mall store visitors.

Missing or Ghosted Visitors


Every time an avatar enters or leaves an area (and visitor tracking is turned on), the orb must send a message to CasperPanel to let it know. It is expected that - from time to time - one of these message may be lost/dropped, which will either cause a missing visitor, or a visitor remaining visible who has really already left.

This is normal and expected, from time to time, however it shouldn't happen too often. If you are experiencing this problem very often, please contact CasperTech support since there may be something wrong that we need to look at.

You can fix this by resetting your orb. Your "current visitors" list will also be cleared when the region restarts.

CasperVend and CasperSafe

There is NO linking process required to hook up CasperSafe with CasperVend - this is automatic behind the scenes. If you have visitor list enabled, you will see icons that represent repeat visits, and whether they bought something on that visit.

Customising Your Orb

The default CasperSafe Orb object has 1 prim and 2 faces:

  • The main decorative texture with triangular shapes is face #0
  • The "war is peace" strip is face #1
  • The orb does NOT check for prim creator - you can use any object to put the scripts in

Textures & Custom Objects


If you simply don't want the "war is peace" strip to change, there is a notecard in the shipping crate labeled DISABLE_TEXTURE_CHANGE - simply drop that in the orb's contents, and it will disable further color changes to that strip.

Alternately, you can rez a simple prim sphere and copy all the contents of the orb to that - an unmodified legacy prim sphere has only face #0.

NOTE: Currently, the "Disable texture change" does NOT change the texture animation. Please keep that in mind when making a custom object.

Notifications


If you want the notifications for your staff to arrive as an object IM instead of a llRegionSay message (so they can potentially reach your staff when they are not in the sim/region) then simply drop the script labeled Optional Plugin: Send IMs to staff into the orb object, and it will do the rest.

The optional plugin script is open source - therefore any changes you make to the script are your responsibility, and are unsupported by CasperTech.

Popup Menu Notifications


You cannot turn these off at this time, but that functionality is expected to be added in the next release.

API Information

Per Casper:

  We haven't yet published the API for CasperSafe.

There is currently no date for when the API will be released. When it is released, it will be inserted into this space. If you are still seeing THIS message, the API information has not been released yet.

Limitations

  • No website configuration
    All configuration of the orb itself is done inworld. While it stores minor configuration information online as a backup, it is designed to stay functional even if CasperTech web services have issues.
  • Shift-drag-copy loses configuration
    The new copy will lose all configuration due to a new UUID created which has no record on the database. You may, however, take a copy of an orb with the desired configuration and rez as many additional copies of that as you please.
  • Cannot filter visitor tracking by access level
    Access level of the avatar is not sent with the visit statistics.
  • One orb per set of security settings
    While the orb can track multiple areas and parcels without an issue, it is only designed to hold ONE set of security settings. You cannot choose to eject people from one area while not ejecting them from another - you'll need multiple orbs. Yes, you can rez multiple orbs on a parcel and a sim/region.
  • Land bans limited to the parcel the CasperSafe Enforcer is on
    llAddToLandBanList only works for the parcel the enforcer is currently on.
  • One CasperSafe Enforcer per parcel
    If the land is group owned, the Enforcer unit will need to be deeded, using the same process as if you were deeding a prim counter.
  • Deleting areas doesn't remove current visitors
    If you delete an area, any avatars shown as currently visiting the area on the website will not be removed until the next time the orb is reset or the region is restarted.
  • No avatar height restrictions
    CasperSafe does not support any sort of avatar height restriction. Since the introduction of mesh avatars, you can no longer depend on avatar height as being a psuedo-reliable indicator of the avatar's "age". There are many non-child avatars that are also short, and non-human avatars can come in many sizes as well. Height restrictions are therefore irrelevant today, and would eliminate too many legitimate avatars.
  • Cannot manually eject via the orb
    CasperSafe is only set up to eject in response to an allow prompt.

Script Times

These timings were measured over a 24 hour period, on a relatively quiet full region. Your mileage may vary, and times may be higher on busy sims.

UNARMED - 0.003ms
DISCREET - 0.003ms
ARMED - 0.004ms
LOCKDOWN - 0.005ms
ARMED + RADAR - 0.006ms
LOCKDOWN + RADAR - 0.007ms

Error Messages

"Script asking non-owner for run time permissions only owner can grant"
This is only referring to the scripted autoreturn permissions. They can only be granted by an OWNER in the land group. All other functions of the enforcer are unaffected by granting - or not granting - the autoreturn capability.
ChangeQueue is full! Too many events to send to the server!
Casper needs to debug that. Please file a ticket and leave the orb out where Casper can access it.

Troubleshooting / FAQ

Q. I'm seeing (one or more of) my managers get removed from the orb, but when I list the admins, they're still showing on the orb's list.
A. CasperSafe clears the list and re-adds them each time it is reset - this is part of the reset process. It is supposed to silence these messages, but sometimes (due to grid things) the messages are processed out of sequence and the remove message is processed before the silence message.