Policies & Information Hub: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
mNo edit summary
Line 1: Line 1:
{{Information|Please take the time to thoroughly read the entire page so that you have a better understanding of how the system works.'''}}
{|align=right
{|align=right
   |__TOC__
   |__TOC__
   |}
   |}


= '''<span style="color:#00528c">New User Information</span>''' =
<!---- Keywords: product server ---->


The following text assumes that you are new to the concept of networked rental systems in general (not just CasperLet), and thus explains both the fundamental concepts as well as the steps necessary to set up the system.
[[File:German_flag.gif]] [[CasperVend 2/DropBoxes/DE | Schaue hier in Deutsch!]]


=== About the DropBox ===
= '''<span style="color:#00528c">About the DropBox</span>''' =
 
=== Current Version ===
----
----
The DropBox contains the notecards and landmarks for your rentals. Notecards are given in two situations. One, when a user clicks for "Info" and Two, when a tenant pays for a rental.
The current DropBox version is 2.26.  


One DropBox '''per''' CasperLet system Owner is required. Having duplicates on at least one additional sim/region is '''highly''' recommended to work around sim/region communication issues.
To check yours, click the DropBox, and from the popup menu, select "Version". It will give you the current version information in your local chat history.  


See '''[[CasperVend_2/DropBoxes | DropBoxes]]''' for full details and instructions on how to deploy and use the DropBox.
=== Limits ===
----
We recommend keeping the number of items in a dropbox below 400, with 200 being the approximate number most people are comfortable with while waiting for the contents to load. There have been issues reported with Second Life object inventories when people go substantially over these numbers.  


See the '''[[CasperLet/Detailed_Setup#Notecard_delivery | notecard delivery]]''' section for detailed instructions on how to properly set up notecards.
=== Moving / Returning DropBox ===
----
If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically.  


=== About the Units page ===
If you need to move, simply follow these steps:
:# Right-click DropBox
:# Select "Take a copy"
:# Click DropBox again
:# Select "Delete" from popup menu
:# Confirm delete (This will flush contents from website cache)
:# Go to new location
:# Rez copy of DropBox
:# All set!
 
=== Must Stay Rezzed ===
----
----
The '''[https://let.casperdns.com/units.php Units page]''' is also frequently called the "bulk" or "global settings" page, and also is the page referred to when you see "bulk setup" in the documentation. The "units" page controls the base configuration for all of your rental units.  
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.


If you have '''any''' units that will have a different configuration than the default, they will need to be configured on a per-unit basis.  
'''Remember:''' All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception.  


CasperLet currently does not support rental "profiles" for rental units. (A suggestion ticket '''is''' in the queue for it, however, and it is expected to be added at some point in the future.)
=== Placement ===
----
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:
 
:* The land must let YOU run scripts - either enabled for all, or you are in the land group.
:* You must have continual access, in order to add/remove products.


=== Creating your CasperLet Account ===
=== Public or Private Locations? ===
----
----
See the '''[[CasperVend_2/Password_Reset#Creating_Your_CasperDNS.com_Account | CasperLet account creation section]]'''.  
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.
 
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them.  


=== Other Terminology ===
=== Renaming Your DropBoxes ===
----
----
Please remember "sign" is '''not''' another word for rental unit, and you '''WILL''' confuse the support staff if you refer to a rental unit as a sign.
By default, the "physical" name of your dropbox is something like:


There is an actual sign object in the CasperLet shipping crate that can be used WITH a rental - but it is not a rental unit by itself, and it must be linked TO a rental unit.
  CasperVend DropBox v((version #))


=== Rental Units At A Glance ===
It's not only ok to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.
 
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, YOUR DropBox gets caught in that mute as well, if it hasn't been renamed.
 
=== Seeing your DropBoxes ===
----
----
To see your rentals at-a-glance, use the '''[https://let.casperdns.com/regions.php Regions]''' page. You will be shown pictures of your sims, with boxes showing where on the region your units are located.


If you have deleted units inworld via "edit > delete", they will still appear here until they are cleared off with a '''[[Website_Scans#Scanning_for_Rental_Units | site scan for units]]'''
DropBoxes are now listed on the CasperVend website, on the '''[https://caspervend.casperdns.com/dropboxes.php DropBoxes]''' page.
 
This page shows you:
:# Name of the DropBox
:# Version number
:# Sim location (clickable link to location inworld)
:# Last contacted
:# # of items in the DropBox
:# Option to '''manage''' that specific DropBox and see the '''contents"
 
At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.
 
 
 
 
 
 


=== Rental Unit Versions ===
== '''<span style="color:#00528c">Organising Your Products</span>''' ==
----
How you organize your DropBoxes is ENTIRELY up to you.
Documentation on this page expects that all of your rental units are version 1.31 or later.  


CasperLet Rental units version 1.2x and older are '''no longer supported'''. If you have older versions rezzed out, you '''must update''' them to the current version in order to receive technical support. Simply redeliver the CasperLet cate to receive an up-to-date UpgradeBee. Any prior version Bee will not have the current version of the script.
:*It doesn't matter if you use just one box, or many.
:*It doesn't matter which items are in which box
:*It doesn't matter where your box is in Second Life (caveats: see '''[[#DropBox_placement|Placement]]''').


=== Setup Limitation ===
There is one organisational limitation that you must always remember:
 
:*Be careful to give everything a unique name. For example, '''don't''' name a texture the same as one of your items - If you have two items with the same name (in different DropBoxes), the system assumes it is a '''[[#When_Possible.2C_Have_Duplicate_DropBox.28es.29|delivery backup]]''' and may deliver ''either one''!
 
== '''<span style="color:#00528c">Terminology: "Sync" vs. "Resync"</span>''' ==
This explains how these terms are used in regards to the CasperTech DropBoxes.
 
'''"SYNC"''' is what the DropBox(es) do when you add or remove items. This is '''always''' - technically - just referred to as a "sync".
 
'''"RESYNC"''' on the popup menu is NOT multiple sync actions. "Resync", per '''Casper Warden''', does something very specific - a full database refresh of your items. This is '''resource intensive''' and should '''not''' be used all the time - only use this option on the advice of support staff, or as outlined in this document.
 
=== '''Note From Casper Warden''' ===
----
----
Currently CasperLet does not support rental profiles. If you have '''two''' or more "base configuration sets" (that are dependent on the rental), you will still need to choose '''one''' as the default, and change the rest individually - this will be using the '''[[#Bulk_.2B_Individual_Setup | bulk + individual]]''' section below.
Casper Warden: it's best not to resync or reset your dropboxes until you have '''exhausted all other options'''
 
== '''<span style="color:#00528c">DropBoxes Must Stay Rezzed</span>''' ==


A suggestion ticket '''is''' in the queue to add rental profile functionality.
Your dropbox must be rezzed out - inworld - '''AT ALL TIMES''' or it cannot deliver your products, notecards, etc. to your customers.


= '''<span style="color:#00528c">Quick Start Sections</span>''' =
'''Remember:''' Scripted objects in general will not function if you do not rez them under the proper land group. DropBoxes are no exception.  
:* If all of your rental units will use the same base configuration, follow the instructions in "bulk setup" section.
:* If SOME of your rental units will use the same base config, but you will have SOME units with different settings, use the "Bulk + individual setup" section.  
:* If all of your rental units will use different configurations, use the "individual setup" section below.  


== '''<span style="color:#00528c">Bulk Setup</span>''' ==  
==== DropBox placement ====
=== 1) Unpack your CasperLet shipping crate ===
----
----
: ''If you're curious, you can see a list of '''[[CasperLet/Introduction | what's in the box]]''' with links to explain some of the included tools. ''
It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:
 
:* The land must let YOU run scripts - either enabled for all, or you are in the land group.
:* You must have continual access, in order to add/remove products.


=== 2) Rez one (non-"slave") rental unit PER RENTAL ===
When rezzing Dropboxes, it is recommended to create a LandMark and rename the LandMark to 'Dropbox Location - Sim name' so you can easily find where you have Dropboxes rezzed around the grid
 
==== Public or Private Locations? ====
----
----
: ''f the tenant will be taking OWNERSHIP of the parcel (such as with land sales on an island estate), the rental unit must NOT be rezzed on the parcel to which they take ownership. As a side-effect, this means the prim-counting feature will not function.''
Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.  


: ''If the landlord is retaining ownership of the parcel that the tenant is renting (such as with vending events or shopping malls), the rental unit should be ON the parcel.''
However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them.


: The object names of the primary/master units to use are as follows:
==== Rename your DropBox ====
   ''CasperLet Rental Box ''
----
  ''CasperLet Rental Meter''
 
  ''CasperLet Mesh Rental Meter''
By default, the "physical" name of your dropbox is something like:  
   '''CasperVend DropBox v((version #))'''


: ''Units with "slave" in the name are strictly a command '''relay''' object. They do not store settings '''at all''', and you cannot use them in place of a primary/master unit.  
It's not only alright to rename your DropBox, it is '''strongly recommended''' - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.  


==== ''Manager handling your setup?'' ====
Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, '''YOUR''' DropBox gets caught in that mute as well, if it hasn't been renamed.
----
''Rez out all the units that are needed - or drag-copy as many as you need - '''NOW''' before the configuration process begins!


=== 3) Grant debit permissions ===
== '''<span style="color:#00528c">Loading Your DropBox</span>''' ==
''The DropBox only '''seems''' no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.''
               
:#Rez the DropBox out
:#Right-click on the DropBox
:#Select "Edit", then go to "Contents" tab.
:#Drag your packaged items, textures and any notecards you have ready into the dropbox.
:#Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - '''one''' of '''either''' of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture '''instead''' of the packaged product.
   
==== Cannot Share DropBoxes ====
----
----
: ''See the '''[[Debit_Permissions | debit permissions]]''' page to details of what these are and why they should be granted.''
'''The DropBox only recognizes the owner that unpacked it from the shipping crate.'''  


: <span style="color:#F00;">''NOTE: If you are re-rezzing a copy of a unit you've already granted permissions for, you won't see another debit perms popup. This is normal. ''</span>
You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend...)


=== 4) Recognize rented state changes? ===
==== No Folders! ====
----
----
: ''Follow the instructions on the '''[[CasperLet/Customisation#Showing_Rental_State_Changes_Automatically | CasperLet customisation page]]''' to make sure they STILL change once you're done with configuration. If you make changes without following these instructions, rental units will not change between rented and available states. ''
DropBoxes '''CANNOT''' accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in THEIR OWN box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...


=== 5) Go to CasperLet website and log in ===
==== Your DropBox won't let you add things? ====
----
----
: ''Click one of your rental units, select "config" from the popup menu, use that link to go to the website, and log in.''
The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it:  
 
# Did you "lock" the dropbox (maybe to prevent accidently deleting it)?
# Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)
# Is SL not letting you do other things either? (may need to relog...)
# Try CTL + dragging the item from your inventory to the DropBox.


=== 6) Set your bulk settings ===
==== "How do I connect the DropBox to...." ====
----
----
: ''Go to the '''[https://let.casperdns.com/units.php Units]''' page when logged in, and set your options. Remember to click "SAVE" anytime you have a "save" option on a setting, and then use the "save" button at the BOTTOM of the bulk page as well.


: ''This means change only ONE option at a time, and when you have a "save" button for that option, click "save" once it's set!''
You don't. All the dropboxes work as inworld "cloud storage" - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that responds that HAS the item being sold.
 
If you are trying to only get certain products to show on certain vendors, then what you need is the '''[[CasperVend_2/Profiles_and_groups | profiles and groups]]''' feature instead.
 
== '''<span style="color:#00528c">Updating Your DropBoxes</span>''' ==
: 1) Wake the existing DropBoxes
:: * To do this, click them, and use "resync" on the popup menu
:: * If that fails, right-click, Edit, then use "reset scripts in selection"
: 2) Wait '''two minutes''' after waking them up
: 3) Run the upgrade bee
 
If you get an error message for "Illegal Task" '''or''' "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then repeat the above steps.
 
If you have tried waking them twice and still get those errors, pick them up and re-rez them.


== '''<span style="color:#00528c">Bulk + Individual Setup</span>''' ==
==== Verifying the update worked ====
=== 1) Unpack your CasperLet shipping crate ===
----
----
: ''If you're curious, you can see a list of '''[[CasperLet/Introduction | what's in the box]]''' with links to explain some of the included tools. ''
:* Right-click on the DropBox
:* Go into Edit
:* Click the Contents tab
:* Right-click the script
:* Select properties
:* See the version # in the description field


=== 2) Rez one (non-"slave") rental unit PER RENTAL ===
The DropBox '''prim''' will not be renamed by the UpgradeBee - only the description line of the script itself.
----
: ''f the tenant will be taking OWNERSHIP of the parcel (such as with land sales on an island estate), the rental unit must NOT be rezzed on the parcel to which they take ownership. As a side-effect, this means the prim-counting feature will not function.''


: ''If the landlord is retaining ownership of the parcel that the tenant is renting (such as with vending events or shopping malls), the rental unit should be ON the parcel.''
== '''<span style="color:#00528c">Products Not Showing On Site?</span>''' ==
There are '''four''' common principles behind why product packages may not show up on the website to be added to a new listing. They are:


: The object names of the primary/master units to use are as follows:
: 1) DropBox cannot be contacted
  ''CasperLet Rental Box ''
: 2) Duplicated name of notecard/texture/etc.
  ''CasperLet Rental Meter''
: 3) Product is "(no transfer)" to YOU, the merchant-owner
  ''CasperLet Mesh Rental Meter''
: 4) Product is not in the dropbox


: ''Units with "slave" in the name are strictly a command '''relay''' object. They do not store settings '''at all''', and you cannot use them in place of a primary/master unit.
There is also one big reason why product packages don't show on the '''PRODUCTS''' page itself, '''OR''' in the list of products to add to a profile:
: 5) Products have not had a '''[[CasperVend_2/Product_Options | product listing]]''' created yet


==== ''Manager handling your setup?'' ====
==== Can't be contacted ====
----
----
''Rez out all the units that are needed - or drag-copy as many as you need - '''NOW''' before the configuration process begins!
Common error points when the DropBox(es) can't be contacted are:
# DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...)
# DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box)
# The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below)


=== 3) Grant debit permissions ===
==== Duplicated Names ====
----
----
: ''See the '''[[Debit_Permissions | debit permissions]]''' page to details of what these are and why they should be granted.''
Common error is that the product name exactly matches the name of a texture or notecard.  


: <span style="color:#F00;">''NOTE: If you are re-rezzing a copy of a unit you've already granted permissions for, you won't see another debit perms popup. This is normal. ''</span>
The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead.  


=== 4) Recognize rented state changes? ===
# Rename your product package, corresponding notecard, and corresponding texture so that the names are '''ALL''' different from each other.
 
==== Product is "no transfer" ====
----
----
: ''Follow the instructions on the '''[[CasperLet/Customisation#Showing_Rental_State_Changes_Automatically | CasperLet customisation page]]''' to make sure they STILL change once you're done with configuration. If you make changes without following these instructions, rental units will not change between rented and available states. ''
Products MAY end up being effectively "(no transfer)" to you for different reasons:  
# Putting a holo demo in the DropBox instead of the holovendor
# An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)


=== 5) Go to CasperLet website and log in ===
Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.
 
==== Not in the dropbox ====
----
----
: ''Click one of your rental units, select "config" from the popup menu, use that link to go to the website, and log in.''
# Did you forget to put it in the dropbox?
# Did you perhaps put the product in the vendor instead of the DropBox?
# When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?


=== 6) Set your bulk settings ===
==== Not showing on product page or list of products to add to profile? ====
----
----
: ''Go to the '''[https://let.casperdns.com/units.php Units]''' page when logged in, and set your options. Remember to click "SAVE" anytime you have a "save" option on a setting, and then use the "save" button at the BOTTOM of the bulk page as well.  
You won't see '''anything''' in either of these places page until a listing is created for the product(s) in question.


: ''This means change only ONE option at a time, and when you have a "save" button for that option, click "save" once it's set!''
CasperVend does not show product '''packages''' on the PRODUCTS page, only completed product '''listings'''. You must create your product listings - if all goes well (see the 4 points above this section) then you'll see your missing packages in the popup for selecting a package to deliver.


=== 7) Set your different individual settings ===
Start at #9 '''[[CasperVend_2/Quick_Start | on this page]]''' to create your product listings.
 
== '''<span style="color:#00528c">Product Popup On Website Not Appearing?</span>''' ==
You may have a browser extension that's blocking the popup product picker window.
 
If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in.
 
If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow '''casperdns.com''' and '''ajax.googleapis.com''' to be able to see the product picker popup window.
 
== '''<span style="color:#00528c">Limits</span>''' ==
We recommend keeping the number of items in a dropbox below 400, with 200 being the approximate number most people are comfortable with while waiting for the contents to load. There have been issues reported with Second Life when people go substantially over these numbers.
 
== '''<span style="color:#00528c">"The Product I'm Trying To Deliver Doesn't Exist!"</span>''' ==
This means that you deleted the product listing without cancelling the transaction first.
 
Setting up the product again will not fix this problem. Resetting the dropboxes will not fix this problem.
 
You - the merchant - will need to cancel the transaction - there's a "cancel" link in the 5th white block on the '''merchant version''' of the transaction status page. Messages will continue until the transaction is cancelled.
 
== '''<span style="color:#00528c">Woops! My DropBox was Accidentally Returned/Picked Up</span>''' ==
'''First, rez out a DropBox UpgradeBee and use the "Check All" function.''' <br />You'll likely see a LOT of messages of this-or-that being removed due to "no longer exist on the region", with a total number much greater than you expect. '''This is normal.''' The "Check All" function checks ALL types of vendor units, not just DropBoxes, and also checks to see if units from other people have also been improperly removed/deleted.
 
'''Once the Bee is done, simply re-rez your DropBox'''<br />Vendors will resume normal delivery without needing to touch anything on the website.
 
== '''<span style="color:#00528c">Cleanly Deleting Old DropBoxes</span>''' ==
'''Properly''' deleting an older (or unused) DropBox is '''essential''' for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleteing itself.
 
'''Remember to "take a copy" FIRST!'''
 
# Click the DropBox
# Select "Delete" from the popup menu
# The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option
# The DropBox will clear its contents out of the website, before deleting itself inworld
 
==== Products Showing That No Longer Exist? Forcing a Resync of Website Cache ====
----
----
: ''For '''each''' unit you want different from your base defaults, you will need to:  
This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, '''OR''' a DropBox is returned to your lost and found, without using the proper popup menu delete options.
::# Click that specific unit
 
::# Select "config" from the popup menu
'''To fix this:'''
::# Arrive at the individual unit's configuration page
 
::# Make your changes
# Rez an "UpgradeBee DROPBOXES ONLY" (You may *wear* the Bee and teleport to the sim/region if you no longer have rez rights.)
::# Remember to click "save" for each option with a "save" button
# Use the "Check all" function
::# Remember to click "save" at the bottom when done
# Wait for Bee to finish
# Repeat on each sim/region that has/had DropBox(es) now or in the past
# When done with all the sims, rezz an EMPTY dropbox.
# Wait.
# Check the website in about 2-3 hours.


== '''<span style="color:#00528c">Individual Unit Setup</span>''' ==  
If you cannot rez on that sim/region anymore, you can "wear" the UpgradeBee before teleporting, and activate it when you arrive.
=== 1) Unpack your CasperLet shipping crate ===
 
----
If the sim/region is not online anymore, or the non-existing products are still showing on the website after '''2-3 hours''' then you will need Casper's intervention to clear them out. Send him an IM inworld, If he's offline, you'll get two offline messages, one of them with a web link - use that web link to fill out the web form and give him the name of at least one of the products that shouldn't be there.
: ''If you're curious, you can see a list of '''[[CasperLet/Introduction | what's in the box]]''' with links to explain some of the included tools. ''
 
== '''<span style="color:#00528c">When Possible, Have Duplicate DropBox(es)</span>''' ==
All DropBox(es) you have rezzed on the grid contribute to the "product cloud" of your products. The website will deliver '''one''' copy of your configured product, from '''the first available''' DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates means that the website has the opportunity to use other dropboxes for the delivery of your product.
 
So yes, multiple / duplicate / backup DropBox(es) are totally ok, and encouraged.
 
== '''<span style="color:#00528c">Setting Up Duplicate DropBoxes</span>''' ==
If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps:


=== 2) Rez one (non-"slave") rental unit PER RENTAL ===
# Right-click, then "Take a copy" of your existing DropBox(es)
----
# Go to another sim/region where you have long-term rez rights. (If you're Premium and have a Linden Home, this would also be an ideal location)
: ''f the tenant will be taking OWNERSHIP of the parcel (such as with land sales on an island estate), the rental unit must NOT be rezzed on the parcel to which they take ownership. As a side-effect, this means the prim-counting feature will not function.''
# Rez out the DropBox(es)
# Wait for the DropBox(es) to talk to the website.
# All set! Remember to leave the DropBox(es) rezzed at all times.  


: ''If the landlord is retaining ownership of the parcel that the tenant is renting (such as with vending events or shopping malls), the rental unit should be ON the parcel.''
You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course).  


: The object names of the primary/master units to use are as follows:
If you want to sync products between dropboxes, you will, unfortunately, need to do that manually.
  ''CasperLet Rental Box ''
  ''CasperLet Rental Meter''
  ''CasperLet Mesh Rental Meter''


: ''Units with "slave" in the name are strictly a command '''relay''' object. They do not store settings '''at all''', and you cannot use them in place of a primary/master unit.  
(If you have a lot of DropBox(es), you can pick them up in a cluster, and rez them out in a cluster at the new location, HOWEVER, you can only click--delete the older ones, one at a time. Do NOT use "Edit / Delete" because that will not clear out the contents of the DropBox from the website properly.)


==== ''Manager handling your setup?'' ====
==== NOT On The Same Region ====
----
----
''Rez out all the units that are needed - or drag-copy as many as you need - '''NOW''' before the configuration process begins!
Having boxes containing the same item, on the '''same region''' is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.


=== 3) Grant debit permissions ===
==== On Different Regions ====
----
----
: ''See the '''[[Debit_Permissions | debit permissions]]''' page to details of what these are and why they should be granted.''
Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is '''absolutely recommended'''.
 
Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.


: <span style="color:#F00;">''NOTE: If you are re-rezzing a copy of a unit you've already granted permissions for, you won't see another debit perms popup. This is normal. ''</span>
Having one or more backup sets on other sims/regions reduces the chance that YOUR products won't deliver when customers make a purchase. These backup locations can be linden homes, friend's homes, etc. There are also services on the grid that will allow you to rent a few prims just for DropBox purposes.


=== 4) Recognize rented state changes? ===
==== On Different Server Channels ====
----
----
: ''Follow the instructions on the '''[[CasperLet/Customisation#Showing_Rental_State_Changes_Automatically | CasperLet customisation page]]''' to make sure they STILL change once you're done with configuration. If you make changes without following these instructions, rental units will not change between rented and available states. ''
For the best reliability, you should consider putting your backup DropBox on a region with a different '''server channel'''. There are five server channels in use, with the first four in this list (the names in bold) being the most common:


=== 5) Go to CasperLet website and log in ===
:* '''Second Life Server'''
----
:* '''RC BlueSteel'''
: ''Click one of your rental units, select "config" from the popup menu, use that link to go to the website, and log in.''
:* '''RC Magnum'''
:* '''RC LeTigre'''
:* RC Snack
 
If your main DropBox is on the main channel ("Second Life Server"), it's a good idea to put your backup DropBox on an RC region, and vice-versa. This is because Second Life Server regions are all restarted on Tuesdays, and RC regions are often restarted on Wednesdays. With a DropBox on both, your delivery network will be online 24/7 since the regions are restarted on different days of the week.
 
To find out your server channel, use Help -> About in your viewer. For example, in firestorm:
 
[[File:Serverchannel.jpg]]
 
== '''<span style="color:#00528c">Where Do I Find DropBox(es) on the Website?</span>''' ==
2.x DropBoxes do not currently show on the CasperVend website.
 
However, you can purchase one of your items, and it will be delivered from (one of) your DropBox(es) - you can open up your local chat history and click on the name of your dropbox to teleport to its location.
 
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==
: '''Q. Why'd my vendors suddenly stop delivering notecards / demos / products?'''
:: '''A.''' Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are:
::: * Is the item IN the dropbox?
::: * Is the site pointing to the correct item(s)
::: * Have you recently change name on the product / notecard / demo, without updating the website?
::: * Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.)
::: * How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.)
::: * Also compare YOUR transaction log with the information in the '''[[CasperVend_2/Deliveries | Transactions & Deliveries]]''' page.
 
: '''Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.'''
:: '''A1.''' Reset / resync the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset.  
:: '''A2.''' If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again.


=== 6) Set your different individual settings ===
: '''Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.'''
----
:: '''A.''' Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...
: ''For '''each''' unit you want different from your base defaults, you will need to:
::: '''1)''' they were no copy and were delivered
::# Click that specific unit
::: '''2)''' your sim suffered an inventory failure or rollback
::# Select "config" from the popup menu
:: in both circumstances the system isn't notified about the change :/ "
::# Arrive at the individual unit's configuration page
:: When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.
::# Make your changes
           
::# Remember to click "save" for each option with a "save" button
:'''Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."'''
::# Remember to click "save" at the bottom when done
:: '''A.''' Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.)
:: The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers.
           
:'''Q1. My vendors won't deliver products anymore and I'm getting an error message like: Your transaction ______ is currently suspended and cannot complete because The item ________ is not available for delivery. Transaction will refund shortly if this is not resolved.'. Please rectify the situation."'''
:'''Q2. I'm getting this message: "You have no items currently active in a DropBox...." '''
:: '''A1.''' Are the DropBox(es) still rezzed out? They can't deliver your product if you've picked them back up.
:: '''A2.''' Product with that exact name (yes, capitalization and typos count!) in the DropBox(es)?
:: '''A3.''' Chances are the DropBox has become disconnected due to SL region lag. Just "touch" the DropBox and selec "Resync" from the popup menu. 
:: '''A4.''' If resync doesn't work, rez out a NEW, EMPTY DropBox and wait a few minutes.
:: '''A5.''' If THAT doesn't work, then restart the sim/region, or have the sim/region restarted if you're renting, and rez a copy of the DropBox at another location in the meantime. Yes, you can have multiple DropBoxes out without a problem.
:: '''A6.''' This is why '''backup''' DropBoxes on other sims/regions are a good idea! :-)


= '''<span style="color:#00528c">How do I....?</span>''' =
:'''Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this? '''
:* '''[[CasperLet/Customisation#Renaming_units | Rename rental units]]'''  
:: '''A1.''' You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark.
:* '''[[CasperLet/Prim_Counter | Count prims / allow tenant to count their prims]]'''
:: '''A2.''' It is STRONGLY RECOMMENDED that you use a landmark name like '''"(your shop) - Main location"''' - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks.
:* '''[[CasperLet/Transfer_Rental| Transfer a tenant from one rental to another]]'''
           
:* '''[[CasperLet/Discounts | Set discounts]]'''
:'''Q. I keep getting messages of "That item is no longer available or doesn't belong to you."  when it is, and it does. '''
:* '''[[CasperLet/Customisation#Showing_Rental_State_Changes_Automatically | Get units to show rented state changes]]'''
:: '''A.''' Pick up and re-rez the DropBox, that should get rid of the spurious errors.
:* '''[[CasperLet/Managers | Properly add a manager]]'''
:* '''[[CasperLet/Detailed_Setup#Transporter_Integration | Link the Transporter to rental units]]'''

Revision as of 17:35, 12 May 2016


Schaue hier in Deutsch!

About the DropBox

Current Version


The current DropBox version is 2.26.

To check yours, click the DropBox, and from the popup menu, select "Version". It will give you the current version information in your local chat history.

Limits


We recommend keeping the number of items in a dropbox below 400, with 200 being the approximate number most people are comfortable with while waiting for the contents to load. There have been issues reported with Second Life object inventories when people go substantially over these numbers.

Moving / Returning DropBox


If your DropBox is accidentally returned to your inventory, simply rez it back out from your "Lost & Found" folder. No additional action needs to be taken once the DropBox is rezzed out once more; the site will pick up the contents automatically.

If you need to move, simply follow these steps:

  1. Right-click DropBox
  2. Select "Take a copy"
  3. Click DropBox again
  4. Select "Delete" from popup menu
  5. Confirm delete (This will flush contents from website cache)
  6. Go to new location
  7. Rez copy of DropBox
  8. All set!

Must Stay Rezzed


Your dropbox must be rezzed out - inworld - AT ALL TIMES or it cannot deliver your products, notecards, etc. to your customers.

Remember: All Scripted delivery objects will not function if you do not rez them under the proper land group (when it is group land). DropBoxes are no exception.

Placement


It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:

  • The land must let YOU run scripts - either enabled for all, or you are in the land group.
  • You must have continual access, in order to add/remove products.

Public or Private Locations?


Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.

However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them.

Renaming Your DropBoxes


By default, the "physical" name of your dropbox is something like:

 CasperVend DropBox v((version #))

It's not only ok to rename your DropBox, it is strongly recommended - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.

Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, YOUR DropBox gets caught in that mute as well, if it hasn't been renamed.

Seeing your DropBoxes


DropBoxes are now listed on the CasperVend website, on the DropBoxes page.

This page shows you:

  1. Name of the DropBox
  2. Version number
  3. Sim location (clickable link to location inworld)
  4. Last contacted
  5. # of items in the DropBox
  6. Option to manage that specific DropBox and see the contents"

At the top of that page you can also list "10, 20, 50, 100 or All" of your DropBoxes at once. The default is 10 per page.




Organising Your Products

How you organize your DropBoxes is ENTIRELY up to you.

  • It doesn't matter if you use just one box, or many.
  • It doesn't matter which items are in which box
  • It doesn't matter where your box is in Second Life (caveats: see Placement).

There is one organisational limitation that you must always remember:

  • Be careful to give everything a unique name. For example, don't name a texture the same as one of your items - If you have two items with the same name (in different DropBoxes), the system assumes it is a delivery backup and may deliver either one!

Terminology: "Sync" vs. "Resync"

This explains how these terms are used in regards to the CasperTech DropBoxes.

"SYNC" is what the DropBox(es) do when you add or remove items. This is always - technically - just referred to as a "sync".

"RESYNC" on the popup menu is NOT multiple sync actions. "Resync", per Casper Warden, does something very specific - a full database refresh of your items. This is resource intensive and should not be used all the time - only use this option on the advice of support staff, or as outlined in this document.

Note From Casper Warden


Casper Warden: it's best not to resync or reset your dropboxes until you have exhausted all other options

DropBoxes Must Stay Rezzed

Your dropbox must be rezzed out - inworld - AT ALL TIMES or it cannot deliver your products, notecards, etc. to your customers.

Remember: Scripted objects in general will not function if you do not rez them under the proper land group. DropBoxes are no exception.

DropBox placement


It doesn't matter where you put your DropBox. However, there are certain caveats you should be aware of:

  • The land must let YOU run scripts - either enabled for all, or you are in the land group.
  • You must have continual access, in order to add/remove products.

When rezzing Dropboxes, it is recommended to create a LandMark and rename the LandMark to 'Dropbox Location - Sim name' so you can easily find where you have Dropboxes rezzed around the grid

Public or Private Locations?


Other people cannot edit your dropboxes (unless you've given them "mod rights" on your stuff), so public locations are perfectly safe.

However, please read the rental agreement / land covenant FOR that location so make sure dropboxes in general are allowed - because land managers/owners can still return objects, even if they can't do anything else to them.

Rename your DropBox


By default, the "physical" name of your dropbox is something like:

  CasperVend DropBox v((version #))

It's not only alright to rename your DropBox, it is strongly recommended - at least to include YOUR store name. The name of the DropBox your product comes from is seen in the delivery message that the customer receives - so be aware of that when renaming the box.

Renaming is also recommended because if someone mutes "CasperVend DropBox v((version #))" from someone else, YOUR DropBox gets caught in that mute as well, if it hasn't been renamed.

Loading Your DropBox

The DropBox only seems no-modify in your inventory. This is due to the DropBox script being no-modify. Once you rez it out, the prim WILL be modifiable and allow you to add contents.

  1. Rez the DropBox out
  2. Right-click on the DropBox
  3. Select "Edit", then go to "Contents" tab.
  4. Drag your packaged items, textures and any notecards you have ready into the dropbox.
  5. Make sure that your notecards / landmarks / textures / packaged items are all named differently - if you name a texture the same as your object, for example, the vendor system will deliver - or redeliver - one of either of them. This means that if your customer pays for a packaged product, and your texture has the exact same name as your packaged product, the customer may get the texture instead of the packaged product.

Cannot Share DropBoxes


The DropBox only recognizes the owner that unpacked it from the shipping crate.

You cannot "share with group", it will not load other people's products. You cannot deed to a group, because the DropBox is no transfer. (And even if you could, it wouldn't work - the group would then be the owner, and the group isn't the one that purchased the copy of CasperVend...)

No Folders!


DropBoxes CANNOT accept a folder AS a folder - it will always assume the contents of the folders are separate products. If you have multiple items for one product, they need to go in THEIR OWN box / bag / shipping crate / package before going in the dropbox. Do not put an object named NYAN into the DropBox or strange things may happen...

Your DropBox won't let you add things?


The grid is known for occasionally not letting things work as well as they should. Here are some troubleshooting points if it doesn't seem like the DropBox is letting you put stuff in it:

  1. Did you "lock" the dropbox (maybe to prevent accidently deleting it)?
  2. Has everything in the dropbox fully loaded in the edit / contents window? (SL usually won't let you add things until everything is loaded)
  3. Is SL not letting you do other things either? (may need to relog...)
  4. Try CTL + dragging the item from your inventory to the DropBox.

"How do I connect the DropBox to...."


You don't. All the dropboxes work as inworld "cloud storage" - this is why duplicate sets are such a good idea. There's no need to even try to "pin" a dropbox to a specific vendor, the system will automatically pull a product for delivery from the first dropbox that responds that HAS the item being sold.

If you are trying to only get certain products to show on certain vendors, then what you need is the profiles and groups feature instead.

Updating Your DropBoxes

1) Wake the existing DropBoxes
* To do this, click them, and use "resync" on the popup menu
* If that fails, right-click, Edit, then use "reset scripts in selection"
2) Wait two minutes after waking them up
3) Run the upgrade bee

If you get an error message for "Illegal Task" or "0 attempted / 0 upgraded / 0 no longer exist / 0 weren't upgraded because..." message, then repeat the above steps.

If you have tried waking them twice and still get those errors, pick them up and re-rez them.

Verifying the update worked


  • Right-click on the DropBox
  • Go into Edit
  • Click the Contents tab
  • Right-click the script
  • Select properties
  • See the version # in the description field

The DropBox prim will not be renamed by the UpgradeBee - only the description line of the script itself.

Products Not Showing On Site?

There are four common principles behind why product packages may not show up on the website to be added to a new listing. They are:

1) DropBox cannot be contacted
2) Duplicated name of notecard/texture/etc.
3) Product is "(no transfer)" to YOU, the merchant-owner
4) Product is not in the dropbox

There is also one big reason why product packages don't show on the PRODUCTS page itself, OR in the list of products to add to a profile:

5) Products have not had a product listing created yet

Can't be contacted


Common error points when the DropBox(es) can't be contacted are:

  1. DropBox(es) not rezzed out (Like all scripted inworld delivery systems, they cannot deliver if not rezzed out...)
  2. DropBox(es) has no script (need "CasperTech Dropbox" script to stay in the box)
  3. The sim the DropBox(es) is(are) on is having a snit and not talking to the outside world (the "gone dark" issue mentioned in the backup section below)

Duplicated Names


Common error is that the product name exactly matches the name of a texture or notecard.

The popup for product selection is set to filter out duplicates - so this results in new products not showing because the texture or notecard is showing instead.

  1. Rename your product package, corresponding notecard, and corresponding texture so that the names are ALL different from each other.

Product is "no transfer"


Products MAY end up being effectively "(no transfer)" to you for different reasons:

  1. Putting a holo demo in the DropBox instead of the holovendor
  2. An errant script, texture, or other "(no transfer)" item included with the product by accident. (Might be accidentally linked to a build, or accidentally dropped in the contents of a prim.)

Verify that all your items are transferable TO YOU by looking in the contents of (each) DropBox, waiting for the contents to load, and scrolling the list to the right to see the permissions. Scroll down to see everything in the DropBox and verify whether or not "(no transfer)" is next to any of the items.

Not in the dropbox


  1. Did you forget to put it in the dropbox?
  2. Did you perhaps put the product in the vendor instead of the DropBox?
  3. When you rezzed (or re-rezzed) the DropBox, did you rez an older version that's missing the new item(s)?

Not showing on product page or list of products to add to profile?


You won't see anything in either of these places page until a listing is created for the product(s) in question.

CasperVend does not show product packages on the PRODUCTS page, only completed product listings. You must create your product listings - if all goes well (see the 4 points above this section) then you'll see your missing packages in the popup for selecting a package to deliver.

Start at #9 on this page to create your product listings.

Product Popup On Website Not Appearing?

You may have a browser extension that's blocking the popup product picker window.

If you are using Chrome, you can start another Chrome window in 'Incognito" mode - use CTL + SHFT + N to start an Incognito window. This disables all the extensions before logging you in.

If you are using Firefox (or another browser) with a a "no javascript" type extension that allows a temporary override, you need to allow casperdns.com and ajax.googleapis.com to be able to see the product picker popup window.

Limits

We recommend keeping the number of items in a dropbox below 400, with 200 being the approximate number most people are comfortable with while waiting for the contents to load. There have been issues reported with Second Life when people go substantially over these numbers.

"The Product I'm Trying To Deliver Doesn't Exist!"

This means that you deleted the product listing without cancelling the transaction first.

Setting up the product again will not fix this problem. Resetting the dropboxes will not fix this problem.

You - the merchant - will need to cancel the transaction - there's a "cancel" link in the 5th white block on the merchant version of the transaction status page. Messages will continue until the transaction is cancelled.

Woops! My DropBox was Accidentally Returned/Picked Up

First, rez out a DropBox UpgradeBee and use the "Check All" function.
You'll likely see a LOT of messages of this-or-that being removed due to "no longer exist on the region", with a total number much greater than you expect. This is normal. The "Check All" function checks ALL types of vendor units, not just DropBoxes, and also checks to see if units from other people have also been improperly removed/deleted.

Once the Bee is done, simply re-rez your DropBox
Vendors will resume normal delivery without needing to touch anything on the website.

Cleanly Deleting Old DropBoxes

Properly deleting an older (or unused) DropBox is essential for a cleaner database - following these steps means that the DropBox will flush its contents out of the database before deleteing itself.

Remember to "take a copy" FIRST!

  1. Click the DropBox
  2. Select "Delete" from the popup menu
  3. The DropBox will give you a confirmation screen; if you really want to delete it, click the appropriate option
  4. The DropBox will clear its contents out of the website, before deleting itself inworld

Products Showing That No Longer Exist? Forcing a Resync of Website Cache


This issue is most often caused by simply using "Edit > Delete" on an existing DropBox, OR a DropBox is returned to your lost and found, without using the proper popup menu delete options.

To fix this:

  1. Rez an "UpgradeBee DROPBOXES ONLY" (You may *wear* the Bee and teleport to the sim/region if you no longer have rez rights.)
  2. Use the "Check all" function
  3. Wait for Bee to finish
  4. Repeat on each sim/region that has/had DropBox(es) now or in the past
  5. When done with all the sims, rezz an EMPTY dropbox.
  6. Wait.
  7. Check the website in about 2-3 hours.

If you cannot rez on that sim/region anymore, you can "wear" the UpgradeBee before teleporting, and activate it when you arrive.

If the sim/region is not online anymore, or the non-existing products are still showing on the website after 2-3 hours then you will need Casper's intervention to clear them out. Send him an IM inworld, If he's offline, you'll get two offline messages, one of them with a web link - use that web link to fill out the web form and give him the name of at least one of the products that shouldn't be there.

When Possible, Have Duplicate DropBox(es)

All DropBox(es) you have rezzed on the grid contribute to the "product cloud" of your products. The website will deliver one copy of your configured product, from the first available DropBox that has that product, AND responds in a timely manner. Due to general grid crappiness, sometimes a sim/region doesn't respond as well as it should - and having duplicates means that the website has the opportunity to use other dropboxes for the delivery of your product.

So yes, multiple / duplicate / backup DropBox(es) are totally ok, and encouraged.

Setting Up Duplicate DropBoxes

If you like, and you have multiple locations for your DropBoxes, you can work with ONE set as a "master set" of DropBoxes. Then, when you are done adding things in a particular session, simply do the following steps:

  1. Right-click, then "Take a copy" of your existing DropBox(es)
  2. Go to another sim/region where you have long-term rez rights. (If you're Premium and have a Linden Home, this would also be an ideal location)
  3. Rez out the DropBox(es)
  4. Wait for the DropBox(es) to talk to the website.
  5. All set! Remember to leave the DropBox(es) rezzed at all times.

You may organize your DropBoxes however you'd like, and you can rez however many you'd like (up to the maxmium prim/impact limits of the parcel, of course).

If you want to sync products between dropboxes, you will, unfortunately, need to do that manually.

(If you have a lot of DropBox(es), you can pick them up in a cluster, and rez them out in a cluster at the new location, HOWEVER, you can only click--delete the older ones, one at a time. Do NOT use "Edit / Delete" because that will not clear out the contents of the DropBox from the website properly.)

NOT On The Same Region


Having boxes containing the same item, on the same region is generally pointless. The goal behind having duplicate locations is to have reliability in case of sim/region-to-outside-world communication issues. Having all duplicate sets on the same sim/region means that they will all be affected when the sim/region goes out to lunch or runs out of URL's.

On Different Regions


Having one or more duplicate DropBox(es) (DropBoxes containing the same items) on another region is absolutely recommended.

Partly this is so that you have DropBoxes that work even when the simulator/region is down (especially if you have affiliate vendors out on the grid, or multiple locations) but also because simulators/regions occasionally "go dark" and refuse to talk to the outside world. The sim/region will still be up, inworld, and accessible to avatars even in this state, but because it's not talking to the outside world, DropBoxes on these affected sims/regions will be unable to deliver product to customers.

Having one or more backup sets on other sims/regions reduces the chance that YOUR products won't deliver when customers make a purchase. These backup locations can be linden homes, friend's homes, etc. There are also services on the grid that will allow you to rent a few prims just for DropBox purposes.

On Different Server Channels


For the best reliability, you should consider putting your backup DropBox on a region with a different server channel. There are five server channels in use, with the first four in this list (the names in bold) being the most common:

  • Second Life Server
  • RC BlueSteel
  • RC Magnum
  • RC LeTigre
  • RC Snack

If your main DropBox is on the main channel ("Second Life Server"), it's a good idea to put your backup DropBox on an RC region, and vice-versa. This is because Second Life Server regions are all restarted on Tuesdays, and RC regions are often restarted on Wednesdays. With a DropBox on both, your delivery network will be online 24/7 since the regions are restarted on different days of the week.

To find out your server channel, use Help -> About in your viewer. For example, in firestorm:

Where Do I Find DropBox(es) on the Website?

2.x DropBoxes do not currently show on the CasperVend website.

However, you can purchase one of your items, and it will be delivered from (one of) your DropBox(es) - you can open up your local chat history and click on the name of your dropbox to teleport to its location.

FAQ / Troubleshooting

Q. Why'd my vendors suddenly stop delivering notecards / demos / products?
A. Things cannot be delivered if the system cannot find the dropbox, and/or cannot find the product items it's been told to send. Therefore, the first points to check are:
* Is the item IN the dropbox?
* Is the site pointing to the correct item(s)
* Have you recently change name on the product / notecard / demo, without updating the website?
* Has the sim/region "gone dark"? (If so, the only solution is restart the sim and/or have backup copies on at least one other sim/region.)
* How many items are in your dropbox? (Remember if there are too many things in the dropbox, the SL servers seem to make stuff "go missing" - which would also prevent delivery of items.)
* Also compare YOUR transaction log with the information in the Transactions & Deliveries page.
Q. My customers aren't getting the product after purchase, and the redelivery terminal keeps giving them a "Failed: Couldn't find delivery box for item on SLIFE. This merchant may no longer be using CasperVend." message, when it is, and I am.
A1. Reset / resync the DropBox(es). Use the touch menu first - if that doesn't work, then manually Edit > Reset scripts in selection to get them to actually reset.
A2. If you have DropBox(es) on only one sim/region, then we strongly recommend having a backup set (see above) on at least one other sim/region location to reduce the risk of this happening again.
Q. I have a DropBox which shows as 'live' and as having __ items listed. However, when I open the drop box there are maybe half that amount of items showing inside the box.
A. Casper Warden writes: "basically, if items have disappeared from the box, there's two possible reasons...
1) they were no copy and were delivered
2) your sim suffered an inventory failure or rollback
in both circumstances the system isn't notified about the change :/ "
When items that are no-copy to the merchant (such as breedable things) get sold, the # in the floaty text above the dropbox does NOT get updated.
Q. I got this message: "CasperVend DropBox: Items in the database seem to be out of sync! Re-uploading."
A. Nothing to worry about - the system's self-check has determined that there is lag, either on the sim/region or in the grid itself. Once or twice per DropBox is normal (if you have multiple DropBoxes, you'll get several messages, but should just be one or two from each.)
The only time to worry is when you get the message several times a day - that would indicate a sim/region communication problem, or that Casper is working on the backend servers.
Q1. My vendors won't deliver products anymore and I'm getting an error message like: Your transaction ______ is currently suspended and cannot complete because The item ________ is not available for delivery. Transaction will refund shortly if this is not resolved.'. Please rectify the situation."
Q2. I'm getting this message: "You have no items currently active in a DropBox...."
A1. Are the DropBox(es) still rezzed out? They can't deliver your product if you've picked them back up.
A2. Product with that exact name (yes, capitalization and typos count!) in the DropBox(es)?
A3. Chances are the DropBox has become disconnected due to SL region lag. Just "touch" the DropBox and selec "Resync" from the popup menu.
A4. If resync doesn't work, rez out a NEW, EMPTY DropBox and wait a few minutes.
A5. If THAT doesn't work, then restart the sim/region, or have the sim/region restarted if you're renting, and rez a copy of the DropBox at another location in the meantime. Yes, you can have multiple DropBoxes out without a problem.
A6. This is why backup DropBoxes on other sims/regions are a good idea! :-)
Q. My last shop location is no more, I don't have access to it, and it keeps trying to send the OLD landmark. How can I fix this?
A1. You'll need to edit *everywhere* you have it marked - usually this is in each and every single product listing - and set them up with the new landmark.
A2. It is STRONGLY RECOMMENDED that you use a landmark name like "(your shop) - Main location" - rather than the default LL format that includes the sim/region name. Renaming your landmarks to something simple and WITHOUT the sim/region name means that when you have to move in the future, you can just outright swap the landmarks, without having to go through the hassle of updating every single product every time you change landmarks.
Q. I keep getting messages of "That item is no longer available or doesn't belong to you." when it is, and it does.
A. Pick up and re-rez the DropBox, that should get rid of the spurious errors.