This is a Scala implementation of an IRC bot, on top of https://github.com/pircbotx/pircbotx.
How to install
First, make a configuration file, based on the example.
sbt assembly to create a .jar. Then run the bot with
java -jar <filename.jar> <path/to/configfile>.
To run the bot without making a jar, use
sbt "run <path/to/configfile>"
This bot is tested on openJDK 11.
In the configuration file, the array of
bot-admins is used to decide who is allowed to run admin-only commands.
puppet-masters array is used to decide who may puppet the bot.
listeners array is the most important. This decides which functionality your instance of the bot will have.
Every listener has an ignore-channels settings which can be used to ignore all messages from those channels for that
This should always be on. It sets the +B (bot user mode that many IRC servers require) on connect, and it listens to !help messages, and !quit messages from bot-admins.
It also listens to errors from other listeners and logs them.
This listener also contains the puppet-master functionality: Use !say #channelname message or !act #channelname message to have the bot send these messages to the channel. Instead of channel names nicknames can be used for PMs. Note: There's no check in place to see if the bot is in the given channel or anything, use at your discretion.
This listener reacts to messages and actions containing http/https links. It attempts to retrieve the <title> tag in html pages and if it can find one, it will send the title to the channel.
If the configuration has Twitter API credentials (which you can get at https://developer.twitter.com) it will use the Twitter API to get Twitter texts instead of depending on the Twitter website which keeps changing.
If the configuration has Youtube API credentials (which you can get at https://console.developers.google.com/) it will use the Youtube API to get Youtube video titles instead of depending on the Youtube website which keeps changing.
This listener stores users' personal pronouns (he, she, they, it, other) and can be used to look up the pronouns. It writes these into a file to keep them between restarts.
If you want to run your own instance of the bot please host your own documentation specific to that instance. Feel free to use Isaac's documentation (the original instance of this bot) as a basis for your own.