CasperVend 2/DropBoxes

From CasperTech Wiki
Jump to navigation Jump to search

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

Backup Dropboxes

Having one or more backup dropbox(es) on another sim is always 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 will be unable to deliver product to customers. Having one or more backup sets on other sims 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/product server purposes.
For ultimate reliability, you should consider putting your backup dropbox on a region with a different server channel. There are five server channels in use:
  • 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. This is because Second Life Server regions are all restarted on Tuesdays, and RC regions are (sometimes) restarted on Wednesdays. With a DropBox on both, your delivery network will be online 24/7.

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

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. 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. 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.
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 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 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?
A1. 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.
A2. However, you CAN just add/remove from one (set of) dropbox(es), then pick up a copy of them and go to your other locations, delete the old dropbox(es) via the touch menu, and then rez out the new copies.