ASD RAFFLE SYSTEMS - Version 1.0
ONLY HAVE 1 MAIN UNIT REZZED PER RAFFLE ID. Only the most recently rezzed Main object will work correctly.
(Rez 1 Main object & unlimited 'Secondary' objects per contest.)
PRIZE OBJECT NAMES MUST NOT EXCEED 24 CHARACTERS. Details & Workaround
These Instructions are separated into 7 sections:
● 1. The License Box (Do this First)
● 2. Raffle Setup Instructions
● 3. About the Settings Notecard
● 4. Touch Menu Features
● 5. Web Tools Info
● 6. Upgrade Info
● 7. FAQ and Help
Related Help Topics:
● Raffle Object Shells
● Changelog
********************************************
THE LICENSE BOX - DO THIS FIRST
Before setting up a Raffle you will first need to get a Raffle ID setup.
Rez your included "License Box" Object. (Make sure you are not set Busy.)
It will automatically create your database and issue you an ID Number.
After finished it will Die and poof. You only get one ID number per License Box. (More may be purchased.)
If there is a problem creating the database the License Box will display information in floating text and issue a warning message. Follow whatever instructions it says.
********************************************
EASY SET-UP INSTRUCTIONS
● 1. Rez Raffle (MAIN) object and select Raffle ID to use from dialog Menu. (Reset Scripts if no menu.)
● 2. Fill out the Settings notecard inside object. You must select "Load Note" from Reset/Load menu after saving or the settings will not be saved. ('Reset All' button does not load note and it does not load on rez either.)
● 3. Touch the Raffle (MAIN) object for settings menus to setup your contest (info below.)
● 4. Select "Web Tools" button from touch menu to manage your Raffle(s) on the internet. (If you are not signed up on our site yet this button will help you get registered too.)
● 5. Optional: Set up Raffle (Secondary) objects anywhere in Second Life! Users can enter your raffle from these objects from anywhere you place them. (You cannot change raffle settings from Secondary objects but avatars can enter a contest from them.)
********************************************
ABOUT THE RAFFLE SETTINGS NOTECARD
Edit the Raffle Settings note inside the raffle object and select "Load Note" button from Reset/Load menu after saving.
-You can have up to 18 Managers by adding names to the manager list in the note. Managers have most of the abilities for the Raffle MAIN object as owners do in-world. Managers cannot use Web Tools or Secondary objects.
-Set your Contest name! Used everywhere and visible to all this text cannot exceed 128 characters.
-You can give a Nickname for this Raffle. Nicknames are handy for telling apart multiple server ID's on the Web Tools site if you have more than one.
-You can set your owner IM's on/off. This will tell you who won the contest and the prize they received after raffle ended.
-Set a password if you like for extra security. You never need to use this password, it's just for the scripts' use.
-Also you can specify an email address to receive a full report after contest completion including winner info, prize info, and list of all entries.
-If you wish to create Restrictions for your contest you can set your Security features in the Settings note as well.
// SECURITY SETTINGS //
Put TRUE for group members only (same as object.)
GroupUse=FALSE
**A great way to increase your Group Memberships!
Custom Message when Touched in Group Mode. (If FALSE a URL to Join your Group will be used instead.)
ShowCustomMessage=FALSE
CustomJoinText=IM a staff member to be added to group.
**You would only need to use this if your Group is NOT Open Enrollment. That way you can explain by which means people may join your group.
Put TRUE for only avatars that have your place in their profile picks.
PicksUse=FALSE
**The more avatars that have your place in their Picks the higher your place's ranking will be in the SL Search.
**Note that it can take up to 24-48 hours for a New Pick to appear in the Search, so your users will need to wait the first time they add your place.
If PicksUse is True you must specify the parcel key.
ParcelKey=00000000-0000-0000-0000-000000000000
**To find your parcel key: Search ALL tab in Second Life Search for your place. Scroll down to the bottom of your place's page, (past the 'Objects Found Here' section.) At the bottom you will see 'Link to this Page' and a url. The last part of that url is your parcel key. How to find Parcel Key.
Help prevent bot abuse with CAPTCHA verify.
Verification=TRUE
**When TRUE users must select a random word from a list in a popup dialog box to enter.
Minimum age in Months avatar must be to use. (Leave 0 for no minimum, 12 is max.)
MinAge=0
**This feature is good if you are using Profile Picks feature. Young avatars' Picks do not count in SL Search.
Avatars older than this many months cannot use. (Leave 0 for no maximum, 24 is max.)
MaxAge=0
Set TRUE if avatar must have Pay Info on File/Used.
PayInfoRequired=FALSE
**Pay Info means that the user has been or is now a SL Premium member.
********************************************
TOUCH MENU FEATURES
Features can be used by Managers and Owners unless noted otherwise.
____________________________________________
COMMANDS
Here owners and managers can manually: Draw a winner (entries will also be cleared after winner found,) and also just Clear all entries so far. Both of these options cannot be undone.
____________________________________________
RAFFLE SETUP
This is where you set your most important settings.
------ RAFFLE MODE -----------------
Select your Raffle Mode from the selections below.
● MANUAL - Owner or Managers must Draw Winner manually from COMMANDS menu, (see above.)
● DAILY - You set the drawing time. This is in 24 hour time format. Midnight is 00:00:00 and 11PM is 23:00:00. You are only allowed to select in hourly increments.
● WEEKLY - Select the day of the week and the drawing time.
● MONTHLY - Select the day of the month and the drawing time.
All times are Pacific Standard/Daylight Time US (SL Time.)
------ SET PRIZE -----------------
You can select from either money or an object prize.
● MONEY - You select a set amount of Lindens that will be paid to winner. If you select this mode you must Grant Pay Permissions. This means a dialog box will ask if this object can "Take Lindens From You?" Select 'Grant' so that the winner can be paid when the time comes.
● PRIZE - You may have up to 18 Objects in this raffle object to use as prizes. Object names must be less than 25 characters and they must be at least Transferable. You can select an object by name or set to RANDOM to choose randomly at drawing time.
------ RECURRING -----------------
● RECUR YES - Your contest will be repeated automatically after each drawing. Daily will repeat at same time every day. Weekly will recur on that weekday each week. Monthly will repeat each month on that day (unless that month is without that day, like 31.) Manual will not shut off after you Draw a Winner.
● RECUR NO - Raffle will set itself to Not Running after a winner is drawn.
------ IM AFTER -----------------
This feature will send an IM to all entrants after the contest has ended. They will be informed of the winner and prize won as well as information and SLURL for new contest (if set to Recur.)
Great feature to keep people returning for recurring contest!
____________________________________________
SECURITY
Displays current security settings.
Inside the object is a notecard named "*Settings" and you can set your Security settings there, (more info above.)
____________________________________________
OBJ OPTIONS
These settings are only for this object and are not stored in web database. Resetting object will restore defaults for these settings.
● SHOW/HIDE TEXT - Will display or hide floating text.
● TEXT COLOR - Select your floating text color from menus.
● ANNOUNCE - You can select from 4 settings.
- None: No announcements made, not even winner.
- Minimum: Announces when Winner is found.
- Medium: Announce winner and entries as they enter.
- Maximum: All above, plus once an hour to promote.
● SHOUT ON/OFF - Should Announcements be shouted or said in chat?
____________________________________________
INFO STATS
Select "Info Stats" from Menu to see how many people have entered the contest so far.
____________________________________________
CONTEST ON/OFF
This will set your contest to RUNNING or NOT RUNNING. Entries are not permitted while Not Running.
NOTE: Secondary objects should be Reset from menu or it may take several hours before they update themselves after you turn raffle on/off from Main object.
____________________________________________
RESET/LOAD ( Object Owner Only )
If you make any changes to the notecard inside the object you must use this menu to load it or your changes will not take effect. Settings notecard does NOT load on rez or when scripts are Reset.
● LOAD LISTS - Loads the Settings notecard in object.
● RESET ALL - Good for if raffle is acting strange or to load a different Raffle ID. This is the same as re-rezzing. Most settings will be loaded from web database and will not need to be set again. (Note: if you choose this you will need to load the notecard once again from menu after.)
____________________________________________
UPDATES ( Object Owner Only )
Checks to see if a new Raffle version is available and how to get it if so.
********************************************
WEB TOOLS INFORMATION
You can use Web Tools to manage your Raffle(s), view entries, and more.
In the Touch Menu select 'Web Tools.'
If you have not already registered you will be taken to the signup page. After registered the "Web Tools" button in Touch Menu will take you to the Control Panel online, (you may need to login first.)
NOTE: You must register with your site username exactly the same as your avatar name in Second Life, first and last with a space in between. You will not be able to use Web Tools if your name does not match exactly. (Contact Alicia Stella for help changing username if needed.)
********************************************
UPGRADE INFORMATION
Upgrade your existing Raffle ID's to get more entries allowed! You need only pay the difference in price from what you already paid!
You can upgrade your Raffle ID's in-world using the included 'Upgrade Box'. Just rez and follow instructions. You will need to Grant Pay Permissions to use it but it will not charge you money until you actually Pay the object.
ASD Raffle Systems are available in 4 varieties. The only difference is the total number of entries allowed per contest. Your Raffle ID's never expire and even if you reach your entry maximum it resets after the contest restarts.
● BRONZE - Up to 100 entries at any given time.
● SILVER - Up to 250 entries at any given time.
● GOLD - Up to 1000 entries at any given time.
● PLATINUM - Up to 999,999 entries at any given time.
The longer your contests last may help you decide on what model is best for you. A daily contest may never exceed 100 entries, but a weekly raffle may.
********************************************
FREQUENTLY ASKED QUESTIONS / HELP
● Q: Is it alright if I use a Raffle Main object in one sim for awhile but then move it to another sim?
A: Yes, as long as it's never 2 sims at same time.
● Q: Is there a limit to how many Raffle ID's an avatar can purchase?
A: If you own 21 or less ID's it will be okay. If you do happen to own 22 or more you will need to IM Alicia Stella for new versions of the Raffle objects. The current version can only handle up to 21 but can easily be updated for you, just ask.
● Q: Why did my Raffle Object (Main) just suddenly Shut Down?
A: If you rez another Main Object and set it to the same Raffle ID already in use the older object will Shut Down and IM the owner. (This will happen between 3 and 6 hours when the object tries to check into the web database.)
● Q: It says my Web Tools account is not "Verified." What's that all about?
A: You just need to select the "Web Tools" button from the in-world object's Touch Menu. Your account should then be verified and your option to manage Raffle(s) will appear on the site. (If even after this it still says unverified or does not show you as owning a Raffle ID on the site please contact Alicia Stella for assistance.)
● Q: Why can't I get Web Tools to work? I can login but not access my products.
A: Did you create your Web Tools' Username *exactly* as your name in Second Life? It must be your First and Last name with a space in between. Example: "Alicia Stella" If you need to change your username contact Alicia Stella. Do not create a new account.
● Q: My Prize Object is NO MOD so I cannot change the name to make it 24 or less characters! What can I do?
A: Take all prize objects out of Raffle Object and then go back to the Prize menu and select "RANDOM." Now add in your prize object(s), 1 to 18 max. If you only have one it will always give that one. This way they can be more than 24 characters now!
All times are Pacific Standard/Daylight Time US (SL Time.)
