Tip Angel

Short Description:

Tips and viewer analytics with no tip notifier.

Full Description

/**
* Name: Tip Angel
* Author: archangelsm
* Creation Date: 20.06.14
* Date Last Edited: 21.05.25
* Version: 2.08
*
* This is a private bot–viewable by the broadcaster only–that tracks the
* number of tips, tip totals, viewership, and elapsed time over a session. The
* bot will post an update at set times defined by broadcaster (5min, 10min,
* 20min, 30min, 60min) as well as the current total for the session. Tips can
* be converted to dollar amounts.
*
* Several reports can be printed at any time:
* 1) a session report that shows tips and totals by user class, viewers/hour,
* tips/hour, and tips/viewer over the whole session at custom intervals;
* 2) a tip list that lists tipping users with their tip counts, tip totals,
* and highest tips;
* 3) a viewers summary that shows how many of each class of viewer has entered
* the room;
* 4) a viewers times log that displays visit count and elapsed time in room
* (over 5 min);
* 5) a viewer detail time log displaying when user is in and out of room;
* 6) a media report that displays media sales that session.
*
*
* NOTE: All information is shown to the broadcaster only!
*
* COMMANDS
* /sr - display current SESSION REPORT
* /sr <5|10|20|30|60> - display SESSION REPORT in select interval
* /tl - display TIP LIST
* /vs - display VIEWERS SUMMARY
* /vt - display VIEWERS TIMES LOG
* /vd - display VIEWER DETAIL TIMES
* /mr - display MEDIA REPORT
*
* * Special thanks goes to: tealchromatic
*
* TO DO: (search devadd)
* - current time to /sr
* - inspiration messages
* - add king tipper
* - add leaderboard
*
* Change log
* 2.08 - 21.05.25 - Broadcaster elapsed hours after logout time.
* 2.07 - 21.05.08 - Auto-reporting to mod every 30 mins if online.
* 2.06 - 21.05.02 - Corrected totalFollower in interval report. Corrected change log.
* 2.03 - 20.02.14 - Date.now conversion function to adjust server time from UTC.
* 2.02 - 20.01.14 - Added follower counter.
* 2.01 - 20.11.07 - Added peak visitor info.
* 2.00 - 20.10.29 - Code optimization.
* 1.10 - 20.10.27 - /vd now displays enter/leave as time (replacing mins
* elapsed)
* 1.09 - 20.10.25 - Added getRoomUsersData handler to get users on bot loading.
* 1.08 - 20.10.17 - Fixed media reporting error.
* 1.07 - 20.09.25 - Database rebuild. Custom interval session reports. Added
* current interval to report.
* 1.06 - 20.08.31 - Viewer detail time log.
* 1.05 - 20.08.17 - Media tracking, media report.
* 1.04 - 20.08.16 - Merged data arrays and classes into one.
* 1.03 - 20.08.13 - Simplified commands. fetchHoursElapsed().
* 1.02 - 20.07.30 - Added tip list functionality.
* 1.01 - 20.07.26 - Reconfigured time keeping and clock function
* (self-adjusting). writeTipBreakdownString() added. Changed
* how reports are printed to screen.
* 1.00 - 20.06.22 - First version.
* 0.07 - Added option for tip conversion to dollars.
* 0.06 - viewers/hr tips/hr tips/viewer added to report. session
* timer.
* 0.05 - /report and database
* 0.04 - Tip counters and breakdowns. Settings to display.
* 0.03 - Timestamp.
* 0.02 - Auto-detect broadcaster.
* 0.01 - 20.06.14 - First development version.
*
**/

/**
* Name: No Tip Alert
* Author: archangelsm
* Creation Date: 20.09.13
* Date Last Edited: 20.09.13
* Version: 0.1
*
* DESCRIPTION - Bot that will alert broadcaster of users in room who have
* tokens, but have not tipped in a set amount of time. Then the broadcaster can
* boot the freeloaders if they so choose.
*
* COMMANDS
* TBD
*
* TO DO: (search devadd)
* - add custom settings
*
* Changelog:
* 0.1 - 20.09.13 - First development version.
*
**/