A Twitch.tv viewer reward and games system.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Brandon Cornejo 708ff96989 T.tv chat issues fixed 100%, bot working. 10 years ago
lib T.tv chat issues fixed 100%, bot working. 10 years ago
node_modules Added express.js web interface options. 10 years ago
users fixed naming 11 years ago
web T.tv chat issues fixed 100%, bot working. 10 years ago
.gitattributes commit 11 years ago
.gitignore user file example 11 years ago
Commands.md adding bullets 11 years ago
README.md fixed error in example 11 years ago



A TwitchTV viewer reward system

Written in JavaScript and Node


LoyaltyBot is a chat bot that allows you to reward viewers with loyalty points for hanging out on your stream. It's main purpose is to allow you, the broadcaster, to reward the viewers that are dedicated to watching your stream as opposed to the viewers that just stop by for a quick giveaway and leave.


  • Fully functioning auction and raffle systems
  • Double loyalty points for subscribers/loyal viewers


  • Moderator commands (currently in development, semi functional)

####Future Features/Extras

  • Free subscriber/paid non-subscriber Jukebox (still in development)
  • Stream title updates posted to twitter (still in development)

Basic Setup


var loyaltybot = require('./../lib/initialize.js');

    // twitch info
    twitch : {
        channel     : 'loyalty',
        bot         : {name: 'LoyaltyBot', password: 'loyalty!loyalty!loyalty!'},
        subscribers : 'https://spreadsheets.google.com/feeds/list/****/od6/public/basic?alt=json'

    // currency info
    currency : {
        name     : 'Points',
        payrate  : 15,
        host     : '',
        user     : 'mysql_user',
        password : 'mysql_password',
        database : 'mysql_database',
        website  : 'http://www.loyaltypoints.com'

    // optional features
    commands: true

Configuration Options


  • channel: the channel name (in lower case)
  • bot.name: the account name of the bot
  • bot.password: the password for the bot
  • subscribers: a google doc that contains subscriber names (more info on this later)


  • name: custom name for the loyalty points
  • payrate: how often to hand out loyalty points (in minutes)
  • host: mysql database hostname/ip
  • user: username for the mysql database
  • password: password for the mysql database
  • database: mysql database name
  • website: provides loyalty bot with an offsite location for checking currency. can also be and be an empty string


  • commands: enable/disable the ability to use moderator commands. boolean: accepts true or false

Preparing to Setup Your Channel's Bot

####Create a new bot account

In order to use LoyaltyBot's features you will need to create a new TwitchTV Account. You can name it anything you wish, all you need to do is pass the username/password to bot.name and bot.password

####Create the subscriber/loyal viewer list on Google Docs

Since TwitchTV does not have subscriber information in their api, LoyaltyBot needs a way to obtain that information. That's where Google Docs comes in.

In the following order:

  • Create a new spreadsheet
  • Set cell A1 as the header "Username"
  • Subscriber names (must be lower case) will then be in column A starting in cell A2 and below (Fig. 1)
  • Set the subscriber list to public and change the type to json (Fig. 2)

Side Notes:

  • Even if you do not have a subscription button, you can still add loyal viewers to this list for the double loyalty point benefits.
  • Why Google Docs and not the MySQL database? Simplicity. It's easier to manually update a google doc spreadsheet daily then it is to update a MySQL table.

Figure 1:

Column Setup

Figure 2:

Create Link

####Setting up MySQL tables

LoyaltyBot stores all of the viewer info and moderator commands in a MySQL database and requires specifc table/field names.

LoyaltyBot takes care of all table creation, however if by some chance you need to manually setup the tables the following contains information about them:


  • Table Name: viewers
  • Field Names: user [primary key, not null, varchar], points [not null, integer]


  • Table Name: commands
  • Field Names: id [primary key, autoincrement, not null, integer], command [not null, text], text [not null, longtext], auth [default: 1, integer]

LoyaltyBot In Action

ArcherBot - Chiffre2435
CookieMonsterBot - Minerva_dh
InternetBot - Izlsnizzt
KarmaBot - itsfabiotime
Knowledge_Bot - Illicitmedia
XBucksBot - Linexnick

If you're using LoyaltyBot send me a twitch message so I can add you to this list!