We run various IRC bots, some of them have a public facing usage. Any requests or questions about our utility bots can be asked in <code>#libera-bots</code>.

== ozone ==

ozone is anti spam bot which kills and klines spammers. ozone is an instance of [https://github.com/Libera-Chat/Sigyn Sigyn].

When your channel is being targeted by spam bots, you can <code>/invite ozone</code> '''If you run some bots, you should voice them''' otherwise ozone could ban them if they are too verbose.

If it bans a legit user, op yourself on your channel <code>/msg chanserv op $channel</code> and ask ozone to unkline the user <code>/msg ozone unkline $nick</code>

If you want ozone to stay permanently on your channel, contact us. ozone may require a minimum numbers of users on the channel before joining, this varies over time. ozone may also enter a channel on its own if it believes that the channel is under attack. If you wish to get rid of the bot again, you can kick it and it won’t come back.

== litharge ==

Litharge is a channel bans and quiets management bot. It is an instance of [https://github.com/ncoevoet/ChanTracker ChanTracker]. It keeps a record of channel mode changes and allows management of them over time. It stores affected users, allows deep searching of mode changes, reviewing active modes, editing duration of mode changes, and marking and annotation of them.

When requesting litharge for your channel, simply <code>/invite litharge #yourchannel</code>.

=== Usage ===

Once litharge has joined your channel, place a new ban/quiet and litharge will recognize you as a channel operator.

<source lang="irc">/msg litharge list chantracker
/msg litharge help <command></source>
After you quiet/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.

<source lang="irc"><litharge> For [#1238 +b *!*@255.255.255.255 in #example - 1 user(s)] type <duration> <reason>, you have 5 minutes</source>
You can search inside the ban database, for expired or active elements

<source lang="irc">/msg litharge query *!*@255.255.255.255</source>
If you do not reply within 5 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:

<source lang="irc">/msg litharge pending #example --oper <yournick></source>
Change the mode change expiration from the default (if one has been chosen):

<source lang="irc">/msg litharge edit 1238 6d
/msg litharge mark 1238 continuing to troll</source>
Or, you can combine the edit and mark commands, or edit and mark multiples elements in a row:

<source lang="irc">/msg litharge editandmark 1553 30d came back to troll from this hostmask in other chans
/msg litharge mark 1238, 1112, 938 same user
/msg litharge edit 1238, 1112, 938 1w</source>
You can also get info about a ban/quiet:

<source lang="irc">/msg litharge info 1238</source>
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):

<source lang="irc">/msg litharge check #example *!*@*.com</source>
That will show all users with <code>.com</code> in their hostmask being affected by any intended mode change.