Smoker's Multiphasic Tip Menu

Short Description:

A familiar take on tip menus but with new features and a second, hidden menu for broadcasters to share with special viewers

Full Description

Smoker's Multiphasic Tip Menu

About me

I am a software developer and software manager by profession. This is my first foray into Javascript development and I will continue to iterate on this bot as my Javascript skills and knowledge increase. My philosophy is that code should first and foremost be readable by others, including my future self. To that extent, anyone reading the source code might find it to be slightly verbose, but hopefully it makes it easier to follow. I aim for a very straightforward OO/procedural style. I welcome feedback from other developers and will duly credit them if I use their suggestions.

I have opted to release the source code for this bot, as I will do any others I write. Rumours abound on CB about bot authors who use their bots to glean what should be private information from models, and also to implement scams. For example, as I was learning the CB API, I was able to write a malicious bot in just a few minutes that would send me all tip notes for a model just by being in a room where said bot was running. In my opinion, models should take some care to only use bots that they absolutely trust. By releasing mine as open source I hope to gain that trust and to encourage other bot authors to engage in the same practice.

About this bot

The concept for this bot was originally suggested by my friend Lostmedic who was looking for a tip menu that incorporated fan club pricing AND which had a separate, private menu that the broadcaster could use to share special items with special viewers. While My Menu by bobodeluxe incorporates fan club discounts, I couldn’t find a tip menu bot that incorporates all features I wanted to include, so I proceed to write this one in my spare time over 3 days.

Features:

• Familiar, but even cleaner, look and feel. The Menu by i0_ol has, in my opinion, the cleanest look and feel of any tip menu I’ve encountered on CB, and I’ve chosen to emulate it. Requiring only a single colour for a theme is sheer joy for its simplicity. Unlike The Menu, though, I am limiting separators to emojis only (no gifs) but providing a much larger set to choose from. Separators for the menu titles and items, and for the notices that are issued when a tip is received, can be selected individually. Each separator can be set to RANDOM which will select a random emoji on each execution.


• Limited but useful built-in colour themes. I’ve provided 10 build-in colour themes, including the default “Smoker’s Theme”. Each passes CWAG 2 by having a colour contrast ratio in excess of 4.5. While custom themes can be specified now, CWAG 2 validation and adjustment of custom themes will only be added in the next release of this bot. Kudos again to i0_ol for calling this out in his documentation for The Menu.


• The bot uses a general colour theme and then allows a different one to be used for the hidden menu. Custom themes can also be specified for moderator, fan club, and regular messages that are sent when a tip is received.


• The weight of text in notices can be set to ‘normal’, ‘bold’, or ‘bolder’. The default is ‘bold’ which I recommend, though ‘normal’ also looks good. ‘bolder’ is there for completeness and I’m open to feedback about whether to keep it as an option or not.


• Separate messages, colour themes, and separators can be specified for messages for tips from moderators and fan club members. Anonymous tipping overrides being a moderator or fan club member.


• The frequency that the menu is displayed to the room can be set from 1 to 10 minutes, inclusive.


• Both multi and single line styles are supported.


• The regular menu allows for optional fan club pricing. E.g., “Show feet” might be regularly priced at 42, but could be priced at 35 for fan club members. This would appear in the menu display as “Show feet (42 - FC:35)”. In this examples, fan club members tipping either 35 or 42 would trigger the item. I am open to feedback on whether it should only trigger the item when fan club members tip 35 and not 42.


• All menu items can be disabled without being removed.


• The menu items are automatically sorted by regular price in ascending order. No other sorting options are available. If other sort orders are desired, please provide feedback to that effect.

Known issues:

• Occasionally the notices for the two menus can be displayed out of order. For this reason picking a distinct colour scheme for the hidden menu can be advantageous.


• If a moderator who is also a fan club member is eligible to receive the hidden menu because both groups are eligible then they will receive the hidden menu twice when it is sent to all users.

Lessons learned:

• When processing onMessage events, it is best to work with a trimmed version of the message string as there is sometimes a newline character on it or it ends with a space.


• Ordering multiple notices that make a single visual ”object” is a massive PITA!!!

Notes:

• Fan club members tipping anonymously will still get fan club discounts even through the notice will be in the default message theme.


• Fan club members will trigger tips at both the regular and fan club prices.


• Special viewers who are granted access to the hidden menu should consider anonymously if anonymous tipping is available to avoid potential ill will.

Feedback

I hope you this bot meets your needs and that you and your viewers enjoy using it.

Feedback and feature requests can be made via Telegram @smoker919.