litharge is the bantracker bot for Libera Chat (previously known as eir on freenode). The official documentation is on the Libera Chat website.
Grant the "
litharge" account +o rights and
/invite litharge, you'll receive notices with instructions and links.
If you haven't already, register with the bot:
/msg litharge hello
You'll get a notice back like "You are now authenticated as <nick>"
Set a test ban to verify it works, like
/mode +b testing!*@*. litharge should PM you asking for a reason, reply with
5s testing and after a few seconds, the ban should be removed.
Next, set the default expiry for the channel to 24 hours:
/msg litharge cautoexpire #channel 86400.
After you quiet/kick/ban (ie: a "mode change") the offending user, you need to set the mode change expiration and document with litharge.
You will receive a PM from litharge asking you to document the mode change. Follow the instructions.
If you do not reply within three minutes, you can view all pending mode changes (ie: view all mode changes that have not been marked or edited yet) and document them by doing the following:
/msg litharge pending #<channel> <litharge> [#1553 +b trollnick!*@*59.35.44.* by email@example.com on 2021-02-13 13:28:16 GMT]
Note that you can filter for just your own pending mode changes by adding the oper filter ie:
/msg litharge pending #<channel> --oper <yournick>
Change the mode change expiration from the default (WM chans are now 24 hours):
/msg litharge edit 1553 6d /msg litharge mark 1553 continuing to troll
Or, you can combine the edit and mark commands:
/msg litharge editandmark 1553 30d came back to troll from this hostmask in other chans
If you want to check the results of a mode change before it's placed, and which bans would affect a given user (assuming the bot shares a channel with the user):
/msg litharge check #<channel> *!*@*.com
That show all channels with .com in hostmask being affected by any intended mode change
/msg litharge match #<channel> troll
<litharge> [#1553 +b trollnick!*@*59.35.44.* by firstname.lastname@example.org on 2021-03-14 13:28:16 GMT] "came back to troll from this hostmask in other chans"