Top Tippers
Author: rubzombie
Description Source Code Launch Bot Current Users

Short Description:

Count tips and tokens and compile a Top Tippers leader-board. Your top three tippers have their chat messages tagged.

Full Description

See alsoKing Tipper Bot and Sequence Tips Bot

Now featuring RoboBan Rx/Instaban technology. See RoboBan for further details.



Top Tippers is a very simple bot that ranks tippers based on the largest number of tokens tipped in the fewest number of tips, tagging those ranked top, second and third as Gold, Silver and Bronze Tippers.

Settings:

You can choose between text labels, e.g. Gold Top Tipper:, or graphics, e.g. , for tagging your top tippers.



If you run Top Tippers at the same time as either of my other tagging bots, King Tipper Bot and Sequence Tips Bot, you might find the graphic tags won't display. (This is to prevent members spoofing top tipper tags.) In which case, choose the Text option.



Leader-board Pre-set List Setting:

This and the next section are only of interest to broadcasters who want to maintain a top-tipper leader-board over more than one bot session. Otherwise, feel free to skip ahead to in-chat commands.
The only information Chaturbate apps and bots remember, is that entered as launch settings. So, de-activating Top Tippers clears the contents of its leader-board.
However, if you save the contents of the leader-board, before de-activating Top Tippers, you can re-instate it, the next time you start the bot.
In order to save the leader-board contents, first display it in the form of a list of tipper records, by typing /leaderboard, or just /lb.
Then select and copy the displayed list of tipper records into your clip-board.

Once in the clip-board, you can de-activate the bot and then either (1) re-launch it, so you can paste them directly into the Pre-set List setting on the Launch Bot page (you must start the bot briefly by clicking Start Bot for Chaturbate to remember the setting) or (2) paste them into a text editor like Notepad, so you can save the list as a text file, from which to copy and paste them into the Pre-set List setting, the next time you launch Top Tippers.
Saving the list as a text file has an advantage when dealing with off-line tips, described next.

Including Off-line Tips:

Unfortunately, because the bot has no way of detecting off-line tips, if you want them to be included in your Top Tippers list, you will have to enter them manually, which is more easily done if you have saved the list of tipper records in a text file.
A tipper record consists of a tipper's member name, their token count and their tip count, separated by colons, e.g. dr_evil:100:5 records that member dr_evil tipped 5 times a total of 100 tokens. If you get an offline tip of 1,000,000 tokens from dr_evil, that you want to count towards their Top Tippers ranking, their record must be changed to dr_evil:1000100:6.
You can either edit the record in the Pre-set List setting on the Launch Bot page (remembering that you must start the bot briefly for Chaturbate to remember the change) or, if you have the list saved as a text file, change it there.

TIP: If you have a lot of tipper records, use Ctrl+F to find the tipper's member name.
If you receive a 1,000 token off-line tip from someone who doesn't already appear in the list of tipper records, just add a new one for them, for instance, mini_me:1000:1 .
Bear in mind, when editing a tipper record, as the number of tips can never exceed the number of tokens, whichever is the higher number is taken to represent the token count. So the new record could equally have been written mini_me:1:1000 .
Note, however, that tipper records must be unique. So, only the first tipper record for a particular member will be counted, if more than one is found for them in the Pre-set List, any others being discarded.

In-chat Commands:

Top Tippers has a number of in-chat commands that everyone can use:

Only broadcasters have access to the full leader-board using the following commands:

To use the HTML version of the leader-board in the About Me section of your My Bio page, copy and paste everything displayed between the <div> </div> delimiters, inclusive.

If any of these in-chat commands clash with those of another app or bot, they may be qualified by pre-pending them with either toptippers or the slot in which the bot is loaded.
For instance, if you want to display Top Tippers help message, type either /toptippershelp or, if it's loaded into the Bot #1 slot, /#1help .

Beware Top Tipper Fakers:

Although Top Tippers does its best to prevent fraudulent use of the graphic and text label tags, while it is running, determined fakers could spoof the graphic emotes, and so pass themselves off as top tippers. However, the only way for them to actually get on the leader-board is to either tip or have you add them to the Pre-set List. So, if you're in any doubt as to whether someone is a genuine top tipper, use /rank member to check their ranking, if any.

Additional Settings: Multi-line Safe Mode:

It can sometimes happen that Chaturbate has problems displaying multi-line notices. /help and /tops both produce multi-line notices. So if you use either and get no response, re-launch Top Tippers, (remembering to first display the current leader-board with /lb , see the section on using the Pre-set List setting) enabling Safe Mode, to convert all multi-line notices into their single-line equivalents. Unfortunately, in Safe Mode, the single-line equivalents aren't guaranteed to be displayed in the intended order, which can lead to confusion, which is why it is better to run Top Tippers with Safe Mode disabled, if possible.

Acknowledgements:

Also by the Same Author:












© Copyright Freesexcam 2011- 2024. All Rights Reserved.