matrix-plugin/matrix.json.example

56 lines
1.4 KiB
Plaintext

{
// Matrix homeserver URL
"homeserver": "https://matrix.org",
// Bot user ID (e.g., @bot:server.org)
"userId": "@opencode-bot:matrix.org",
// Bot password for login (preferred over accessToken)
"password": "",
// Static access token (alternative to password)
"accessToken": "",
// Device ID for login
"deviceId": "opencode-matrix-plugin",
// Auto-join rooms the bot is invited to
"autoJoin": true,
// Message prefixes to trigger the bot.
// Empty array = all messages are processed.
// Configured = only messages with trigger/mention/thread-reply are processed.
"triggerPatterns": ["!oc "],
// Room IDs to completely ignore (messages not processed)
"ignoreRooms": [],
// User IDs to completely ignore (messages not processed)
"ignoreUsers": [],
// Allowlist of users who can interact with the bot.
// Empty = everyone allowed (subject to ignoreUsers).
"allowedUsers": [],
// Send HTML-formatted responses (requires marked package)
"formatHtml": false,
// Each Matrix thread gets its own isolated session
"threadIsolation": true,
// Reply to plain messages in active threads (follow-up mode)
"respondToThreadReplies": true,
// Per-user cooldown between messages (seconds)
"rateLimitSeconds": 5,
// Bot display name for @mentions
"botName": "opencode",
// Storage directory for bot state and crypto keys
"storagePath": "",
// Enable/disable the plugin
"enabled": true
}