====== Lucky Me! + Lucky chair system ====== 

Script version: 1.0\\
Last update: 28/08/2022\\

“Lucky Me! Plus” is a complete lucky chair system, including the elegant modern chair and a panel to show the ads of the proposed prize.\\
This software will be able to:
  * manage different items that will be randomly offered to your customer
  * show a different letter/number and check if the legacy name of the avatar sitting on it starts with the character selected
  * allows a wildcard, in which every letter/number will e accepted
  * saves the information of the winners into a database accessible via Manage Me!
  * available in 3 different colors
This is a fully operational tool that links Second Life™ with an external platform, accessible via your in-world name and a password that can be retrieved from the **Virtualty Office** using the **Manage Me! Password recovery terminal**([[http://maps.secondlife.com/secondlife/Falcata/70/154/26]])

==== Basic elements ===
The tool is made of two elements:\\
  * ''lucky_me_chair_notecard v1.0i5'' - The actual script that will make the chair work
  * ''configuration''  - The configuration notecard that you will need to fill according to your needs.

==== First rezzing ====
When you will rez the box with the script, you will see that there is a overtext telling you that the Terminal is disabled
{{ :virtualty:luckyme:screenshot_23.png?400 |}}
This is totally normal, because the configuration notecard is of course not valid for your situation.\\
Let's then look at the configuration notecard.

==== Configuration ====
The configuration notecard is made of four sections:
  * ''Timer'' - The number of seconds that the random letter will be active. 
  * ''Face''  - This section is not used in this version, but kept for back compatibility.
  * ''Group''  - If having as active the same group of the chair is needed to be able to win.
  * ''Objects'' - The list of object names and adverts uuids to offer to the customers.

{{ :virtualty:luckyme:screenshot_4.png?400 |}}
The reason why the box containing the scripts shows the ''disabled'' message is that inside the box there are not the items indicated in the notecard.
{{ :virtualty:luckyme:screenshot_27.png?400 |}}
You will then have to modify the notecard and insert inside the box the items that you have listed in the notecard.\\
If you will not do that, the chair will not activate.\\

You will also receive IMs from VirtualyPostmaster (the bot that we use for the IM communications) that there is a problem:
{{ :virtualty:luckyme:screenshot_22.png?400 |}}

==== Normal Operations ====
Once everything is ok, the notecard is fully complete and the items are inside the box, you can click on the chair to activate it 
{{ :virtualty:luckyme:screenshot_25.png?400 |}}
and then the script starts to work, showing the lucky letter and the adv of the items that can be won:
{{ :virtualty:luckyme:screenshot_28.png?400 |}}
When an avatar will sit on the box, the script will check if all the parameters to win the item are respected, and in case the object will be sent to the winner.\\
Otherwise there will be a message (instant message) sent to the customer informing them that they have the wrong inital letter.
{{ :virtualty:luckyme:screenshot_26.png?400 |}}

==== Web interface ====
Once logged in into Manage Me!, you will have ''Lucky me!'' in the the top menu
{{ :virtualty:luckyme:screenshot_18.png?400 |}}
If you will follow the ''Lucky me!'' link, you will reach the page that shows all the items won and a timestamp as well.
{{ :virtualty:luckyme:screenshot_19.png?400 |}}

==== Q&A ====
=== I configured everything but still I have the ''disabled'' message!!! Why?? ===
It is possible that there is an extra line in the configuration notecard. It should ''not'' happen, but sometime SL is being... difficult.
{{ :virtualty:luckyme:1.png?400 |}}
{{ :virtualty:luckyme:2.png?400 |}}
=== No, I checked, the notecard is ok!!! ===
Then reset the scripts please, and contact us, so we can better see where the problem is.