Harkbot

Whut?

A new IRC bot which uses mqtt to communicate with plugins. For now it runs in the #nurdbottest channel and it uses the '#' control character.

Known issues

06-04-2022 - ACLs dont quite work.

Mqtt

For now, mqtt is listening on localhost only. The following topics can be used to communicate to/from the bot:

Topic	Direction	Description
from/irc/(channel)/(nickname)/message	towards plugin	Raw feed of messages in (channel)
from/irc/(channel)/(nickname)/(command)	towards plugin	Listen in a channel for (ControlChar)(command)
to/irc/(channel)/privmsg	towards bot	Send reply in (channel) via PRIVMSG
to/irc/(channel)/notice	towards bot	Send reply in (channel) via NOTICE
to/irc/(channel)/topic	towards bot	Sets TOPIC for (channel)

Code

https://github.com/NURDspace/harkbot

Host

This runs on harkbot.vm.nurd.space (10.208.30.67). Login with user 'nurds' and the well-known password.

Building a new release

$ cd ~/harkbot
$ make

Running the bot

$ sudo systemctl start harkbot

Reloading for changes

$ sudo systemctl restart harkbot

Example plugins

See the plugins/ subdirectory for some examples of plugins