CasperVend 2/DropBoxes

Last updated: 26 June, 2013

About the Dropbox

The dropbox is your product server. You need to have your boxed products, textures, and any informational notecards IN the dropbox, in order for them to be uploaded to the website.

The dropbox needs to STAY REZZED OUT in order for the vendors to be able to deliver your informational notecards or your purchased products - if the vendors can't find the dropbox, they won't be able to deliver the product to your customer!

Organisation

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|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!

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.

Putting items into 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 boxed items, textures and any notecards you have ready into the dropbox.

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.

Limits

DropBoxes are limited to a maximum of 400 items, including the dropbox script it ships with. However, we highly recommend that you keep your boxes below 200 items. Above this number, we have witnessed inventory contents randomly going missing (a Second Life simulator issue, not unique to any vendor system).

There's no limit to the number of DropBoxes you can have rezzed, barring prim/impact limits on the parcel of land you are using for them.

FAQ / Troubleshooting

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 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 notifed 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.

Q1. I deleted some old items / an old dropbox, and the old items (that were in the old dropbox) are STILL showing up on the website in the product selector popup.

Q2. I'm seeing items in the list with "item name 1", "item name 2" etc. - basically they've been duplicated and I can't get rid of the duplicates.

A1. If you have items or textures showing up which are NO LONGER in a dropbox, it means that you've deleted a dropbox at some point without using the "touch" menu and the "delete" option. When deleting a dropbox, please use the touch dialogue menu - this is the quickest way to clean up the contents listings.

A2. If it's a 2.x dropbox, rez out a DROPBOX upgradebee and use the "Check All" function - that will remove "orphan" dropboxes that were previously in that sim. You'll need to repeat this for every sim you had 2.x dropboxes in.

A3. If A1 - A2 don't fix your problem, THEN send an IM to Casper Warden with the EXACT NAME of ONE of the extra or duplicate items, mention that it's from a deleted dropbox, and he'll delete the "orphan" dropbox from the website database.

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 systems'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.

Q. How many items can I put in the DropBox before it's too sluggish to use?

A. Effective December 1, 2012 there is a hard limit of 400 items in a dropbox to prevent most issues of lag and potential inventory loss. If there are more than 400 items in a dropbox, it will NOT talk to the web server.

This 400-item limit applies to *everything* in the dropbox - including the script it originally ships with - so it's effectively a limit of 399 of YOUR things in the dropbox.

A "soft limit" maximum of around 200 items is STRONGLY recommended so that loading the contents is less tedious if you're on a slower computer or if there is region lag.

Q. Can I rename the dropbox?

A. Yes, you can rename the dropbox - Just remember that the name of the dropbox is what the customer will see when the item is delivered.

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. Dropbox(es) rezzed out?

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.

A4. If THAT doesn't work, then restart the sim, or have the sim 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.

A5. This is why "backup dropboxes" on other sims 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 the product listings - and set it 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 name. Renaming your landmarks to something simple and WITHOUT the sim 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 suprious errors.

Q. If you have multiple dropboxes, do you have to add new items to each one manually or can you sync them?

A. Unfortunately, there's currently no method to send inventory to objects in other sims. You'll need to add your items to the dropboxes manually.