Bunny Boy

Furniture Linked Tip Jars

Furniture linked tip jars make logging in and out easy. Mainly envisioned for stripper poles (where only one would be sat on the furniture) but can work with other furniture with multiple sitters.

---

Rez the tip jar

Once the tip jar has been rezzed, rez the furniture (if not already rezzed). Right click on the furniture and select edit. On the edit window, go to the contents tab. When all the contents have loaded (may take a while depending on the furniture and number of animations) place the furniture script from your tip jar folder into the furniture contents.

Now right click on the tip jar and choose edit. On the editor window go to the contents tab. Open the config notecard.

With the config notecard open you can configure how you want the tip jar to act. We will go through each item.

Server

The Server Number is for if you wish to use the tip display board that came with your system. If you will be using multiple servers, set the number here. This is only necessary if you will be using multiple servers in a single region. (multiple servers, not multiple display boards. You can rez as many display boards as you want, but only need one server for them. You only need multiple servers if you have multiple parcels in a region and want each one to keep track of only it’s tips) Make sure tip jars, server and display boards all have the same server number.

Price

This is the price that is displayed in the editable box when a person goes to pay the tip jar. This can be set to any integer. Default value is 100.

Pay Buttons

This is the amounts of the buttons in the pay window when a person goes to pay the tip jar. This can be set to any four integer values. There must be four values separated by a comma.

Default Texture

In this setting put the default texture you want to display on the tip jars when they are not in use. For example, your logo. Put the UUID of the texture on this line. Do not put the texture name, it must be the UUID. To get the UUID of the texture, in your inventory, right click on the texture and select “Copy Asset UUID”. You must have full permissions on the texture to get the UUID. If you don’t want to display your own image, leave the 0 on this line and the default will be used instead.

Location

Here, put the name of the location. This can be your club name or parcel name. This setting is where the tip jar will get it’s name. For instance, if set to Bunny Boy, the tip jar name when not in use is “Bunny Boy Tip Jar” and when in use it is “Worker Name’s Tip Jar at Bunny Boy” So change this setting to your location’s name so it will be your location’s name that is displayed.

Idle Text

This is the hover text displayed above the tip jar when it is not in use. Default is “Sit to Log In” but you can set it to anything. If you want to disable the hover text when not in use, set this to 0 and there will be no text above the tip jar when not in use.

Thank You Text

This is the text that is said in local chat when someone tips the tip jar. You can set it to anything. Use $TIPPER$ in place of the tipper name in the text and the name of the tipper will be inserted there when tipped.

Display Last Tip

On the tip jar hover text, when tipped, the hover text displays the last tip amount. If you don’t want to display this amount, change this to NO and that line will not be displayed at all.

Display Last Tipper

On the tip jar hover text, when tipped, the hover text displays the name of the last tipper. If you don’t want to display this name, change this to NO. If you have already set Display Last Tip to NO then this won’t display either.

Worker Tip Percentage

This is the percentage you want to give to the worker (the person logged into the tip jar) when it is tipped. This can be any integer (whole number, no decimals). Caution: Do not set this number too low. If at any time the tip jar calculates that it will be giving the worker L$0 it will give the entire tip to the worker thinking that the tip is too low. You can not give the worker nothing. Default is 90.

Allow AFK

Do you want to allow tip jar users to go AFK while logged into the tip jars? If you are an AFK location, set to YES and the tip jars will not check if the user is AFK. If you want only active persons to use your tip jars, set to NO and the tip jar will check if the user is active and if they go AFK it will log them off. The tip jar checks local chat activity (it does not check what is said, only if the user is saying anything) and if they go silent for a long time will give a warning popup. The user can then click OK on the popup or say something in local chat to reset the system. If a user gets logged out for being AFK they will also be stood up from the furniture they are sitting on.

Use Particles

When the tip jar is tipped the tip jar can explode some hearts. This lasts only a few seconds. If you do not want the tip jar to do this, set to NO.

Group Only

You can set the tip jar to only allow users that have your group tag on to log into the tip jar. If you set this to YES, make sure the tip jar is in the same group as the users.

Reserved

Want only one person to be able to log into this tip jar? Put their UUID here. You can get their UUID from their user profile. This setting will not stop the owner of the tip jar or any managers listed in the tip jar from logging in.

Managers

You can designate up to 9 managers for the tip jar. Managers can log users out of the tip jar and can log into the tip jar even if it is reserved. Put the manager(s) UUID on the lines. If you don’t want a manager, leave 0 on that line.

---

After you have edited the config notecard, save it. The tip jar will reset. At this time, if you will be rezzing multiple copies of this tip jar, right click the tip jar and select take copy.

Link the tip jar to the furniture

Now that the config notecard is done we can link the tip jar to the furniture. To start, click the tip jar. You will receive a private message in chat telling you the linking process has started. When you get this message, click the furniture item you wish to link to the tip jar. You will get a pop-up from the tip jar giving the name of the furniture item. Also, bunnies will start to go from the tip jar to the furniture item. If the bunnies are going between the tip jar and the correct furniture, click Yes on the pop-up. If they are not, click No on the pop-up and this will cancel the linking process. You can now start the process again using the steps above.

If you clicked yes then the tip jar and furniture are now linked and the tip jar will continue it’s setup. If there are any errors to the config file you will be alerted with a private message in local chat. If not, you will be asked to give the tip jar debit permissions. Click allow on that pop-up.

Why do you need debit permissions?

The tip jar needs debit permissions to pay the workers that log into the tip jars. The way the tips work, when the tip jar is tipped, you get all the money from the tip. The tip jar then calculates the amount to send to the worker based on the percentage you set in the config and sends that amount form your account to the worker. It needs debit permissions to do this.

Once you have given debit permissions the tip jar will now display your logo (or the default logo if you didn’t put one in the config) and is ready to go. The tip jar will log in anyone that sits on the furniture item when it is empty. (if someone is already sitting and logged in, it will not log in the second sitter)

How do I unlink the tip jar from the furniture?

There may come a time when you need to unlink your tip jar from the furniture. To do that, when the tip jar is not in use, click on the tip jar and select Unpair on the pop-up. This will unlink both the tip jar and the furniture.

I accidentally picked up the tip jar and now the furniture thinks it is already linked but there is no tip jar linked to it.

Don’t worry, we got this. Right click on your furniture item and select edit. Go to the contents tab and wait for all the contents to load. (this may take a while). When loaded you should see the furniture script in the contents. Go to your tip jar folder in your inventory and find the script “BB Unpair Script”. Place this script in the furniture contents. This will force the furniture to unpair and the script will delete itself. You are now ready to link the furniture to a new tip jar.

The Tip Jar or Furniture are acting up and I need to reset the scripts but don’t want to have to pair them again.

Don’t worry. Resetting the scripts will not unpair your tip jar or furniture. You can reset them and they will continue to work together.