Skip to content
Honybot is a twtich chatbot webapp written in Java
Java HTML CSS JavaScript
Branch: master
Clone or download
Holly1337 Merge pull request #6 from henrikhierl/adjustTwitchTags
Adjust for twitch chat tags changes done on 3/26/19
Latest commit 21fc454 Apr 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gradle/2.14.1/taskArtifacts Initial commit Jan 6, 2019
gradle/wrapper Initial commit Jan 6, 2019
.classpath Initial commit Jan 6, 2019
.gitattributes Create .gitattributes Jan 7, 2019
.gitignore Initial commit Jan 6, 2019
LICENSE Create LICENSE Jan 6, 2019 fix typos in Jan 14, 2019
build.gradle Initial commit Jan 6, 2019 Update Jan 12, 2019
gradlew Initial commit Jan 6, 2019
gradlew.bat Initial commit Jan 6, 2019
mysql_schema.sql Initial commit Jan 6, 2019
settings.gradle Initial commit Jan 6, 2019


About the project

This project contains the source code of Honybot is a chat bot that offers a lot of features like custom currency, vip-system, (automated) betting, custom commands and some neat Starcraft 2 Features.

This started as a fun project (and still is) and grew a lot bigger than I expected. Code quality is pretty horrible most of the times. The main goal was to get things to work. There are probably still some german comments, some useless console prints and a lot of useless(?) TODOs.

If you want to fork this project and create your own website off of it, it will probably not work out of the box. There are still a lot of dependencies in locations (e.g. in html) that reference to static sources outside of this project. For example some images, JavaScript or the HonyHelper might still be loaded from

Requirements to run

  • MySQL Database (recommended version 5.7)
  • developer access
  • SC2 Ladder Updater (optional)


clone project

Setup a MySQL database and execute the script mysql_schema.sql. This should create all required tables. You might have to create some db entries, like a dummy user for betting stats.

Rename or copy file to and fill it out. More information can be found down below.

Register an app at and generate the ClientSecret. Your app's OAuth Redirect URL needs to be the same as the one in the configuration file, e.g. http://localhost:4567/auth. Paste the ClientSecret and Client-ID into the

The Chatbot needs a twitch dedicated account and an OAuth token, to join chat channels. Therefore you need to generate one and save it together with the name into

Import project into IDE:

  • IntellIJ IDEA: New project from existing source > use Gradle
  • Eclipse: Should just work out of the box

Using honybot on a server that runs Apache

If you want to use the bot on a server that also runs Apache, here are additional directives for HTTP(S) that might help:

<Location />


All configuration is located in the file. I have no idea why there are two oauth params...

# Admin password to log into any account as admin. For the love of god, please change this

# Webserver Port

# twitch config

#db config - this are only defaualt values. You can change this to your db settings

Co-Dependent projects

This bot uses code from other repos, that I don't have added to GitHub yet. They will follow soon.


The bot still uses the old twitch API (v5) and is based on channel names instead of channel IDs. This already breaks Stuff and might break even more Stuff in the future.

How to contribute

Just create a pull request. Or let me know of you find some bugs. Create issues. You know. all that stuff.

Here are some things that it could really need right now:

  • Logging - There is absolutely no useful logging.
  • ORM - Database stuff looks bad. It works, but it's not nice. A lot of copy and paste happened here.
  • JSON - I currently use org.json.simple. Using something like Jackson might be better.
  • IRC Bot - Honybot uses PIRCBot. It might be worth to use in the future.
  • Open Source Design - The website is built on a Themeforest template. I suck at webdesign, so I bought a template. It would be cool to have an own, unique design.
  • Cleaner code in general


This repository is licensed under the GNU GENERAL PUBLIC LICENSE Version 3, as stated in the LICENSE file.

Files in /src/main/resources/assets are licensed under the Themeforest Regular License (, unless stated otherwise.

You can’t perform that action at this time.