CasperVend 2/Customisation: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
m (Added section for "no more products" texture customisation)
 
(72 intermediate revisions by 4 users not shown)
Line 4: Line 4:
[[File:German_flag.gif]] [[CasperVend 2/Customisation/DE | Schaue hier in Deutsch!]]
[[File:German_flag.gif]] [[CasperVend 2/Customisation/DE | Schaue hier in Deutsch!]]


= '''<span style="color:#00528c">Requirements </span>''' =
= '''<span style="color:#00528c">Requirement - Experienced Builder </span>''' =
These instructions below will provide all the information an experienced builder needs to create a customised vendor.  
:* You must know how to build a "physical" item "from scratch".
:* This does '''not''' mean simply retexturing or combining full perm kit items.
:* You must know how to create and edit both objects and their contents.
:* You must be able to edit individual prims/objects in a linkset.


Because of the fact that vendor customisation is an advanced topic which depends already having builder skills - you '''MUST''' know how to build an item with prims/sculpts/mesh "from scratch" - or how to make alterations to an existing item - we '''do not provide technical support for this process'''. We can, however, recommend classes at '''[http://www.buildersbrewery.com/ Builder's Brewery]''' if you wish to learn building skills yourself.  
Vendor customisation is an advanced skillset that depends on you '''already''' having these experienced builder skills.  


If you are having absolutely no luck, however, alternatively you can pay us to do it - see our '''[[CasperVend 2/Customisation Service|Customisation Service]]''' page for details.
Because this is a more advanced skillset, we do not provide technical support for this process beyond the scope of this docunentation.
 
=== Need to Learn Building Skills? ===
----
We highly recommend classes at the Builder's Brewery to increase your skillset
(see their class schedule at the '''[http://www.buildersbrewery.com/ Builder's Brewery website]''' or inworld at the '''[http://maps.secondlife.com/secondlife/Builders%20Brewery/128/193/23 Builders Brewery sim/region]''') if you wish to learn how to create and edit prims and their contents.
 
=== Have Custom Vendor But No Time to Map It? ===
----
We offer a customisation service - see '''[[CasperVend_2/Customisation_Service | this page]]''' for details.


= '''<span style="color:#00528c">Known Limitations</span>''' =
= '''<span style="color:#00528c">Known Limitations</span>''' =
Line 19: Line 31:
----
----
# The vendor script (and thus the mapping helper script) must always be in the '''[http://wiki.secondlife.com/wiki/Link root prim.]'''
# The vendor script (and thus the mapping helper script) must always be in the '''[http://wiki.secondlife.com/wiki/Link root prim.]'''
# The panel that you expect the customer to pay on - to get the product - is the panel that should be part of the root prim. Otherwise, you will get script errors - the "pay" function of LSL only recognizes specified pay amounts (like the price of your product) when the script is in the root prim of a linkset.
# The panel that you expect the customer to pay on - to get the product - should be part of the root prim. Otherwise, you will get script errors - the "pay" function of LSL only recognizes specified pay amounts (like the price of your product) when the script is in the root prim of a linkset.
 
=== Do Not Use in Furniture ===
----
The vendor script WILL reset itself any time the vendor is sat on, and anytime a sitting avatar stands up.
 
LSL reads all sitting avatars as a change to the relevant linkset, so sitting or standing up will force the script to reset and re-read the configuration.
 
It is important to note that the vendor will still WORK (a seated avatar is never "root"), but if it's resetting while a customer is attempting to pay the vendor, then that may confuse the customer and make them think your vendors are broken.
 
There are two workarounds for this:
:* Using the '''[[CasperVend_2/Holovendors | HoloVend]]''' to display furniture that is expected to be sat on. (This lets the customer sit on furniture, and you to save prims/impact. Win-win!)
:* Use regular vendors, and simply set one vendor next to each furniture item (or set) that you are selling.
 
=== Holovend Panel Limit of 7 Total Panels ===
----
 
Holovend, unlike the regular vendors, also performs rezzing, derezzing and timed functions. Because of this, and the CasperTech practice of only having 1 script per vendor, there isn't room in the script programming to safely handle more than the main panel + 6 additional panels (total of 7 panels).
 
If you choose to add more, you do so at your own risk - '''[[CasperVend_2/Customisation#Stack_Heap_errors | "Stack Heap"]]''' errors and vendor crashes will be common.
 
If Linden Lab actually increases the maximum filesize of a script, this will be revisited at that time.


= '''<span style="color:#00528c">Customising Vendor Objects</span>''' =
= '''<span style="color:#00528c">Creating Your New Vendor</span>''' =


=== Custom Vendor Objects ===
=== Mapping Your Vendor Object ===
----
----
# Create (or edit) your vendor object.
# Create (or edit) your vendor object.
Line 31: Line 64:
# Follow the instructions on the popup prompts.
# Follow the instructions on the popup prompts.


It is '''CRITICALLY IMPORTANT''' to rename each prim in a multi-prim vendor object because the mapping script essentially looks for "the face number ____ on the prim named ____" - if your customised vendor prims are ALL named "object" your mapping will be very VERY confused, and your custom vendor will NOT work properly!  
It is '''CRITICALLY IMPORTANT''' to give each prim in a multi-prim vendor object a unique name because the mapping script essentially looks for "the face numbered ____ on the prim named ____" - if your vendor object's multiple prims are ALL named "object", your mapping will be very VERY confused and your custom vendor will NOT work properly!  


You do '''not''' need one prim per face.
You do '''not''' need one prim per face.


=== Difference between "Headless" and "Touch" Vendors ===
=== Selling Clothing? Difference Between "Touch" & "Headless" ===
----
----
'''HEADLESS:'''<br />Headless vendors are designed to be used in an object that is not normally a vendor - such as a plant, a table, or a chest of drawers. Thus, there is NO image called with the Headless' mapping card.  
'''HEADLESS:'''<br />Headless vendors are designed to be used in an object that is not normally a vendor - such as a plant, a table, or a chest of drawers. Thus, there is NO image called with the Headless' mapping card.  
Line 41: Line 74:
'''TOUCH:'''<br />Touch vendors are designed to be used as a simple box. The touch vendors DO use a picture, so space for one is required.
'''TOUCH:'''<br />Touch vendors are designed to be used as a simple box. The touch vendors DO use a picture, so space for one is required.


'''BOTH TYPES:'''<br />Both types DO have a popup menu accessible on a click for actions beyond just paying the vendor.
'''BOTH TYPES:'''<br />Both types DO have a popup menu that is accessible by clicking on the main panel for actions beyond just paying the vendor.


=== Making A Non-Vendor Object Into A Vendor (Headless Vendor) ===
=== Single Item Vendor Types ===
----
All vendors - single or multi product - will rez out and '''by default''' will pull in what is called the "default" profile. However, the vendors in this list do not have arrows, and will need to be specifically told which single product you want to be shown on that vendor:
 
:* Touch vendor
:* Two-faced
:* Headless
:* Static
 
=== Making A Non-Vendor Object Into A Vendor ("Headless" Vendor) ===
----
----
# Take the vendor script AND "mapping" notecard out of the headless vendor into your inventory  
# Take the vendor script AND "mapping" notecard out of the headless vendor into your inventory  
Line 54: Line 96:
# You will NOT see any images on any vendor object using the headless script - this is intentional.  
# You will NOT see any images on any vendor object using the headless script - this is intentional.  


'''Remember:''' All vendor objects NEED a mapping notecard - they will not function without it. You do NOT need to set up panels with the headless script, but the vendor script does need to know that it can accept payments from all faces.
'''Remember:''' All vendor objects NEED a mapping notecard - they will not function without it. You do NOT need to set up panels with the headless script, but the vendor script does need to know what faces to accept payments from.
 
==== Known Headless Limitation ====
----
It is not recommended that you use the "Headless" vendor script in any object that will be sat on - when an avatar sits on an object, it is treated in LSL scripts as a change in the linkset. So, every time an avatar sits or stands, it will force a soft reset while the vendor object re-reads the notecard and reconnects to the site. This will not utlimately impair functionality (the vendor object will function normally once the reset is complete), but it will likely confuse most customers.
 
There are two workarounds for this:
:* Using the '''[[CasperVend_2/Holovendors | HoloVend]]''' to display furniture that is expected to be sat on.
:* Use regular vendors, and simply set one vendor next to each object you're selling.


=== Cube Vendors ("Touch" vendor boxes) ===
=== Cube Vendors ("Touch" vendor boxes) ===
Line 70: Line 104:
The touch vendor is only designed to vend ONE product - so don't use a profile that has multiple items in it, because only one of them will be displayed. It has no way to scroll between items.
The touch vendor is only designed to vend ONE product - so don't use a profile that has multiple items in it, because only one of them will be displayed. It has no way to scroll between items.


==== MAPPING Card For Cubes ====
=== Pay All Sides of Cube Vendor ===
----
----
If you wish to use a vendor as a simple box/cube shape, and want customers to be able to PAY any side of the box, then make this simple change in the mapping card:
If you wish to use a vendor as a simple box/cube shape, and want customers to be able to PAY any side of the box, then make this simple change in the mapping card:


    '''Where it says:'''  __ROOT__,1,<0.0,0.0,1.0,1.0>  
  '''Where it says:'''  __ROOT__,1,<0.0,0.0,1.0,1.0>  
    '''Change it to:'''  __ROOT__,-1,<0.0,0.0,1.0,1.0>
  '''Change it to:'''  __ROOT__,-1,<0.0,0.0,1.0,1.0>
 
==== Known Cube/Touch Issue ====
----
If you have used the instructions for '''''"__ROOT__,-1,<0.0,0.0,1.0,1.0>"''''', the vendor WILL give you a <span style="color:#F00;">'''"llSetPrimitiveParams error running rule #2: non-integer rule."'''</span> message.
 
The vendor '''will still function''' despite this error.


= '''<span style="color:#00528c">Customising Your Textures</span>''' =
= '''<span style="color:#00528c">Customising Vendor Textures</span>''' =
=== Offline / Back Soon Textures ===
=== Offline / Back Soon Textures ===
----
----
Line 98: Line 126:
# Rename the texture to this: 7273cc74-2b6c-530f-293a-3af92422beae
# Rename the texture to this: 7273cc74-2b6c-530f-293a-3af92422beae
# Reset/resync the vendor so that it re-reads the contents and picks up the new texture.  
# Reset/resync the vendor so that it re-reads the contents and picks up the new texture.  
=== "No More Products" Texture ===
----
Similar to the "No Product" texture, this texture will only show if you're using a multi panel vendor with a group profile, and have "(V2.09 vendors only) Generate profile as 'pages' of" turned on without enough products to fill your panels.
This will allow YOUR customised "No More Products" texture to be used rather than the default CasperTech one.
You may need to reset the vendor (click the vendor, select "reset" from the popup) for it to pick up your custom "no products" texture.
# Place your texture into the contents of the vendor
# Rename the texture to this: a8b974af-fae5-ab18-3789-43f28edcc413
# Reset/resync the vendor so that it re-reads the contents and picks up the new texture.
=== "Initializing" Texture ===
----
This is not necessary, as it doesn't usually show for very long, but for consistency with the Offline and No Items textures, you can replace the Initializing texture as well.
# Place your texture into the contents of the vendor
# Rename the texture to this: 70fd1ef6-0877-c53a-4f34-45576f880d76


=== Texture (Button) Templates ===
=== Texture (Button) Templates ===
Line 112: Line 158:
Templates for the Transporter are NOT currently (as of the last major update) in the shipping crate, but ARE available upon request from either Casper Warden or Sphynx Soleil - simply inquire within Second Life.
Templates for the Transporter are NOT currently (as of the last major update) in the shipping crate, but ARE available upon request from either Casper Warden or Sphynx Soleil - simply inquire within Second Life.


TextureVend templates are inside the TextureVend vendor itself.
TextureVend templates are inside the TextureVend vendor itself, rather than the general "customisation guide and tools" box.


=== Texture Repeat Issues ===
=== Texture Repeat Issues ===
Line 121: Line 167:
# Allow debit permissions.  
# Allow debit permissions.  


That way the script will completely reset and pick up the new orientation as correct, instead of remembering the old.
Done in that order, resetting the script will force it to pick up the new orientation as correct one, instead of remembering the old incorrect one.
 
If you reset the vendor for this situation and (1) you did NOT get a debit perms popup, and (2) the vendor came up normally, then you used the wrong reset option.  


If you reset the vendor for this situation and (1) you did NOT get a debit perms popup, and (2) the vendor came up normally, then you used the wrong reset option. Do '''NOT''' use "reset" on the popup if you are trying to fix the texture - use edit mode, then find the menu option for "reset scripts in selection".  
Do '''NOT''' use "reset" on the popup if you are trying to fix the texture - use edit mode, then find the menu option in your viewer menus for "reset scripts in selection".


Alternately, you may pick up and then re-rez the vendor, but remember that doing so will leave an extra vendor on your website vendor list each time (so run the upgradebee on "Check All" when you're done to flush out the non-rezzed vendors.)
=== Animated Textures ===
*Not officially supported by CasperTech*
Ruthven Willenov has created a plug in for this on the [https://wiki.casperdns.com/index.php/Plug-Ins Plug-Ins Page]


= '''<span style="color:#00528c">About The EasyMod example Object</span>''' =
= '''<span style="color:#00528c">Vendor Errors</span>''' =
=== Error Running Rule: Prim Texture ===
----
==== Clothing merchants and similar situations ====
----
Did you just take the MAPPING card out of a normal vendor and drop it in a normal box with a product picture already on it? (i.e., selling clothing)
 
If so, you need the MAPPING card from the '''HEADLESS''' vendor instead.
 
As long as the script came from a regular vendor (script is named just "'''CasperVend2'''"), that will be fine - it's the MAPPING notecard that makes a difference.
 
==== Customized vendor object from scratch ====
----
You may see one, all, or some combination of these errors:
 
: '''rule #1 (PRIM_TEXTURE): arg #3 (texture repeat) is missing.'''
: '''rule #2 (PRIM_TEXTURE): arg #3 (texture repeat) vector expected but string given.'''
: '''rule #1 (PRIM_TEXTURE): arg #3 (texture repeat) vector expected but integer given.'''
 
Check every single prim in your vendor object. You quite likely have two or more with the same name (Usually it will be seen with "Object", but it depends on how you've named your prims.)
 
Simply change the prim names so that no two prims in the vendor object have the same names, rerun the mapping script, and everything should be happy.
 
=== Error Running Rule #2: Non-Integer Rule ===
----
If you have used the instructions for '''''"__ROOT__,-1,<0.0,0.0,1.0,1.0>"''''', the vendor WILL give you a <span style="color:#F00;">'''"llSetPrimitiveParams error running rule #2: non-integer rule."'''</span> message.
 
The vendor '''WILL still function''' despite this error.
 
This will be normal until Casper tracks down why that happens and fixes it. (He is aware of the problem.)
 
=== Stack Heap errors ===
----
A stack heap error is '''not''' very common, but when it does, it generally will be for one of these two reasons:
 
# '''Duplicate Prim Names:'''The customised vendor has more than one prim AND at least 2 prims have the exact same name. (This makes the script very confused)
# '''Too Much Data:''' You're using product names which are excessively long, especially on a vendor with 13 panels. (A single script only has so much memory....the longer the product names are - especially when you include the full store name as part of the product name - the more memory each product takes up.) For 13-panel vendors, this can happen with the default 13-panel that ships with the system as well as custom vendors.
 
Any vendor in either of these situations may simply appear - to customers - "frozen" and be completely non-responsive, rather than giving anyone an obvious stack heap message. You may not get the error if you have script error messages disabled, or if you are offline when the error happens.
 
=== Payment Stopped ===
----
'''Payment stopped: The price paid does not match any of the pay buttons set for this object'''
 
This occurs when a '''child prim''' of an object is right clicked and "paid", when the child prim contains - '''or used to contain''' - a vendor script or some other script which configures the pay buttons.
 
'''You must not link vendors together'''. CasperVend scripts must be in the ROOT PRIM only. However, even after you have removed the script from the child prim, you will still see the error, because the configuration is a property of the prim and not the script.
 
To fix this, drop the following script into the child prim of the vendor:
 
<syntaxhighlight lang="lsl" >
default
{
    state_entry()
    {
        llSetPayPrice(0,[]);
        llSay(0,"Pay configuration removed on prim");   
        llRemoveInventory(llGetScriptName());
    }
    money(key id, integer amount)
    {
       
    }
}
</syntaxhighlight>
 
On '''very rare''' occasions, if the viewer is giving the customer a different price than what you've set the pay buttons for, this error will also happen - but this will NOT happen with any sort of regularity, and other viewers which are reporting accurate pay button information will have no problem. See '''[https://jira.secondlife.com/browse/SVC-7170 this JIRA ticket for details.]'''
 
=== Vendor is Grey ===
----
If you have rezzed out your vendor and given it permissions but it turns grey, the common causes are:
:# Mapping card - redo if necessary
:# Profile vendor is set to has no products
:# Vendor is missing the "Vendor_Offline" texture
 
'''Note:''' If scripts are off, OR the vendor has crashed, you will NOT get a debit window, any message, OR change in vendor textures. If you have muted yourself, you won't get a debit window or any message either, but you will see the textures change on a multi-panel vendor.
 
= '''<span style="color:#00528c">Technical Notes & Background</span>''' =
 
This section is for '''background information only!'''
 
=== About The EasyMod example Object ===
----
This is an example vendor set up just so that you can see the maximum possible buttons. Each prim in the vendor is labeled with the appropriate button name the script is looking for.
This is an example vendor set up just so that you can see the maximum possible buttons. Each prim in the vendor is labeled with the appropriate button name the script is looking for.


Line 136: Line 268:
<span style="color:#F00;">'''NOTE: The numbering on the prims of the EasyMod may not necessarily match the order of the mapping helper script panels. This is just an example layout.'''</span>
<span style="color:#F00;">'''NOTE: The numbering on the prims of the EasyMod may not necessarily match the order of the mapping helper script panels. This is just an example layout.'''</span>


= '''<span style="color:#00528c">Technical Notes</span>''' =
=== About the Mapping Process ===
=== About the Mapping Helper Process ===
----
----
This is an overview of the mapping script '''process''' - do '''NOT''' use this as a guide to set up a MAPPING card - this is only informational, for those who are curious about it.
{{Critical|This is '''JUST AN OVERVIEW''' of the mapping script '''process''', and is presented only for informational purposes!
 
Do '''*NOT*''' use this as a guide to set up a MAPPING card!}}
 
: '''Reset'''  
: '''Reset'''  
: This wipes any configuration you've done up to that point
: This wipes any configuration you've done up to that point
Line 186: Line 320:
::: As with the texture panels above, just click "skip" on the options you're not using. (For example, not everyone uses the demo button.)  
::: As with the texture panels above, just click "skip" on the options you're not using. (For example, not everyone uses the demo button.)  
                  
                  
::: Yes, this can be used to customize buttons for a v2.x HoloVendor!  
::: Yes, this can be used to customize buttons for a HoloVendor!  


: '''Finish'''  
: '''Finish'''  
Line 201: Line 335:


All done!
All done!
= '''<span style="color:#00528c">Payment Stopped Message</span>''' =
  Payment stopped: The price paid does not match any of the pay buttons set for this object
This is a linkset issue. Basically, the CasperVend script isn't in the root prim, or the vendor has been linked to another prim that contains another script using the script-pay function.
To fix, make sure the CasperVend script is the ONLY vendor script in the object, and that it is in the root prim.


= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =
= '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' =
Line 213: Line 340:
:: '''A1.''' Yes, it doesn't matter what size the vendor is, as long as all the buttons map correctly.
:: '''A1.''' Yes, it doesn't matter what size the vendor is, as long as all the buttons map correctly.
:: '''A2.''' You can also change the shape, just remember to go through the instructions in the customization section to remap all the buttons and vendor image panels correctly.  
:: '''A2.''' You can also change the shape, just remember to go through the instructions in the customization section to remap all the buttons and vendor image panels correctly.  
: '''Q. I rezzed out my 2.x vendor, gave it permissions, but now it's all gray!'''
:: '''A.''' This can happen for one of two reasons:
::# Incorrect "MAPPING" configuration card
::# Vendor is set to a profile with no products
:: (If scripts are OFF and the vendor cannot work, you will NOT get a debit window, any message, OR change in vendor textures. If you have muted yourself, you won't get a debit window or any message either but you will see the textures change.) 
: '''Q. I just noticed setting my vendors to "offline" makes them all a flat grey colour - can I replace that with my own image?'''
:: '''A.''' The vendors are going grey because you don't have the "VENDOR_OFFLINE" texture in the vendor. So yes, you can replace it with your own branded texture - they only went grey because there wasn't ANY texture by that name.


: '''Q. A vendor I'm setting up for a new profile has a quirk, each time I "touch" it, it tells me "(my vendor name): Touched" - and does not display the menu, just gives me that message. How do I fix this?'''  
: '''Q. A vendor I'm setting up for a new profile has a quirk, each time I "touch" it, it tells me "(my vendor name): Touched" - and does not display the menu, just gives me that message. How do I fix this?'''  
:: '''A.''' Look inside the vendor contents for a script named "New Script". The script that ships with the vendor will never be named this, so if there is a script named "New Script" it may safely be deleted. (You may have accidentally clicked "new script" - which creates a script that just tells you the object was touched.)  
:: '''A.''' Look inside the vendor contents for a script named "New Script". The script that ships with the vendor will never be named this, so if there is a script named "New Script" it may safely be deleted. (You may have accidentally clicked "new script" - which creates a script that merely tells you the object was touched.)  
                            
                            
: '''Q. Can I set the vendors to "Phantom"? '''     
: '''Q. Can I set the vendors to "Phantom"? '''     
:: '''A.''' Yes, and they will still work :)
:: '''A.''' Yes, and they will still work :)

Latest revision as of 14:04, 21 October 2018

Schaue hier in Deutsch!

Requirement - Experienced Builder

  • You must know how to build a "physical" item "from scratch".
  • This does not mean simply retexturing or combining full perm kit items.
  • You must know how to create and edit both objects and their contents.
  • You must be able to edit individual prims/objects in a linkset.

Vendor customisation is an advanced skillset that depends on you already having these experienced builder skills.

Because this is a more advanced skillset, we do not provide technical support for this process beyond the scope of this docunentation.

Need to Learn Building Skills?


We highly recommend classes at the Builder's Brewery to increase your skillset (see their class schedule at the Builder's Brewery website or inworld at the Builders Brewery sim/region) if you wish to learn how to create and edit prims and their contents.

Have Custom Vendor But No Time to Map It?


We offer a customisation service - see this page for details.

Known Limitations

No HUD-based Vendors


LSL does not allow the "pay" function on HUD-based objects, so HUD-attached vendors will not work.

Where Do the Scripts Go?


  1. The vendor script (and thus the mapping helper script) must always be in the root prim.
  2. The panel that you expect the customer to pay on - to get the product - should be part of the root prim. Otherwise, you will get script errors - the "pay" function of LSL only recognizes specified pay amounts (like the price of your product) when the script is in the root prim of a linkset.

Do Not Use in Furniture


The vendor script WILL reset itself any time the vendor is sat on, and anytime a sitting avatar stands up.

LSL reads all sitting avatars as a change to the relevant linkset, so sitting or standing up will force the script to reset and re-read the configuration.

It is important to note that the vendor will still WORK (a seated avatar is never "root"), but if it's resetting while a customer is attempting to pay the vendor, then that may confuse the customer and make them think your vendors are broken.

There are two workarounds for this:

  • Using the HoloVend to display furniture that is expected to be sat on. (This lets the customer sit on furniture, and you to save prims/impact. Win-win!)
  • Use regular vendors, and simply set one vendor next to each furniture item (or set) that you are selling.

Holovend Panel Limit of 7 Total Panels


Holovend, unlike the regular vendors, also performs rezzing, derezzing and timed functions. Because of this, and the CasperTech practice of only having 1 script per vendor, there isn't room in the script programming to safely handle more than the main panel + 6 additional panels (total of 7 panels).

If you choose to add more, you do so at your own risk - "Stack Heap" errors and vendor crashes will be common.

If Linden Lab actually increases the maximum filesize of a script, this will be revisited at that time.

Creating Your New Vendor

Mapping Your Vendor Object


  1. Create (or edit) your vendor object.
  2. If your new vendor object has more than one prim, give EACH PRIM its own unique name.
  3. Drop the Mapping Helper script into the root prim of the vendor object.
  4. Click the vendor object.
  5. Follow the instructions on the popup prompts.

It is CRITICALLY IMPORTANT to give each prim in a multi-prim vendor object a unique name because the mapping script essentially looks for "the face numbered ____ on the prim named ____" - if your vendor object's multiple prims are ALL named "object", your mapping will be very VERY confused and your custom vendor will NOT work properly!

You do not need one prim per face.

Selling Clothing? Difference Between "Touch" & "Headless"


HEADLESS:
Headless vendors are designed to be used in an object that is not normally a vendor - such as a plant, a table, or a chest of drawers. Thus, there is NO image called with the Headless' mapping card.

TOUCH:
Touch vendors are designed to be used as a simple box. The touch vendors DO use a picture, so space for one is required.

BOTH TYPES:
Both types DO have a popup menu that is accessible by clicking on the main panel for actions beyond just paying the vendor.

Single Item Vendor Types


All vendors - single or multi product - will rez out and by default will pull in what is called the "default" profile. However, the vendors in this list do not have arrows, and will need to be specifically told which single product you want to be shown on that vendor:

  • Touch vendor
  • Two-faced
  • Headless
  • Static

Making A Non-Vendor Object Into A Vendor ("Headless" Vendor)


  1. Take the vendor script AND "mapping" notecard out of the headless vendor into your inventory
  2. Drop the script and notecard from your inventory into your non-vendor product
  3. Click the object, and select "Admin"
  4. Log in to the website, if necessary
  5. You will be taken to the configuration page for that vendor product
  6. Change your options as desired
  7. All set!
  8. You will NOT see any images on any vendor object using the headless script - this is intentional.

Remember: All vendor objects NEED a mapping notecard - they will not function without it. You do NOT need to set up panels with the headless script, but the vendor script does need to know what faces to accept payments from.

Cube Vendors ("Touch" vendor boxes)


The touch vendor allows the customer to interact with different options by way of a click/touch popup menu instead of buttons on one of the visible faces. This means that the vendor can be in a "standard" box shape, with customers being able to interact with all sides of the vendor instead of only one or two sides of it.

The touch vendor is only designed to vend ONE product - so don't use a profile that has multiple items in it, because only one of them will be displayed. It has no way to scroll between items.

Pay All Sides of Cube Vendor


If you wish to use a vendor as a simple box/cube shape, and want customers to be able to PAY any side of the box, then make this simple change in the mapping card:

  Where it says:  __ROOT__,1,<0.0,0.0,1.0,1.0> 
  Change it to:  __ROOT__,-1,<0.0,0.0,1.0,1.0>

Customising Vendor Textures

Offline / Back Soon Textures


Inside each vendor are two textures: "BACK_SOON" and "VENDOR_OFFLINE"

Simply create two replacement textures, name the appropriate one with the appropriate name, Delete the old ones out of the vendor, and replace with the new. It's that easy!

"No Product" Texture


This will allow YOUR customised "No Products" texture to be used rather than the default CasperTech one.

You may need to reset the vendor (click the vendor, select "reset" from the popup) for it to pick up your custom "no products" texture.

  1. Place your texture into the contents of the vendor
  2. Rename the texture to this: 7273cc74-2b6c-530f-293a-3af92422beae
  3. Reset/resync the vendor so that it re-reads the contents and picks up the new texture.

"No More Products" Texture


Similar to the "No Product" texture, this texture will only show if you're using a multi panel vendor with a group profile, and have "(V2.09 vendors only) Generate profile as 'pages' of" turned on without enough products to fill your panels.

This will allow YOUR customised "No More Products" texture to be used rather than the default CasperTech one.

You may need to reset the vendor (click the vendor, select "reset" from the popup) for it to pick up your custom "no products" texture.

  1. Place your texture into the contents of the vendor
  2. Rename the texture to this: a8b974af-fae5-ab18-3789-43f28edcc413
  3. Reset/resync the vendor so that it re-reads the contents and picks up the new texture.


"Initializing" Texture


This is not necessary, as it doesn't usually show for very long, but for consistency with the Offline and No Items textures, you can replace the Initializing texture as well.

  1. Place your texture into the contents of the vendor
  2. Rename the texture to this: 70fd1ef6-0877-c53a-4f34-45576f880d76

Texture (Button) Templates


Inside the vendor shipping crate is a box called "CUSTOMISATION GUIDE AND TOOLS". Inside THAT box is a box called "CasperVend2 Templates". Inside that box are templates for the following things:

  • Standard / Mesh CasperTech CasperVend vendors
  • Gatcha templates
  • Lucky Chair templates
  • Midnight Madness template
  • Redelivery Terminal template

Templates for the Transporter are NOT currently (as of the last major update) in the shipping crate, but ARE available upon request from either Casper Warden or Sphynx Soleil - simply inquire within Second Life.

TextureVend templates are inside the TextureVend vendor itself, rather than the general "customisation guide and tools" box.

Texture Repeat Issues


If you are having issues getting the textures to repeat properly and in the correct orientation...

  1. First, fix the textures so that they have the correct repeats and orientation
  2. THEN, hard reset (Edit > Reset scripts in selection) the script
  3. Allow debit permissions.

Done in that order, resetting the script will force it to pick up the new orientation as correct one, instead of remembering the old incorrect one.

If you reset the vendor for this situation and (1) you did NOT get a debit perms popup, and (2) the vendor came up normally, then you used the wrong reset option.

Do NOT use "reset" on the popup if you are trying to fix the texture - use edit mode, then find the menu option in your viewer menus for "reset scripts in selection".

Animated Textures

  • Not officially supported by CasperTech*

Ruthven Willenov has created a plug in for this on the Plug-Ins Page

Vendor Errors

Error Running Rule: Prim Texture


Clothing merchants and similar situations


Did you just take the MAPPING card out of a normal vendor and drop it in a normal box with a product picture already on it? (i.e., selling clothing)

If so, you need the MAPPING card from the HEADLESS vendor instead.

As long as the script came from a regular vendor (script is named just "CasperVend2"), that will be fine - it's the MAPPING notecard that makes a difference.

Customized vendor object from scratch


You may see one, all, or some combination of these errors:

rule #1 (PRIM_TEXTURE): arg #3 (texture repeat) is missing.
rule #2 (PRIM_TEXTURE): arg #3 (texture repeat) vector expected but string given.
rule #1 (PRIM_TEXTURE): arg #3 (texture repeat) vector expected but integer given.

Check every single prim in your vendor object. You quite likely have two or more with the same name (Usually it will be seen with "Object", but it depends on how you've named your prims.)

Simply change the prim names so that no two prims in the vendor object have the same names, rerun the mapping script, and everything should be happy.

Error Running Rule #2: Non-Integer Rule


If you have used the instructions for "__ROOT__,-1,<0.0,0.0,1.0,1.0>", the vendor WILL give you a "llSetPrimitiveParams error running rule #2: non-integer rule." message.

The vendor WILL still function despite this error.

This will be normal until Casper tracks down why that happens and fixes it. (He is aware of the problem.)

Stack Heap errors


A stack heap error is not very common, but when it does, it generally will be for one of these two reasons:

  1. Duplicate Prim Names:The customised vendor has more than one prim AND at least 2 prims have the exact same name. (This makes the script very confused)
  2. Too Much Data: You're using product names which are excessively long, especially on a vendor with 13 panels. (A single script only has so much memory....the longer the product names are - especially when you include the full store name as part of the product name - the more memory each product takes up.) For 13-panel vendors, this can happen with the default 13-panel that ships with the system as well as custom vendors.

Any vendor in either of these situations may simply appear - to customers - "frozen" and be completely non-responsive, rather than giving anyone an obvious stack heap message. You may not get the error if you have script error messages disabled, or if you are offline when the error happens.

Payment Stopped


Payment stopped: The price paid does not match any of the pay buttons set for this object

This occurs when a child prim of an object is right clicked and "paid", when the child prim contains - or used to contain - a vendor script or some other script which configures the pay buttons.

You must not link vendors together. CasperVend scripts must be in the ROOT PRIM only. However, even after you have removed the script from the child prim, you will still see the error, because the configuration is a property of the prim and not the script.

To fix this, drop the following script into the child prim of the vendor:

default
{
    state_entry()
    { 
        llSetPayPrice(0,[]); 
        llSay(0,"Pay configuration removed on prim");    
        llRemoveInventory(llGetScriptName()); 
    }
    money(key id, integer amount) 
    {
        
    }
}

On very rare occasions, if the viewer is giving the customer a different price than what you've set the pay buttons for, this error will also happen - but this will NOT happen with any sort of regularity, and other viewers which are reporting accurate pay button information will have no problem. See this JIRA ticket for details.

Vendor is Grey


If you have rezzed out your vendor and given it permissions but it turns grey, the common causes are:

  1. Mapping card - redo if necessary
  2. Profile vendor is set to has no products
  3. Vendor is missing the "Vendor_Offline" texture

Note: If scripts are off, OR the vendor has crashed, you will NOT get a debit window, any message, OR change in vendor textures. If you have muted yourself, you won't get a debit window or any message either, but you will see the textures change on a multi-panel vendor.

Technical Notes & Background

This section is for background information only!

About The EasyMod example Object


This is an example vendor set up just so that you can see the maximum possible buttons. Each prim in the vendor is labeled with the appropriate button name the script is looking for.

Included inside the EASYMOD vendor example are all the default button textures, as individual textures.

The "EasyMod" is NOT intended to actually be used AS a vendor - only as an illustrative example of the complete setup.

NOTE: The numbering on the prims of the EasyMod may not necessarily match the order of the mapping helper script panels. This is just an example layout.

About the Mapping Process


This is JUST AN OVERVIEW of the mapping script process, and is presented only for informational purposes! Do *NOT* use this as a guide to set up a MAPPING card!
Reset
This wipes any configuration you've done up to that point
Textures
There are 13 possible texture displays on a vendor, and this option walks you through selecting which display is which. If you're having trouble visualising the usual order of these buttons, rez out the "EasyMod" from the Customisation box and look at how the prims are named. (use Edit > Linked Parts if necessary).
You do not need to be in "edit" mode to do this step - being in edit mode means you have to right-click, THEN "touch" as opposed to just clicking the prim.
The script will ask you to tell it the faces of the display panels. So that you know ahead of time, it is looking for this information in the following order:
  1. Left panel six
  2. Left panel five
  3. Left panel four
  4. Left panel three
  5. Left panel two
  6. Left panel one
  7. Main texture panel
  8. Right panel 1
  9. Right panel 2
  10. Right panel 3
  11. Right panel 4
  12. Right panel 5
  13. Right panel 6
If you want to use all sides of a prim for one or more of those faces, then click "ALL SIDES" on the popup menu, BEFORE clicking the prim. It will give you another popup once it's processed the "ALL SIDES" selection and is ready for you to click the prim.
You WILL be having popup dialogues for each step. The one for the current step will always be on top - ignore the ones that are left up from earlier. It is NOT required to click "ok" or "ignoree" on the popups menus before proceeding to the next step but you can if you want to. (LSL doesn't allow self-closing of popup menus.)
Just click "skip" for the display panels you're not using. If you're using a simple one-prim, one-item vendor, then just use "skip" on everything BUT the "Main Texture Panel".
Buttons
This maps the clickable button areas from TOP LEFT to BOTTOM RIGHT, in the following order:
  1. Page Left
  2. Scroll Left
  3. Admin Button
  4. Search Button
  5. Help Button
  6. Demo Button
  7. Gift Button
  8. Scroll Right
  9. Page Right
  10. Rez
As with the texture panels above, just click "skip" on the options you're not using. (For example, not everyone uses the demo button.)
Yes, this can be used to customize buttons for a HoloVendor!
Finish
This does two things: (1) Sends the configuration to a code pasting site, and (2) gives you the link to the page it went to so you can copy it. Remember this link is valid for just one hour so if you get distracted and it expires, you'll have to do the configuration all over again.

Copy the configuration file from pastebin into a notecard and drop it in your vendor.

NOTE:
MAPPING notecards should have 37 lines for a normal vendor, and 38 lines for a holovendor. If you generated one that is longer or shorter than this, tell the mapping helper script to "reset" and go through the process again.

Delete the mapping helper script from the vendor once everything else is complete

Copy the MAPPING list from the pastebin site into a notecard and drop it in the vendor.

All done!

FAQ / Troubleshooting

Q. If I stretch / resize my vendors, will they still work?
A1. Yes, it doesn't matter what size the vendor is, as long as all the buttons map correctly.
A2. You can also change the shape, just remember to go through the instructions in the customization section to remap all the buttons and vendor image panels correctly.
Q. A vendor I'm setting up for a new profile has a quirk, each time I "touch" it, it tells me "(my vendor name): Touched" - and does not display the menu, just gives me that message. How do I fix this?
A. Look inside the vendor contents for a script named "New Script". The script that ships with the vendor will never be named this, so if there is a script named "New Script" it may safely be deleted. (You may have accidentally clicked "new script" - which creates a script that merely tells you the object was touched.)
Q. Can I set the vendors to "Phantom"?
A. Yes, and they will still work :)