Bot Modules

Bot modules automate chat moderation and messaging. Lumio provides four built-in modules (link protection, spam protection, word filter, and timed messages) and supports community-developed extension bot modules installed from the Extension Store.

Built-in Modules

Built-in modules are available on the Pro plan. Configure them under Dashboard > Bot Modules.

Module	Description
Link Protection	Detects and moderates messages containing links. Configurable domain whitelist and action (delete, timeout, warn).
Spam Protection	Detects repeated messages, excessive caps, and other spam patterns. Configurable thresholds and actions.
Word Filter	Filters messages containing blocked words or regex patterns. Configurable action and warning message.
Timed Messages	Sends automatic messages at configured intervals when chat activity meets a minimum threshold.

Each module supports:

• Enable/disable toggle per account
• Module-specific configuration (thresholds, actions, messages)
• Exempt roles — bypass enforcement for moderators, VIPs, and/or subscribers

Extension Bot Modules

Extension bot modules are community-developed modules available in the Lumio Extension Store. They extend the built-in moderation and automation capabilities with custom logic.

Installing an Extension Bot Module

1. Open the Extension Store from the dashboard sidebar.
2. Browse or search for bot modules (category: Bot Module).
3. Select the module and review its description, permissions, and configuration options.
4. Click Install and fill in any required configuration fields.
5. The module appears under Dashboard > Bot Modules alongside built-in modules.

Configuring Extension Bot Modules

Extension bot modules appear in the same Dashboard > Bot Modules page as built-in modules. Each module has:

• Enable/disable toggle — turn the module on or off without uninstalling
• Configuration form — settings defined by the extension developer (e.g., thresholds, response messages, target channels)
• Trigger overrides — customize command prefixes, keyword lists, or regex patterns without editing the extension code
• Exempt roles — the same moderator/VIP/subscriber exemption system as built-in modules

Viewing Logs

Monitor what an extension bot module is doing in your account:

1. Go to Dashboard > Bot Modules.
2. Select the extension module.
3. Open the Logs tab to see recent execution entries.

Each log entry shows:

• Timestamp
• Log level (info, warn, error)
• Trigger type (command, keyword, pattern, event, timer, moderate)
• Message summary
• Execution time

Viewing Errors

If an extension bot module encounters errors:

1. Go to Dashboard > Bot Modules.
2. Select the extension module.
3. Open the Errors tab to see recent failures.

Error entries include the error type, message, and stack trace. Common error types:

Error Type	Description
handler_timeout	The handler exceeded the 10-second execution limit
handler_error	The handler threw an uncaught exception
egress_blocked	The handler attempted to fetch a URL not in the allowlist
rate_limited	The handler exceeded its rate limit

Kill Switch

If an extension bot module is misbehaving (e.g., banning users incorrectly, spamming chat), use the kill switch to disable it immediately:

1. Go to Dashboard > Bot Modules.
2. Find the misbehaving module.
3. Click the Kill button (or toggle the module off).

The kill switch disables the module's triggers instantly. No bot restart is required. The module's configuration is preserved so it can be re-enabled after the issue is resolved.

Plan Restriction

Extension bot modules require the Pro plan, the same requirement as built-in custom bot modules.