I tried many generic and Twitch bots out there, but none of them fully satisfied my needs. And since I am a programmer with needs I decided to build my own.
Features
- Viewer loyalty:
- Customizable Points system
- View time tracking
- Follower/Subscriber statistics
- RESTful Api
- Customizable text-based commands
- Spotify integration
- Twitter integration
- Steam integration
- Stream Labs integration
- Raid register (manual)
- Donation register (manual or powered by Stream Labs)
- Automated and customizable viewer greetings
- Customizable Chat moderator
- Basic raffle system
- Chat quotes register
- Chat games
- Adventures Also known as Heists
- The all-knowing Eightball
- Investments Yeah that's new
- Creative ways to die (!kill)
- Russian Roulette
- Slot Machine
- Tamagotchis
Pull requests are always welcome, tho I must tell you I'm very picky.
Sidenote on pull requests: Your IDE might support editor config, or maybe there's a plugin.
Use it, it's half of your work done for you
- Minor versions, mostly including new features:
Every week on sunday if changes have been made. - Micro versions, mostly bugfixes and security fixes:
As soon as they are available and tested.
Biliomi will sometimes refer to "the docs". Find them here!
A WADL for Biliomi's REST Api is available under http://localhost:30000/application.wadl when Biliomi is running.
- ./
- Biliomi v3/
Installation root- lib
Libraries used by Biliomi - i18n
Language files, feel free to edit - biliomi-x.x.x.jar
The main Java executable - start-biliomi.sh
Start script for linux/MacOS - start-biliomi.bat
Start script for Windows
- lib
- RELEASES.MD
A list of all previous releases and release notes - README.MD
This read me - LICENSE
License information - database-mysql-ddl.sql
A SQL script for Biliomi's database - Biliomi.ts
A TypeScript interface definition file for Biliomi's REST Api model
- Biliomi v3/
Read these instructions carefully, tldr; == No support :D
Prerequisites:
- Your Twitch channel.
- A Twitch account for the bot.
Since Biliomi will have to be able to chat and moderate in your chat it needs an account the be able to do so.
Installation (Using the built in installer)
- Make sure you have the latest version of Java 8 or higher installed.
- Grab the latest version from the releases page.
- Open the downloaded archive and unpack the
Biliomi v3directory to where you want to installation to reside. - Open the file explorer and navigate to the location in which you've unpacked the downloaded archive.
- Run Biliomi. Biliomi will initially be set to installation mode.
To run Biliomi start (double-click) the appropriate runner for your system:
On Windows:start-biliomi.bat
On Linux/MacOS:start-biliomi.sh - Follow any instructions in the console to fully set up Biliomi.
- When the first time installation was successful Biliomi will have saved your settings and automatically shut down.
- Restart Biliomi
- Biliomi will now setup the database and ask you a few more questions to complete the installation.
On successful setup Biliomi will immediately connect to Twitch and start listening for commands. - Wait for Biliomi to finish follower and subscriber updates and exit Biliomi by typing
/exitin the console. - Once again open up
./config/core.ymlin your favorite text editor and changeupdateModetoOFF. - Now start Biliomi again and enjoy it's features.
Note: By default Biliomi will be muted to prevent any chatter during setup and initial follower/subscriber updates.
Type !mute in the console or chat to enable chatter.
Biliomi now has an automated update. The update takes care of step 1 to 3 for you.
Note: The automatic updater will overwrite your i18n files. If you've made any changes to them they will be lost.
You might want to make a backup of the ./i18n directory
- Grab the latest version from the releases page.
- Shut down any currently running instance of Biliomi.
- Unpack the downloaded archive into the final location, from which you like to run Biliomi, overwriting all files.
- Compare all config files within
default-configwith the files in the existingconfigdirectory.
Tedious, I know... But one can only do so much. The release notes will always contain a note about changed settings. - Open up
./config/core.ymlin your favorite text editor.
a. Update any setting that needs to be changed. Like added features.
b. SetupdateModetoUPDATE. - Start Biliomi again.
- Keep an eye out, Biliomi might have some questions for you.
- Wait for Biliomi to fully start
- Shut down Biliomi
- Once again open up
./config/core.ymlin your favorite text editor and changeupdateModetoOFF. - Now start Biliomi again and enjoy it's features.
Localization files are available here.
- Download the localization pack.
- Shut down any currently running instance of Biliomi.
- Replace the
i18ndirectory, with the installation root, with the preferredi18ndirectory from the language pack. - Now start Biliomi again and enjoy.
Biliomi is a command driven bot. This means that every and all interaction is done via posting commands in the chat or the console.
Commands always start with an exclamation mark (!).
When a command requires arguments you can find out which ones and how by simply posting the base command.
For instance: When you post !announcement in the chat, Biliomi will reply with Usage: !announcement [add|remove|interval|minmsgs] [more...].
When Biliomi is done booting it will start listening for input in the console.
known Bugs:
- Any input always requires [enter] to be pressed.
- Biliomi's logging can interrupt users typing a command, requiring users to reenter the command.
To find out what commands the console supports, simply type /help into the console and press [enter].
Commandline usage:
- Use console:
/[command] [any required parameters] - Post commands:
![command] [any required parameters] - Send whispers (using bot account):
@[target username] [message...] - post message in chat (using bot account):
>[message...]