Paying Poseball Help

Date 2008/4/24 9:50:00 | Topic: Camp Stuff

Paying Poseball (formerly Custom Camper)
Complete Instructions & Help
! WARNING !
Do not use this to inflate traffic rating. More Info



General Use
Setup Instructions
About the Configuration Notecard
Customizing/Using your own Objects
Helpful Tips & FAQ's

NOTE: If you have more than 1 poseball unit linked together you may experience problems. If using more than one in same object leave the poseballs UNLINKED from the main object to avoid issues. More info at bottom at notecard.


_____General Use__________________________

Owner sets out and configures. Avatars sit and earn L$ from the object owner for their time and work.

Owner may Touch object at any time for an Owner-Only Menu to Turn On/Off, Reset, Unsit the current user (they will be paid for time earned,) and check for new product Updates.

To change the animations, simply drag your new ones into the Object and then delete or remove any old animations from the inventory. You may have up to 21 total.


_____Setup Instructions_____________________

Rez the object somewhere.

Open object in EDIT. Under the CONTENTS TAB open the notecard entitled "Configuration."

Change the settings in the notecard, (see below,) and SAVE. Close Edit.

The object should reset automatically, (You can also Touch and choose "Reset" from owner menu.)

IF USING PAY MODE: Once loaded you will see a drop-down dialog message saying the object wants to "Take Lindens from you? Click yes. This allows the script to pay the users what they earn.


_____About the Configuration Notecard_________

Below is more information about the settings found in the notecard within the object.

// BASIC SETTINGS //

How much to pay?
AmountPerInterval=2
**Amount in Linden Dollars to pay per the amount of minutes you set below.

for how many minutes?
IntervalMinutes=10
**Minutes Camper must stay to earn the amount above.

Most $L they can make before Un-Sat:
MaxDollarsPerSession=30
**After Camper earns this amount they will be unsat.

// CUSTOM SETTINGS //

Adjust these for where the user sits in relation to object.
SitTarget=<0,0,.1>
SitRotation=<0,0,0>
**These 2 advanced settings are very useful if using your own objects.
**SitTarget determines where the avatar is placed. The default is <0,0,1> which is 1 meter Above the center of the object. If your avatar is too tall and their legs stick into object you may try <0,0,1.5>, which is half a meter higher.
**SitRotation sets the direction facing of avatars. Default is <0,0,0> which is no rotation. If using own objects and avatar is rotated oddly, play with this setting. Here are valid examples: <0,0,-45> | <0,90,0> | <45,22,0> etc.

Name of your Object, what is your object?
ObjectName=Poseball
**This will be used in floating text, IM's, and the object name.

Set your Sit Text label here. (Default is 'Sit Here' in pie menu)
SitText=Pose

Turn key prim Invisible on Sit? (If using poseball style, put TRUE)
InvisibleOnSit=TRUE
**If TRUE this will make the Key Prim invisible when a user is sitting.

Display Floating Text above object? (FALSE for no text.)
ShowText=FALSE
**If no text shown, users check their earnings by Touching object.
**Set this FALSE for staff use so others will not know it pays.

The color of Floating Text when displayed.
FloatTextColor=<1.0, 1.0, 1.0>
**You can use the included Color Finder object to get a color vector.

// 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. -Help finding your Parcel Key.

Help prevent bot abuse with CAPTCHA verify.
Verification=TRUE
**When TRUE users must select a random word displayed in Floating Text from a list in a popup dialog box to start earning.

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.

If TRUE will Unsit avatars when they are Away or Busy.
DisallowAway=FALSE
DisallowBusy=FALSE
**If TRUE it will only check if user is Away or Busy once every interval.
**It cannot check when they first sit.

// SERVER SETTINGS //

If using the ASD Camper Server (sold separately,) please specify channel here. (leave 0 for no server use.)
ServerChannel=0
**If you own the Camper Server, it should have given you a channel number during setup. You may also Touch the server and select CHANNEL from owner menu to find it.


_____Customizing__________________________

• ADDING OR REPLACING ANIMATIONS
Open the Object in EDIT and go to the CONTENT tab. Drop in your animations and delete/remove any ones you do not want. You may have between 1 and 21 animations. (If only 1 animation inside object there will not be an animation dialog menu for users.) If no animations in object, default SL sit will be used.

• USING THE INCLUDED POSEBALL
The easist way to get started is to just set out the included poseball style on top of your objects. You should NOT link the poseballs to other objects if more than one will be used. If you do link ONE poseball to another object always be sure it is the Last Linked Prim (key prim.)

• USING YOUR OWN OBJECTS

1. Start by rezzing Paying Poseball.

2. Open the object and Copy the Contents to your Inventory, as you would a boxed item.

3. Create your object: Be certain that the last linked prim (key prim,) is the prim you want the user to Sit on. (In some cases this may be a poseball prim in your object.)

4. Transfer the scripts and animations from your Inventory to the new object.

5. Touch object and select 'Reset' to be certain it is ready.


_____Helpful Tips & FAQ's____________________

• If your object is not working:

-Check to be sure you have permission to run scripts on the land parcel and be sure the object is set to the right group if needed.

-Open object in EDIT and click on TOOLS at very top of screen, then choose "Reset Scripts in Selection."

• Deeded objects will not work correctly.

• If you have more than 1 poseball unit linked together you may experience problems including but not limited to timers being reset when more users sit down and it takes longer/less time for users to earn.

• To see invisible objects press CTRL+ALT+T to make them visible.


! WARNING !
Do not use this to inflate traffic rating. More Info




/// CHANGELOG ///

AUGUST 2009 - ver 3.6 UPDATE

• No Pay mode added.

• Show/Hide Floating Text added.

• Access List added.

• Custom Camper renamed to "Paying Poseball." All purchasers will still receive updates for product, but under the new name from now on.


DECEMBER 2008 - ver 3.5 UPDATE

• Converted to MONO. Runs smoother.

• New Maximum Age option will not let older avatars camp. Set anywhere between 1 and 24 months. Set 0 for none.

• New and Improved Anti-Bot Verification now uses Floating Text and 3 times as many shuffled words to select from. Users will need to read the dropdown dialog menu and also see the Floating Text on the object to start earning.

• Objects can now be renamed and now include version number in object name.

• Animations Permission bug.

• Touch Start bug.


AUGUST 2008 - ver 3.0 UPDATE

• Profile Picks Support! When enabled Campers must have Place in their Profile Picks to earn!

• When Picks mode on, users can Touch for Help on getting parcel into picks and to check their Picks & see if they are eligible.

• When Group mode on, can now say Group Join URL in chat when Touched -or- use a custom message to Toucher for how to Join Group if not Open Enrollment.

• Anti Bot Verification Improved and now is a form of CAPTCHA that requires user to select a word from a list to start earning or they will be unsat. Words in list are sorted randomly to confuse bots but are simple for real people to understand.

• Minimum Age option allows you to set in Months how old campers must be at least.

• Disallow Campers to be AWAY option.

• Disallow Campers to be BUSY option.

• Will ask owner for confirmation before Reseting after an Inventory Change.

• Shows progress amount in floating text while loading.

• Various bugfixes that reduce lag.

• All Camp Products are also now ready to work with the new ASD Camper Server, sold separately.




This article comes from Alicia Stella Design - Best Tip Jars in Second Life
http://www.aliciastella.com

The URL for this story is:
http://www.aliciastella.com/modules/news/article.php?storyid=37