Docs/Plugins

Autoreplies plugin

Automatically reply when messages match a trigger. Dashboard setup mirrors persist for the reply payload (embeds, webhooks, link buttons, mention flags) plus the same match/limit controls as autoreactions.

#Configuration

yaml
plugins:
  autoreplies:
    enabled: true
    config:
      rules:
        - id: 1
          channel_id: "*"
          response: "Welcome! Check #rules"
          trigger: contains
          match: "help"
          cooldown_seconds: 30

Grant can_add, can_remove, and can_list to a Dreamliner Role on the dashboard's Roles page (or /permissions role grant) — see permissions.md.

FieldDescription
rulesList of reply rules
idUnique rule ID
channel_idChannel ID, or empty/* for all channels
responseOptional text above the embed (max 2000). Supports {user}, {guild}, {channel}
triggerevery_message, contains, starts_with, exact, or regex
matchText/regex to match (required unless trigger is every_message). Regex is case-insensitive. Whole word: \bhelp\b
every_nOnly reply on every Nth matching message
cooldown_secondsMinimum seconds between replies for this rule
attachments_onlyOnly messages with attachments
links_onlyOnly messages containing a link
reply_to_messageWhen true (default), reply to the trigger message. Ignored when webhook is on
embedSame embed options as persist (title, description, color, images, footer)
buttonsOptional link buttons (max 5)
webhookSend with a custom name/avatar (needs Manage Webhooks)
webhook_name / webhook_avatar_urlCustom webhook identity
silentSuppress notifications
suppress_embedsDon’t unfurl links in the text
mention_users / mention_roles / mention_everyoneAllowed mention types

#Commands

CommandPermissionDescription
/autoreply addcan_addRequires message, then opens a modal for trigger/send mode/channel/extras
/autoreply removecan_removeRemove a rule by ID
/autoreply listcan_listList all rules with IDs

#Add form

  1. Run /autoreply add message:… with the reply text
  2. Modal asks:
    • When should it reply? (dropdown)
    • Match text
    • How should it send? (radio: reply to the message, or send after the trigger)
    • Channel (optional)
    • Extras (cadence/filters)

#Requirements

  • The bot needs Send Messages (and Read Message History if using reply) in the target channel(s).
  • Webhook replies need Manage Webhooks. If a webhook cannot be created, Dreamliner falls back to sending as the bot.
  • Bot and webhook messages are ignored and will not trigger rules.