Quertie's Uber Tip Jar - Major Features
- The tip system displays a unique dialog box for each tip that is received. This is ideal for DJs and Live Performers who thank tippers between songs. Many other tip systems only have one dialog box, which results in previous tips being lost.
- Messages are created by substituting specific types of information into the message before display it.
- After the substitutions take place, there several different ways in which the tip jar can report tip information. In dialog boxes to the tipjar owner, local chat, owner only, IMs to tippers, and so on.
Customized messages for:
- Dialog boxes you see when you get a tip (and get a separate dialog box for each tip, so that you never miss a tip!)
- Display text that appears above the tip jar after a tip is received
- as well as the display text that appears before the first tip is received
- Sending the tipper an instant message
- Local chat messages (say or shout)
Particles?
- Send the tip jar's textures in random order (as particles) to the tipper when a tip is received
- Show randomized textures as particles when the tip jar receives a tip.
- Don't want particles? Don't put include textures in the tip jar.
- Don't want particles? Don't put include textures in the tip jar.
Tip Jar Options:
- Works with a notecard, see the details below.
- When tippers click the tip jar, the default is to "pay" the tip jar.
- Note, while the tip jar is initializing, the tip jar is in touch mode, with quick pay turned off.
- If you right-click and 'touch' the tip jar, you get:
- A dialog box with the last tipper details in it.
- In local chat, you get a list of all tippers in the order they last paid the tip jar.
- The list contains their display name, number of tips, and total of all their tips.
- Set the pay amounts (default and each of the 4 default tip amounts).
Works by session:
- When you rez a copy from inventory -or- change the contents (such as modifying the note card or changing the textures) the script resets itself, re-reads the parameters.
- After a tip jar resets, it sends particles to you, making it easy to test new configurations.
"!Parameters" Configuration Notecard
To set up the tip jar script, you specify a series of parameters inside of a note card with the name "!Parameters" in any object you want. Parameters have a "NAME=VALUE" format, with each of the names described below.
If you are working with particles, it often requires a bit of tweaking to get the parameters to work, so after the parameters are read, a test is made to send particles to you to make sure they do what you want. It's just faster than paying the object some money. Furthermore, you can open the notecard, and whenever you make changes, the system will reset the script and reload the notecard, making tweaking even easier!
Note: In the example below (provided), the lines that appear blank, are blank lines in the message you are displaying.
If you are working with particles, it often requires a bit of tweaking to get the parameters to work, so after the parameters are read, a test is made to send particles to you to make sure they do what you want. It's just faster than paying the object some money. Furthermore, you can open the notecard, and whenever you make changes, the system will reset the script and reload the notecard, making tweaking even easier!
Note: In the example below (provided), the lines that appear blank, are blank lines in the message you are displaying.
SPIN=0.4
HEIGHT=0.6
SIZE=<0.5,0.5,0>
INITIALIZE=DJ {OWNER}'s Tip Jar
INITIALIZE=
INITIALIZE=No tips so far.
INITIALIZE=
INITIALIZE=
INITIALIZE=
INITIALIZE=
DIALOG=Tip #{PAYMENTS}; Total so far: L${TOTAL}
DIALOG=
DIALOG=TIP DETAILS:
DIALOG= L${TIP} ... ({COUNT} tips for L${SUM})
DIALOG= {DISPLAY}
DIALOG= {URI}
CHAT=DJ {OWNER} thanks {DISPLAY} for that awesome tip!
IM=Thank you for your wonderful tip of L${TIP}!
TIPJAR=Last tip was L${TIP}
TIPJAR=Thanks {DISPLAY}
TIPJAR=
TIPJAR=---<( {PAYMENTS} lovely tips given! )>---
TIPJAR=
TIPJAR=
TIPJAR=
TIPJAR=
COLOR=<1,1,0>
DEFAULT=250
PAY1=69
PAY2=169
PAY3=269
PAY4=369
TEXT and MESSAGE Parameters
Text/Message parameters support substitution variables, which are shown below. These variables change a string name like {DISPLAY} and {TIP} into the display name and tip the jar received, respectively. So if your parameter text line was:
CHAT=Thank you {DISPLAY} for your L${TIP} tip!
If Quertie paid you $100, the chat command sent that everybody sees becomes "Thank you Quertie for your L$100 tip!".
You can specify text parameters several times, to create multiple lines, and even have blank lines. Blank lines are useful for dialog boxes and for tip jar floating text. They are too much for IM and CHAT messages, however, we still allow them.
Substitution variables must be in UPPER CASE and are described below:
CHAT=Thank you {DISPLAY} for your L${TIP} tip!
If Quertie paid you $100, the chat command sent that everybody sees becomes "Thank you Quertie for your L$100 tip!".
You can specify text parameters several times, to create multiple lines, and even have blank lines. Blank lines are useful for dialog boxes and for tip jar floating text. They are too much for IM and CHAT messages, however, we still allow them.
Substitution variables must be in UPPER CASE and are described below:
- {OWNER} - Is the display name of the tip jar owner (YOU!)
- {DISPLAY} - Is the display name of the last tipper.
- {URI} - Is the link to the last tipper's profile, it should only be used in dialog boxes.
- {TIP} - Is the amount of the last tip received.
- {COUNT} - Is the number of times the last tipper has paid your tip jar for that session.
- {SUM} - Is the total amount of all tips for the last tipper.
- {HIGH} - Is the highest tip amount (displays nothing if no tip has been received)
- {HIGHNAME} - Is the display name of the highest tipper
- {AVERAGE} - Average tip for all tippers (nearest full number).
- {PAYMENTS} - Is the total number of tips received.
- {TOTAL} - Is the total of all tips received.
INITIALIZE
DIALOG
CHAT
IM
TIPJAR
- Allows you to specify the text that appears on top of the tip jar when the tip jar is first rezzed.
- Example:
- INITIALIZE=DJ {OWNER}'s Tip Jar
- INITIALIZE=
- INITIALIZE=No tips so far.
- INITIALIZE=DJ {OWNER}'s Tip Jar
DIALOG
- Specifies the text that appears in a dialog box only you receive.
- A separate dialog box is shown for each tip, ensuring you don't miss tips, especially if you are distracted by other matters.
- Note: Using the template below, Firestorm viewer can select-and-copy the display name from the dialog box for a more personalized message to tippers.
- Example:
- DIALOG=Tip #{PAYMENTS}; Total: L${TOTAL}; Average L${AVERAGE}
- DIALOG=
- DIALOG=PAYMENT DETAILS:
- DIALOG= L${TIP} ... ({COUNT} tips for L${SUM})
- DIALOG= {DISPLAY}
- DIALOG= {URI}
- DIALOG=Tip #{PAYMENTS}; Total: L${TOTAL}; Average L${AVERAGE}
CHAT
- Specifies the line text that appears in local chat after a tip is received.
- Note: While multiple lines can be sent, you should only use one line.
- Example:
- CHAT=DJ {OWNER} thanks {DISPLAY} for that awesome tip!
- CHAT=DJ {OWNER} thanks {DISPLAY} for that awesome tip!
IM
- Same as CHAT but sends a IM to the person who tipped you.
- Note: While multiple lines can be sent, you should only use one line.
- Example:
- IM=Thank you for your wonderful tip of L${TIP}!
- IM=Thank you for your wonderful tip of L${TIP}!
TIPJAR
- Sets the floating text above the tip jar after a tip is received.
- Note: Depending on the object you use as your tip jar, you might need multiple blanklines after this text to space it right.
- Example:
- TIPJAR=Last tip was L${TIP}
- TIPJAR=Thanks {DISPLAY}
- TIPJAR=Best L${HIGH} from {HIGHNAME}
- TIPJAR=
- TIPJAR=---<( {PAYMENTS} lovely tips given! )>---
- TIPJAR=Last tip was L${TIP}
APPEARANCE Parameters
SPIN
COLOR
- Sets the spin of the tip jar.
- Note: if you see the tip jar stop spinning, it means somebody is paying the tip jar.
- Spin is always horizontal
- Recommended value is 0.25 to 0.50
- Default: SPIN=0
- Example:
- SPIN=0.40
- SPIN=0.40
COLOR
- Allows you to set the color of the tip jar's floating text.
- Default: COLOR=<1,1,0> (Yellow)
- Note: If it cannot read the style, the color will be black.
- Example colors and more info: http://wiki.secondlife.com/wiki/Category:LSL_Color
- Example (Set to Green):
- COLOR=<0,1,0>
- COLOR=<0,1,0>
PAYMENT Parameters
DEFAULT
PAY1, PAY2, PAY3, PAY4
PAY2=-1
PAY3=-1
PAY4=-1
PAY2=169
PAY3=269
PAY4=369
- Allows you to set the default tip amount, which the payee can override to anything they want.
- Specifying any value less than 0, causes the box to disappear.
- Default:
- DEFAULT=100
- DEFAULT=100
- Example:
- DEFAULT=99
- DEFAULT=99
PAY1, PAY2, PAY3, PAY4
- Allows you to specify a button with a default tip amount.
- Specifying a value less than zero causes that button to not appear.
- Defaults:
PAY2=-1
PAY3=-1
PAY4=-1
- Example:
PAY2=169
PAY3=269
PAY4=369
PARTICLE EMITTER Parameters
When textures are in the tip jar, the system sends particles from the tip jar to the tipper, by default (though you can change this behaviour through TARGET (see below)). HEIGHT, SPEED, BURST, COUNT, DURATION, TIME, SIZE, RANDOM and TARGET all affect how particles are emitted. If you don't want particles, don't put textures in the tip jar.
HEIGHT
SPEED
BURST
COUNT
DURATION
TIME
SIZE
RANDOM
TARGET
HEIGHT
- HEIGHT controls the acceleration (up) in which particles are sent, this so that particles go over guests to the tipper rather than thru them.
- Height set to 0 turns this feature off.
- If "TARGET=" (no target) it's recommended that HEIGHT be set to 0.
- 0.75 to 1.5 is a good range, but is adversely affected by TIME (see below).
- Default: HEIGHT=1
- Example:
- HEIGHT=1.5
- HEIGHT=1.5
SPEED
- SPEED how fast the particles are going when they are sent from the tip jar, it's a random number from 0 to the SPEED value.
- Default: SPEED=0
- Example:
- SPEED=2
BURST
- BURST controls how frequently particles are sent from the tip jar.
- Default: BURST=0.5
- Example:
- BURST=0.25
- BURST=0.25
COUNT
- COUNT controls how may particles are emitted from the tip jar, each time there is burst of particles
- Default: COUNT=1
- Example:
- COUNT=5
DURATION
- DURATION controls how long particles are emitted from the tip jar.
- Default: DURATION=5
- Example:
- DURATION=1
- DURATION=1
TIME
- TIME controls how long it takes for the particles are alive and travel to the TARGET.
- Note: Smaller/Larger Time values will drastically effect how HEIGHT works
- Default: TIME=8
- Example:
- TIME=4
- TIME=4
SIZE
- SIZE controls how big the particles are.
- Default: SIZE=<1,1,0>
- Example:
- SIZE=<0.5,0.5,0>
- SIZE=<0.5,0.5,0>
RANDOM
- If RANDOM=TRUE, create a random bright color of the texture before sending it.
- A bright color is determined by setting randomly setting one of the color values to 1 and the other color values to 0 to 0.5
- Random colors work best on textures that are white and transparent.
- Default: RANDOM=FALSE
- Example:
- RANDOM=TRUE
- RANDOM=TRUE
TARGET
- Describes where the particles flow away when they leave the tip jar.
- Default: TARGET=TIPPER
- There are five options:
- TARGET=TIPPER - destination is the tipper
- TARGET=JAR - particles stream out from tip jar but then return to it
- TARGET= - particles stream out from tip jar but don't go any where
- TARGET=KEY - This the key of the avatar or object that receives the particles.
- TARGET=OWNER - destination is the owner of the tip jar script
- TARGET=TIPPER - destination is the tipper