Harkbot

From NURDspace
Revision as of 21:40, 6 April 2022 by R3boot (talk | contribs)

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