Harkbot: Difference between revisions

From NURDspace
Line 6: Line 6:
  06-04-2022 - ACLs dont quite work.
  06-04-2022 - ACLs dont quite work.
  23-04-2023 - Its a mess
  23-04-2023 - Its a mess
  23-02-2023 - Best IRC bot EVAH!
  23-02-2024 - Best IRC bot EVAH!


== Undocumented Features ==
== Undocumented Features ==

Revision as of 00:09, 24 February 2024

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. It's called ghbot and lives in #nurds with '!' as command character.

Known issues

06-04-2022 - ACLs dont quite work.
23-04-2023 - Its a mess
23-02-2024 - Best IRC bot EVAH!

Undocumented Features

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.1.27). 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