CasperVend 2/Gacha

From CasperTech Wiki
Jump to navigation Jump to search

About the Gatcha

THIS IS AN EXPANSION PACK FOR CASPERVEND. IT REQUIRES A FUNCTIONING CASPERVEND SYSTEM. If you don't have one, you can get our free version - search for CasperVend on the SL Marketplace, or teleport to the CasperTech store inworld.

Terminology

TICKETS:

"Tickets" in this case is simply a way of saying "the chance to win". This controls the rarity of the prize:
  • Higher number of tickets = more common (easier/more chances to win)
  • Lower number of tickets = Rarer (harder/less chances to win)
Number of tickets does not have to exactly equal 100. You can set one prize with a ticket count of 500, and another with a ticket count of 10.


PRICE POINTS:

The price points are the 4 different pre-populated payment amounts in the "pay" popup that people can click to pay gatcha machine. These are configured on the gatcha's configuration page. There are a maximum of FOUR price points because the LSL function that controls paying a vendor does not support more than 4 pre-populated "pay" buttons.

Setting Up Your Gatcha

1) Rez your Gatcha! machine.
2) Click anywhere on the Gatcha! machine for the touch menu
3) Take the "Admin" option and follow the link to the website. Log in if necessary.
4) Once on the website, you will be at the Gatcha! machine configuration page. This will look different from the usual vendor configuration page!
5) To add a price point, click "Edit" on the boldface "Price Point" line.
You will get a popup window to enter the price. If you don't get the popup, make sure javascript is on.
6) Once you've set a price point, add prizes with the "Add another prize" link below the boldface price point line.
7) You will get a popup window with a pulldown to select the prizes you want to include at this price point. It will also ask you for the number of tickets for each prize.
8) If you want to add additional price point(s) use the "Add another price point" link, and repeat the prize adding process described in step 7.
The system will let you have a maximum of FOUR price points. This is to match the limited number of pay buttons on the inworld "Pay" popup. It is not possible within LSL to script more than 4 pay buttons.
9) That's it! Your Gatcha is now ready to use!

Where do I put my items?

You put your gatcha items in the dropbox, and set up your product listings, the same as you would with products for the normal vendors.

What Permissions?

Most people fill a gacha with items that are no-copy/transfer to the buyer, but this is not mandatory in order for the gacha to work.

Items may be copy/no-transfer to the buyer, just as easily as no-copy/transfer.

Just remember that YOU need to be able to transfer the items, regardless of what perms the next owner has.

Customising Your Gatcha

You may take the Gatcha script and put it in a prim of your choosing, instead of using the Gatcha machine it ships in.

You do not need to do any special mapping notecard - just copy the script into your preferred object - all configuration and use is via touch/click menu options or by paying the Gatcha.

About the Touch (Popup) Menu

Clicking anywhere on the Gatcha will get a touch menu. The touch menu will give these options to the customer:

Prizes
Takes customer to webpage showing pictures of all prizes that are configured for that particular Gatcha! machine.
Redeliver
Allows redelivery of COPIABLE items (that you have marked as "copy" in the product listing, and that you have not restricted multiple copies.)
If you have the price point set to L$0, the customer will also see this additional option:
Deliver
Delivers a random prize out of the list for the L$0 price point. If you have set ALL price point(s) to a number greater than L$0 then you (and your customers) will no longer see the "Deliver" button.


In addition, as the system owner, you will see these additional options:

Admin
Takes you to that Gatcha! machine's configuration page.
Reset
Soft-resets the Gatcha machine (You won't get a yellow debit popup.)
Delete
Deletes this Gatcha! machine. Be certain you absolutely want to delete the machine - this is NOT reversible!

About the Configuration Page Options

On the configuration page, you will see the following options:
Change the vendor name
Lets you change the object name inworld from the default.
Change the display name
This is what shows in your vendor list on the site - not inworld. This helps if you want to search your vendors by specific keywords.
Change the description
Some people choose to put notations in here with the price point(s) so customers can see them if they hover the mouse over it.
You also have a series of checkbox options:
Set the vendor offline
This prevents purchases - useful if you wish to tinker with the setup or randomness of specific prizes.
Restrict the vendor to ONLY group members
The Gatcha! machine has to be set to, or rezzed under, the appropriate group in order for this to work.
Disable "prizes" button on touch menu
This prevents people from seeing the page with pictures of the Gatcha! prizes, for those people who want to keep the prizes a complete mystery.
Below that you will see clickable links for:
Add another price point
Lets you add more than one price point
Edit next to the boldface Price Point
Lets you edit an existing price point
Add another prize to this price point
Lets you add the Gatcha prizes to that specific price point.

Advanced Configuration Tips

You may disable the prize viewing page by marking the tickbox for "Disable 'Prizes' button on touch menu"
You can disable redeliveries for a particular prize over on the individual product's product listing - use the "Limits" line.
("No Copy" items have redelivery disabled by default.)

FAQ / Troubleshooting

Q. How many prizes can I put in the gatcha?
A. The number of prizes you can have in a gatcha is unlimited.
Q. Are copiable prizes won in a Gatcha usually available through the standard redelivery terminal or do I need a special one?
A. There is no Gatcha-specific redelivery terminal - all redeliveries happen via the regular redelivery terminal.
Q. Do I need to set up each Gatcha! machine separately, or can I copy the one I already just set up?
A. You can just "take a copy" and then rez out as many new copies as you like and they'll have the same set up as the original.
Q. I tried adding (one or more) variants to the gacha prize list, but they're not showing up! Help!
A. Double-check the product listings, make sure the listing for the variant is actually there. If it doesn't save properly (such as navigating away before clicking "save" on the product listing) then it won't show to be picked on the Gacha configuration page.