diff --git a/draft-ircbots.md b/draft-ircbots.md new file mode 100644 index 0000000..7e46fdf --- /dev/null +++ b/draft-ircbots.md @@ -0,0 +1,34 @@ +--- +title: Standardising IRC Bot Behavior +author: Robert Miles +status: Proposed +--- +## Abstract {#abstract} + +IRC bots are programs that communicate with users through Internet Relay Chat. These bots can do a wide assortment of things, +from getting weather information to running games. We accept IRC bots on tilde.chat, but we ask that any prospective bot operator +follow these rules. + +### `!botlist` command {#botlist} + +The botlist command is our answer to not knowing the functions a bot provides. + +All conformant bots MUST respond to `!botlist` with: (examples from [minerbot2](https://git.tildeverse.org/khuxkm/minerbot2), my personal IRC bot) + + - Maintainer (e.x.; "Maintainer: khuxkm@tilde.team") + - Small description (optional) (e.x.; "A utility bot that does some other cool things too!") + - Command list (e.x; "Commands: !foo !bar") + +For conformance with [previous standards on other tilde boxes](http://tilde.town/wiki/bots/ircbots.html), bots SHOULD also respond to `!rollcall` with at least the command list. + +## Procedural Information {#procedures} + +### Security Considerations {#security} + +There are no security considerations to this document. + +### Configuration Considerations {#config} + +IRC bots on tilde.chat MUST be updated to follow the botlist convention. + +For bots on tilde.chat coming from tilde.town, maintainer info must be added, as well as an alias from "!botlist" to "!rollcall".