Bot Modules

Bot modules automate chat moderation and messaging. Every bot module — including the four that ship with Lumio — is an extension. Lumio provides four built-in modules (link protection, spam protection, word filter, and timed messages), and additional bot modules can be installed from the Extension Store.

Built-in Modules

The four built-in modules ship with Lumio and are available on every plan. You manage them under Dashboard > Bot Modules (in the sidebar under Tools).

Module	What it does
Link Protection	Detects URLs in chat messages and applies a whitelist and a blacklist of domains. Action: warn, delete, timeout, or ban, with a configurable timeout duration and warning message.
Spam Protection	Detects excessive capitals, excessive symbols, and emote spam. Thresholds cover the caps percentage, the minimum message length before the caps check applies, the maximum emote count, and the symbol percentage. Same four actions as Link Protection.
Word Filter	Blocks messages containing banned words, phrases, or regex patterns, with an optional wildcard mode. Same four actions as Link Protection.
Timed Messages	Sends rotating messages on a configurable interval (60 seconds and up). Options: send only while you are live, and require a minimum number of chat lines between two messages.

Each module supports:

• Exempt roles — moderators, VIPs, and subscribers can each be exempted from enforcement.
• Module-specific settings — thresholds, actions, and messages, as listed above.

The Bot Modules page

Dashboard > Bot Modules lists every bot module installed on the account. Each entry shows the module's icon, name, and description, plus a Built-in badge for the four modules that ship with Lumio.

Per entry you get:

• On/off toggle — enables or disables the module for the account. The toggle is disabled, and the card dimmed, when the module is unavailable — a tooltip and an inline note say why (not included in your plan, disabled by an administrator, or disabled for your account).
• Configure — expands the entry to show the exempt-role selection and the module's current configuration values. This expanded view is read-only.
• Add Module — opens the Extension Store filtered to the Bot Modules category.

Installing another bot module

1. Open Store > Browse Store from the sidebar, or click Add Module on the Bot Modules page.
2. Filter by the Bot Modules category, or search for the module by name.
3. Open the module to review its description, version, and developer.
4. Click Install. A dialog lists the permissions the module requests and its price if it is not free; confirm with Install.
5. The module then appears on Dashboard > Bot Modules alongside the built-in ones.

Installed extensions — bot modules included — are also listed under Store > Installed, where you can toggle auto-update and uninstall. Built-in modules cannot be uninstalled.

Module settings, logs, and errors

Each installed bot module has its own settings page with three sections:

• Configuration — the module's stored configuration values.
• Permissions & Triggers — a placeholder; there are no settings here.
• Diagnostics — links to View Logs and View Errors for that installation.

Logs

The log view lists the module's recent handler runs, newest first. Each line shows:

• Time
• Log level
• The handler that ran
• The log message

Filter buttons across the top narrow the list to All, DEBUG, INFO, WARN, or ERROR, and a Refresh button re-fetches the list. Logs appear once the module starts processing events.

Errors

The error view shows only failures. Two counters at the top give the Total Errors and the number of Unique Errors. Each entry lists the error message, the handler it came from, when it was last seen, and how often it occurred. Click an entry to expand its stack trace.

Turning a misbehaving module off

If a module is behaving badly — moderating the wrong messages, or posting too often — switch its on/off toggle off on Dashboard > Bot Modules. The change takes effect without restarting the bot, and the module's configuration is kept, so you can switch it back on once the problem is resolved.

Plans and permissions

• The four built-in modules are available on every plan.
• Bot modules installed from the Extension Store require a paid plan; they are switched off on the free plan.

Capability	Permission
Open Dashboard > Bot Modules, view a module's configuration, logs, and errors	bot-modules:read
Toggle a module on or off and change its configuration	bot-modules:edit
Browse the Extension Store	extension-store:read
Install a module from the store	extension-store:install
Uninstall a module	extension-store:uninstall

Without bot-modules:read, the Bot Modules entry does not appear in the sidebar.