CasperVend 2/Holovendors

Last updated 26 June, 2013

Introduction

Hello and thanks for buying the CasperVend HoloVend system!

The HoloVend is a special type of vendor which has the ability to rez your product to demonstrate them to the customer before sale.

There are many rezzing vendor solutions out there, but I believe that the CasperVend solution is by far the easiest to use, and the most powerful.

If you get stuck at any point during the setup process, please contact Casper Warden for help.

What's in the HoloVend Pack?

HoloVendors in legacy prims

CasperVend HoloVend Legacy (1.x style)

CasperVend HoloVend PrimSaver

CasperVend HoloVend 1-Prim Scroller

CasperVend HoloVend 1-Prim Static

CasperVend HoloVend (Small Items)

CasperVend HoloVend Platform

HoloVendors in Mesh

CasperVend HoloVend Mesh Style 1

CasperVend HoloVend Mesh Style 2

CasperVend HoloVend Mesh Style 3

CasperVend Holovend Mesh Style 4

CasperVend HoloVend Mesh (Small Items)

Scripted Tools

CasperTech Rez-Free [Boxed] - (Contains the Rez-Free Tracker script)

JEVN Import Tools (v3)

CasperVend Redelivery Terminal

Scripts

HoloVend Tracker 2.x script

CasperVend Mapping Helper

Instructional Notecards

1) Holovendor 2.X Readme

2) Mesh Vendors - Script Usage!

3) IMPORTANT- Notes for existing users

4) IMPORTANT - About the Permissions Statement

UpgradeBees

5) UpgradeBee DROPBOXES ONLY v2.x

6) UpgradeBee HOLOVENDORS ONLY v2.x

Customisation

Templates + Customisation [Boxed] (includes the Customisation Readme)

Where's the Dropbox?

HoloVend purchases before 4 February, 2013 came with a dropbox, and are commission free.

HoloVend purchases on or after 4 February, 2013 are no longer a stand-alone pack (and thus no longer come with a dropbox), but must be used in conjunction with a vendor pack, either free or premium. If you only have the free vendors to go with the HoloVend, then the CasperTech 5% commission will be in effect on all sales. (If you have no sales, you don't pay commission.)

About the Dropbox

Your dropbox will perform your deliveries for you. It MUST stay rezzed AT ALL TIMES for your customers to receive the products they paid for. See the CasperVend 2/DropBoxes page for other important information.

Product Setup

To get started, Please follow ONE of the FOUR guides below depending on what your product consists of.

Item is One Linked Object (Not Coalesced/Soft-Linked)

A) Rez a HoloVend of your choice, and position it wherever you want it to be. Grant Debit Permissions (the orange popup menu) when asked.

B) Rez the DropBox, if you don't already have one rezzed.

C) Drop your item into the DropBox, along with a texture which will be used to advertise it.

D) Rez your object, and get it positioned wherever you want the HoloVend to rez it.

E) Drop the "HoloVend Tracker v2" script into your object

F) Check local chat. You should have some text similar to the example below. If not, please wait for it to appear (this should be no more than 10 seconds in normal conditions.) If you have multiple holovendors out, you WILL see this repeated once for each holovendor, even if they're not close to the demo object - this is normal:

"[09:19] (Object name): I've associated with a new holovendor with key a26f71d7-b921-6d56-0953-0c2a4559a495"

IMPORTANT - The object will "associate" to the *NEAREST* HoloVend. Please make sure there are no other HoloVend units closer to the object than the one you wish to rez from. A build platform a few hundred meters over your shop, and used JUST for setting up one holovendor at a time, should do the trick.

If you are using the single-item holovendors, and setting up several at once, you can move the ones you're NOT trying to associate with the demo item up in the air a sufficient distance so they are no longer the closest ones.

G) Rename the object to something distinctive, and take it into your inventory.

H) Drop the demo object into the HOLOVEND (NOT the DropBox). Wait a few seconds.

I) You should see a message which says "Upload complete". Under normal considitions this message arrives within a few seconds, but it may take longer if you have a LOT of objects in the holovendor, and/or the sim is lagging.

J) Once you get the upload complete message, skip down to the "Website Setup" step below

Item in Multiple Parts; NOT packed in supported rezzer

The HoloVend can NOT rez more than one object without the help of a build packager. However, we include the "Rez-Free" packager FREE with the vendor, which will allow you to pack your builds. If you already have your build packaged in one of the rezzing systems we support, then we can work with these directly, please skip to the appropriate "SUPPORTED REZZER" section below for details.

Alternatively, you can follow the instructions below to get your build packed into our Rez-Free.

This process will NOT ONLY get your product set up in the holovendor, but it will also create a distributable package for that your customers can rez to easily position all the build components.

A) Rez out and unpack your "Rez-Free" package to get the Anchor, and the Rez-Free Tracker script.

B) Rez your build, and get it positioned where you want the holovendor to rez it.

C) Rez a Rez-Free Anchor on the ground.

D) Position it approximately close to the center of your build, but in an easily accessible location.

E) Drop a Rez-Free Tracker script into each part of your build.

"Part" means - The root prim of each linkset or object. This does *NOT* mean every prim in a linkset!

You should link as much together as you possibly can first, before dropping the tracker scripts into your object parts. By linking things together as much as possible, you have fewer parts to try and manage, which saves you time.

F) You should see a particle trail from each part heading to the anchor. If any are pointing in a different direction, you have a second anchor rezzed and you should delete the extra anchor. Each piece should automatically find the nearest anchor once you delete the extra.

If you don't see any particles, make sure you have particles turned ON in your viewer, and that your particle slider in your viewer's graphics preferences has a number greater than 0.

WAIT for the particle streams to appear - only at that point has the Rez-Free anchor actually "locked on" to that piece of the build.

G) You can now move the anchor or rotate it and all the pieces of your build will follow. Try moving the anchor several meters into the air, just to see if you missed any pieces.

H) If you missed some pieces, simply "undo" the move to send the anchor back to it's original location, and put the tracking script in the pieces that were missed, and repeat from step F).

I) Once all the pieces are properly tracked (you'll see the hovertext indicating "TRACKING"), then right-click each piece in turn and "Take" it into your inventory.

J) Once all the pieces are in your inventory, right-click on the anchor, click the "contents" tab, and drag all the new pieces into the contents of the anchor.

K) Once that's done, click the anchor, then click Rez on the popup menu. The pieces should appear in their previous locations.

L) Rez a HoloVend of your choice, and position it wherever you want it to be. Grant Debit Permissions (the orange popup menu) when asked.

If you don't get asked for debit perms, please check that scripts are enabled on your land, and - if the land is owned by a group - that the HoloVend is rezzed under the actual land group.

M) Move the anchor until the build is in the place you want it to rez from the HoloVend.

IMPORTANT:

The object will "associate" to the *NEAREST* HoloVend. Please make sure there are no other HoloVend units closer to the object than the one you wish to rez from. This may require picking up the others, using a build platform, or simply moving the rest farther away than the one you're working with. A build platform a few hundred meters away from the store is often a good idea just to avoid confusing any other Holovends you have out.

N) Right click and Edit the anchor, switch to the General tab, and give the anchor a distinctive name which identifies your build.

O) Close the edit window, right click on the anchor, and "Take Copy".

The copy that's now in your inventory will be the "working copy" that you can easily make further updates to in the future.

P) Edit the anchor again, and change the name once more to indicate a "finished" version. We recommend adding "-FINAL" to the end of the name.

Q) Now, touch the anchor, and click "FINALISE!". You will NOT be able to make any further changes to a finalised anchor.

R) Rez the included DropBox, if you don't already have one rezzed.

S) Drop your FINALISED anchor into the DropBox, along with a texture which will be used to advertise it. It doesn't matter what the name of the texture is, other than it should not match the name of anything ELSE in the dropbox.

See the Dropboxes page for other important information.

T) Drop your FINALISED anchor into the HoloVendor contents. No texture is needed in the vendor.

U) You should see a message which says "Upload complete". If not, wait a while longer to allow for lag.

V) Once you get the upload complete message, skip down to the "Website Setup" step below

Item in multiple parts; packed in CasperTech Rez-Free

This section is not for those using a build rezzer other than the Rez-Free. Please skip to the next section below if you use a different rezzer.

A) Please make sure your rez-free anchor is FINALISED so that it is transferable.

B) Rez a HoloVend of your choice, and position it wherever you want it to be. Grant Debit Permissions (the orange popup menu) when asked.

If you don't get asked for debit perms, please check that scripts are enabled on your land, and - if the land is owned by a group - that the HoloVend is rezzed under the actual land group.

C) Rez the included DropBox, if you don't already have one rezzed.

D) Drop your anchor into the DropBox, along with a texture which will be used to advertise it. NOTE: It doesn't matter what the name of the texture is.

E) Rez your anchor, touch it, and click "Rez". Move the anchor so the build is positioned wherever you want the HoloVend to rez it.

F) Check local chat. You should have some text similar to the example below. If not, please wait for it to appear (this should be no more than 10 seconds in normal conditions.) If you have multiple holovendors out, you WILL see this repeated once for each holovendor, even if they're not close to the demo object. This is normal.

"[09:19] (Object name): I've associated with a new holovendor with key a26f71d7-b921-6d56-0953-0c2a4559a495"

G) Rename the anchor to something distinctive, and take it into your inventory.

H) Drop the anchor into the HOLOVEND (NOT the DropBox). Wait a few seconds.

I) You should see a message which says "Upload complete". Under normal considitions this message arrives within a few seconds, but it may take longer if you have a LOT of objects in the holovendor, and/or the sim is lagging.

J) Once you get the upload complete message, skip down to the "Website Setup" step below

Item in Multiple Parts; Packed in a Supported Third-Party Rezzer

The rezzers we support are:	Special Note About Jack-In-The-Box
Rez-Faux by Lex Neva	If you wish to use the Jack-in-the-box rezzer with the HoloVend,you must first put it into the CasperTech "JITB container". This is due to the incompatible method that Jack-In-The-Box uses to deal with "crosstalk" issues. the "JITB Container" acts as a "wrapper" rez-box that is HoloVend 2.x compatible. The "JITB Container" is currently not included in the holovendor pack - If you don't want to repack your builds in a Rez-Free, please send Casper Warden an IM and ask for the JITB Container.
Rez-Foo by Crystalshard Foo
Rez-Locus by April Heaney (The Omega Concern)
Horizons by Cheshyr Pontchartrain (Novatech)
Jack-In-The-Box by Jack Hathor

If you use a different rezzer that is not in this list, you must first re-pack the object into the CasperTech Rez-Free (which is included, FREE, in the Holovendor pack) and follow the "Not Packed in a Supported rezzer" section above.

A) Rez a HoloVend of your choice, and position it wherever you want it to be. Grant Debit Permissions (the orange popup menu) when asked.

If you don't get asked for debit perms, please check that scripts are enabled on your land, and - if the land is owned by a group - that the HoloVend is rezzed under the actual land group.

B) Rez the DropBox, if you don't already have one rezzed.

C) Drop your item into the DropBox, along with a texture which will be used to advertise it. NOTE: It doesn't matter what the name of the texture is, other than it should NEVER match anything else in the dropbox.

D) Rez the structure using your rezzer tool as you normally would.

E) Adjust the rez box so that the structure is positioned where you want the holovendor to rez it.

IMPORTANT:

The object will "associate" to the *NEAREST* HoloVend. Please make sure there are no other HoloVend units closer to the object than the one you wish to rez from. This may require picking up the others, using a build platform, or simply moving the rest farther away than the one you're working with.

F) De-rez the structure, but do NOT take the rezzer prim yet.

G) Drop the "HoloVend Tracker" script into the rez box.

H) Check local chat. You should have some text similar to the example below. If not, please wait for it to appear (this should be no more than 10 seconds in normal conditions.) If you have multiple holovendors out, you WILL see this repeated once for each holovendor, even if they're not close to the demo object. This is normal.

"[09:19] (Object name): I've associated with a new holovendor with key a26f71d7-b921-6d56-0953-0c2a4559a495

I) Now you can rename the rez box to something distinctive, and take it into your inventory.

J) Drop the rez box into the holovendor (NOT your DropBox).

K) You should see a message which says "Upload complete". Under normal considitions this message arrives within a few seconds, but it may take longer if you have a LOT of objects in the holovendor, and/or the sim is lagging.

Website Setup

Now it's time to get your product configured on the website and get ready to sell! Remember, the Holovendor needs to know what product to vend - it can't do that if there's no product listing on the website

A) Click the CasperVend logo on the face of the HoloVendor.

B) You will be sent a URL in a dialog. Click "Go to page".

C) If this is your first visit, you will need to register. See the instructions on the Passwords page.

If you already have a CasperVend account, and you're not already logged in, please login.

D) Once you're logged in to the website, click on "PRODUCTS".

E) Click "[Create New]", or if you've already listed the product you're listing, click [Edit] next to the product.

F) Fill in the details of the product you are listing.

The REQUIRED fields are:

• Name - The name of your product
• Item - The item that will be delivered (this lists the items in your dropbox)
• Texture - The texture that will be displayed to advertise your product
• Holo Item - The "rezzable" item. (this lists the items in your HoloVend contents).
• Permissions - Tick "Copy" if your item is copyable to enable automatic re-deliveries.
• Permissions - Ensure it's NOT ticked if the product you're selling is no copy to the customer.

The website CANNOT see what permissions you put on the actual object in your dropbox. This is why it's critical to set this correctly on the website!

G) Scroll down to the bottom and click "SAVE". The website will give you a white popup saying "Saved" on it.

H) That's it, you're done! In a few moments your HoloVend should display the the texture for the product you just configured.

Creating a New Profile

If you want to demo different products from different vendors, you need to put those products into a profile for the HoloVend. This can be done via the Caspervend website, the same way you'd put a multi-item vendor into a profile.

A) Click the CasperVend logo on the face of the HoloVendor.

B) You will be sent a URL in a dialog. Click "Go to page".

C) If you are asked to login, please do so.

D) You will reach the vendor config page. *DO NOT* click the Profiles button on the left, stay on the vendor page.

E) Click "[New Profile]"

F) Give the profile a distinctive name, then click "Next"

G) On the screen after that, you'll see the "Not in profile" and "In profile" pair of white boxes.

H) Select each product individually that you want in the profile, and click the single right arrow to move it over, one at a time.

There is currently no way to select only some and move them over together - only moving one at a time, or all of them at once.

I) When done moving products, click "Finish". Your vendor will now update to show the products you've selected.

If you want to

Use an Existing Profile

You can use the same profile in other vendors. Just follow the same instructions, except instead of clicking "New Profile", click the [Change] link next to "Profile: ", select the profile you want to use, and click "OK".

Testing Your Holovendor

Click the Rez button and wait for the object to rez. Then, click the rez button again to derez the object. (The rez button acts as a toggle switch.)

Setting a Default Item to Always Rez

Setting an item to be rezzed by default when nothing is rezzed is simple:

1) Click the logo area on the holovendor

2) Open your chat history and click the link to get to the CasperVend website

3) Log in. You should then be at the configuration page for that HoloVend unit

4) Go to the "actions" section and look for the white box next to "default item to be rezzed when no demos are showing"

5) Choose your default item (this will list the items in your vendor's contents), and press "Save"

FAQ / Troubleshooting

Q. Why does the product listing empty the holo demo??

A1. The only action that can involuntarily clear a demo listing is the product update action - clicking "save" on a product listing while there is no demo item selected. This happens when you edit, create or delete a product. Always make sure the demo item is selected for any product you want to show the demo for in a holovendor.

A2. This can happen if the holovendors contents are not synchronised properly, at the time you edit the product.

A3. No, the database does NOT have the ability to randomly delete the contents of a field by itself.

Q. The holovendor works, but only when I'm online. When I'm offline, it stops working. Why??

A1. The vendor needs to be set to the correct land group when build is "off" for everyone.

A2. It will rez when you're online because you're an officer in the land group - but as soon as you log off, it will stop working because there's no officer online.

A3. Do *NOT* deed the holovendor to the group, only rez under/set it to the land group.

Q. I moved my stuff from my v1 holovendor into the new one, and the stuff doesn't rez in the right place...

A1. You can't move your stuff directly from a v1 vendor to a v2 vendor - the tracker scripts must be updated as well. Items must be tracked with the latest rez-free AND the latest holovendor tracker script in order for the HoloVend 2.x to properly rez and derez the object(s). Otherwise you get stuff not rezzing, and/or stuff not DE-rezzing as a result of the mismatch.

A2. The 2.x HoloVends are not built the same way, or with the same prim orientation. You will need to go through and reconfigure the positions and orientations of your items to be rezzed in order to get them to rez properly from the new HoloVends.

Q1. The vendor is leaving copies of stuff behind.

Q2. I've moved my stuff from my v1 holovendor and stuff won't de-rez.

A1. You can't move your stuff directly from a v1 vendor to a v2 vendor - the tracker scripts must be updated as well. Items must be tracked with the latest rez-free AND the latest holovendor tracker script in order for the HoloVend 2.x to properly rez and derez the object(s). Otherwise you get stuff not rezzing, and/or stuff not DE-rezzing as a result of the mismatch.

Q. I have hovertext over my Rez-Free build every time I test-rez them. How do I get that to go away for HoloVend use?

A. The HoloVend will automatically remove the hovertext when it rezzes out your Rez-Free anchor.

Q. My stuff doesn't auto-rotate anymore!

A1: HoloVend 2.x does NOT do auto-rotate by default. If you want your product to continue to auto-rotate, you'll have to set it manually on the website configuration page - it's a tickbox.

A2: Anything which is composed of multiple parts (and thus packed into a rezzer like the Rez-Free or Rez-Faux) cannot auto rotate. This is only possible with single objects.

Q. Why are HoloVends so laggy?

A1. Casper Warden writes: "Rezzing anything causes significant lag. It's not the HoloVend itself which is laggy, it's the process of rezzing items. It means every client on the sim has to download the prim and texture data, it means the physics engine has to register and mesh new bodies. It's one of the most laggy things you can do, other than teleporting. "

A2. Rezzing a lot of scripts causes lag. (This is typically the worst part of the lag-after-teleport issue, as people often have a LOT of scripts in hair, shoes, HUD's, weaponry, etc.) If your demo product is heavily scripted, this will make the lag that much WORSE.

Q. I got a popup message saying "Sorry, the item configured to be __________ isn't in my contents - so I can't rez it!"

A1. If you replaced a demo item:

• Click the logo area for the configuration URL and log in to the website.
• Go to the "Products" page, find the product you're trying to rez,
• click "edit", and on that product's "Holo Item" line, pull the dropdown and
• select the item that's actually IN the holovendor.

A2. Put the demo objects in the HoloVender, NOT the dropbox.

Q. Can I set up the HoloVend to just demo, not vend?

A. Yes, as of the 2.x versions, you can set a HoloVendor to just demo products and not accept payments. It's a checkbox on the vendor's configuration page.

Q. Is there a size limitation for objects to be rezzed from the Holovendor?

A. Only what will actually fit both within the parcel boundaries, and within the prims/impact remining.

Q. Can the HoloVend rez mesh objects?

A. Yes, provided you have appropriate permissions.

Q. Do I also need the CasperVend system to use the HoloVend?

A1. New Holovend purchases from 4 February 2013 *DO* require a purchase of CasperVend in order to function. (A dropbox is no longer in the HoloVend package by itself)

A2. If you don't already have one, you can get a dropbox by picking up a copy of the FREE vendors from the CasperTech store.

Q. If I get the Holovendor now, and then start using the CasperVend system later, will the CasperVend vendors integrate with the Holovendor?

A. Yes, because it all uses the same backend system.

Q. I set up an unlinked object in the holovendor using the rezzer, but sometimes one part rotates when it's rezzed.

A. Most likely reason: You're rezzing the build too close to parcel or sim/region edge. Move the holovendor (or re-do the demo's placement) so it rezzes farther away from the parcel edge and the problem should go away.

Q. ERROR: have a HoloVend out, but it's not working...

A1) Scripts must be turned on (estate level) on the sim/region your holovendor is on

A2) If land is held in a group, the holovendor should be set to / rezzed under the correct land group

Q. ERROR: "CasperVend DropBox WARNING: The Item [product name] is NOT TRANSFERRABLE. It will not be listed or available for delivery."

A1. Don't put the holo demo item in the dropbox - holovend tracker script is no-transfer.

A2. YOU must have transfer permissions on an object you are setting up to vend. Next owner permissions can be set to whatever you wish, but if you can't transfer the product in the first place, it can't be vended via CasperVend or the HoloVend either.

A3. If you used a rezzing package for the item, check each piece to make sure you pulled out the appropriate setup scripts (those are usually no-transfer to you) but leaving the appropriate user scripts (these are no-mod, but copy/trans to you.)

Q. ERROR: My HoloVend keeps uploading...and uploading...and uploading...and uploading. What's going on?

A1. If you add or removed inventory from the HoloVend, it will send the changes each time.

A2. If you have NOT given it a profile, it will automatically be in the "default" profile. Thus, if you make any changes to ANY products on the website, it will see those and attempt an upload every time you make website changes - even if you have no other products in the "default" profile set, and even if the HoloVend empty. To stop the continual messages, simply set it to a random or empty profile.

Q. Once I have the HoloVend set up, can I just pick up a copy and rez the copy somewhere else?

A. Yes.The demos inside the holovendor will rez relative to the HoloVend's physical position. Remember to make sure you have adquate space in any additional locations.

Q. How do I get my products to not rotate when they're rezzed?

A1. Click the CasperVend logo on the rezzer and configure it to not rotate on the web.

A2. If they're still rotating when you have the vendor set to NOT rotate, then check your prims - there's likely a script in one of your objects (that should NOT be there) that's causing the rotation on rez.

A3. You cannot rez multiple objects simultaneously with the HoloVendor. Multi-piece items MUST be packed in a rezzing package, as covered above.

Q. I packed everything in the Rez-Free, but when I test rez, I see this kind of message over the Rez-Free Anchor - "3 parts remaining: rez queue 0" - and/or nothing is rezzing where it should be!

A1. You don't have the Rez-Free Tracker script in the objects you're trying to rez.

A2. You have the wrong script in the pieces you are rezzing (or no script at all). Commonly this is the Holovend Tracker script in there by mistake. Take out the wrong script and replace with the one named: "Rez-Free Tracker".

Q. What is the sensor range of a HoloVendor during setup?

A. Region-wide.