you might have seen some bots lurking about in chat. this page is intended to be a common place for documentation.

bots should be well-behaved and efficient with system resources. if you see a bot that is not, please remind the botmaster about this and/or notify an admin. naughty bots can make the system less enjoyable for everyone, and we all have to work together to police them.

<span id="rules-and-etiquette-for-tilde.chat-irc-bots"></span>
== rules and etiquette for tilde.chat irc bots ==

please set usermode +B on your bot on connect to identify it as a bot. this is also documented in [https://rfc.tildeverse.org/rfcs/2#usermode--b rfc-2].

your bot must respond to !botlist with the following information: - your system username (as creator/botmaster) - so we can contact you if the bot misbehaves - one line description of the bot’s functionality - list of the bots public commands

be conservative about automatically re-connecting to the server or channel.

if your bot’s code is not yet stable, keep it in the #bots channel and do testing there.

don’t join #chaos or unless you want your bot to be spammed to hell and back.

all bots should also adhere to the following RFC specification: [https://rfc.tildeverse.org/rfcs/2 RFC 2: Standardising IRC Bot Behavior].

<span id="tilde.team-bot-starter-kit"></span>
== tilde.team bot starter kit ==

[https://khuxkm.tilde.team khuxkm] is hard at work developing a starter kit framework in python that you can use to build your own irc bot. find the [https://tildegit.org/team/teambot source here]. it’s installed globally on ~team, so get coding!

<span id="add-your-bot-to-the-list-below"></span>
== add your bot to the list below ==

follow the example of sedbot when you add your bot in a PR to the wiki

<ul>
<li>sedbot
<ul>
<li>botmaster: [https://ben.tilde.team ~ben]</li>
<li>short description: sent a typo in chat? fix it up with a sed expression and sedbot will try to correct it</li>
<li>list of functions:
<ul>
<li>s/needle/replace/flags</li>
<li>most regex character classes match here</li>
<li>flags include <code>g</code> and <code>i</code></li></ul>
</li>
<li>[https://tildegit.org/ben/sedbot source]</li></ul>
</li>
<li>tildebot
<ul>
<li>botmaster: [https://ben.tilde.team ~ben]</li>
<li>short description: an instance of BitBot for the tildeverse.</li>
<li>list of functions:
<ul>
<li><code>sed</code>-like corrections like <code>sedbot</code></li>
<li>weather/time per user (<code>,weather</code>/<code>,w</code>/<code>,time</code>)</li>
<li>user pronouns: <code>,pronouns</code></li>
<li>wolfram alpha integration: <code>,wa</code></li>
<li>translation services: <code>,translate le pain est sale</code></li>
<li>some per-user configuration available via <code>,config</code></li>
<li>git hooks (including gitea) - notifications on push/etc</li>
<li>write your own functionality with a plugin!</li>
<li>tilderadio notifications and other tilderadio functionality</li>
<li>ducc frens (when a duck appears: <code>,bef</code>/<code>,trap</code>, see stats with <code>,friends</code>/<code>,enemies</code>/<code>,duckstats</code>)</li></ul>
</li>
<li>[https://github.com/jesopo/bitbot BitBot source], [https://tildegit.org/ben/bitbot-modules tildebot-specific modules repo]</li></ul>
</li>
<li>tracer
<ul>
<li>botmaster: [https://ben.tilde.team ~ben]</li>
<li>short description: generate tracery output from grammars in you ~/.tracery (on ~team) - forked and ported from [https://notabug.org/selfsame/tracer selfsame/tracer] for py3 support</li>
<li>list of functions:
<ul>
<li>!!list</li>
<li>!!<grammar></li>
<li>!!fuse <grammar1> <grammar2></li>
<li><p>at the end of commands will echo the output in a new message eg: !!drink | !toot</p></li></ul>
</li>
<li>[https://tildegit.org/ben/tracer source]</li></ul>
</li>
<li>tooter
<ul>
<li>botmaster: [https://ben.tilde.team ~ben]</li>
<li>short description: toots from @tildeverse@tilde.zone (@tildeteam@tilde.zone in #team)</li>
<li>list of functions:
<ul>
<li>!toot <message></li></ul>
</li>
<li>[https://tildegit.org/ben/tooter source]</li></ul>
</li>
<li>Babili
<ul>
<li>botmaster: [https://aewens.tilde.team ~aewens]</li>
<li>short description: A data aggregating bot for the IRC server, can as an API for other bots for handling historical data from the network</li>
<li>list of functions:</li>
<li>View aggregated data at https://babili.xyz</li>
<li>[https://tildegit.org/babili source]</li></ul>
</li>
<li>circles
<ul>
<li>botmaster: [https://lickthecheese.fuckup.club ~lickthecheese]</li>
<li>short description: a nice bot to solve geometry problems</li>
<li>list of functions:</li>
<li>do ?help to list commands</li>
<li>[https://tildegit.org/lickthecheese/circles source]</li></ul>
</li>
<li>[[./badger|badger]]
<ul>
<li>botmaster: [https://khuxkm.tilde.team ~khuxkm]</li>
<li>short description: the Twitch Plays Pokémon badge system, ported to tildeverse IRC?</li>
<li>list of functions:
<ul>
<li><code>+listbadges</code> - List the badges in your possession.</li>
<li><code>+transmute &lt;badge&gt; &lt;badge&gt; &lt;badge&gt; [badge...]</code> - Transmute 3 or more badges into one, hopefully rarer badge.</li>
<li>just be active in #meta and you should get badges. you’ll get a message when you get your first!</li></ul>
</li>
<li>[https://tildegit.org/khuxkm/badger source]</li></ul>
</li>
<li>pink_dragon
<ul>
<li>botmaster: [https://tildegit.org/baruchel ~absalom]</li>
<li>short description: idle hack’n slash game on the <code>#legend</code> channel</li>
<li>list of functions: see the rules at [https://pink-dragon.surge.sh Legend of the Pink Dragon]</li>
<li>[https://gitlab.com/baruchel/pink-dragon source]</li></ul>
</li>
<li>k
<ul>
<li>botmaster: [https://kiedtl.tilde.team ~kiedtl]</li>
<li>short description: a small bot with a bunch of miscellaneous functions</li>
<li>list of functions:
<ul>
<li><code>:dc</code>: <code>/bin/dc</code> expression evaluator.</li>
<li><code>:fortune</code>: print a random fortune.</li>
<li><code>:usrstats</code>: print statistics about users.</li>
<li><code>:chanstats</code>: print statistics about channels.</li>
<li><code>:owo</code>, <code>:pig</code>, <code>:rot13</code>, <code>:rev13</code>: random text manipulation functions.</li>
<li>and many more in the making!</li></ul>
</li>
<li>[https://github.com/kiedtl/ircbot source]</li></ul>
</li></ul>