BotService Overview

BotService lets you create and manage extensible bots that live in channels, respond to messages, greet users, and execute custom commands. Bots are built on a pluggable capability system — each bot can be configured with different behaviors.

Capabilities

Each bot can have one or more capabilities enabled:

Mentions — responds when someone mentions the bot by name
Greeter — welcomes users when they join a channel, optionally says goodbye on part
Custom Commands — user-defined !BotName trigger commands with configurable responses
Help — built-in !BotName help command that lists available commands
Dice — RPG dice rolling with standard notation (2d6, d20+5, 4d6kh3). Use !BotName roll <notation> to roll dice
Moderation — auto-moderation that monitors all messages for blocked words, spam, flood, and caps lock abuse. Configurable actions: warn, mute, or kick
Trivia — interactive quiz with 6 categories, scoring, and timers. Use !BotName trivia start to begin a round
Scheduler — posts scheduled/periodic messages to channels. Supports interval (every N minutes) and daily (at HH:MM UTC) schedules
RSS — monitors RSS/Atom feeds and posts new items to channels. Use !BotName rss add <url> <#channel> to add a feed

Additional capabilities (LLM, Script, Game) are planned for future releases.

How Bots Work

Each bot runs as its own process on the server. When a message arrives in a channel the bot has joined, the bot checks each capability in order. Passive capabilities (like Moderation) run on every message, while active capabilities use first-match-wins. A cooldown timer prevents the bot from responding too frequently.

Bots appear in the channel nicklist with a ⚙ prefix and are grouped below regular users. They can be kicked or banned from channels like normal users.

Permissions

Only admins and server operators can create, modify, or delete bots. All users can view bot info and use bot commands.

Dice Notation

The Dice capability supports standard RPG notation:

NdS — roll N dice with S sides (e.g., 2d6)
dS — shorthand for 1 die (e.g., d20)
NdS+M — add modifier (e.g., d20+5)
NdS-M — subtract modifier (e.g., d8-2)
NdSkhK — keep highest K dice (e.g., 4d6kh3)
NdSklK — keep lowest K dice (e.g., 2d20kl1)

Trivia Categories

Available trivia categories: general, science, history, geography, technology, entertainment.

Commands: !Bot trivia start, !Bot trivia stop, !Bot trivia score, !Bot answer <text>

Template Placeholders

Bot responses support these placeholders:

{nickname} — the user who triggered the response
{channel} — the current channel name
{topic} — the current channel topic
{prefix} — the bot's command prefix (e.g., !)
{botname} — the bot's display name

Management Dialog

Open the Bot Management dialog from the Tools menu or by typing /bot with no arguments (admin only). The dialog shows all bots with a split-view: select a bot on the left to see its details, channels, commands, and event hooks on the right.