Docs/Plugins

Autoreplies plugin

Automatically reply when messages match a trigger. Setup mirrors autoreactions: pick the reply text in the slash command, then finish the rule in a modal.

#Configuration

yaml
plugins:
  autoreplies:
    enabled: true
    config:
      rules:
        - id: 1
          channel_id: "*"
          response: "Welcome! Check #rules"
          trigger: contains
          match: "help"
          cooldown_seconds: 30
    overrides:
      - level: ">=50"
        config:
          can_add: true
          can_remove: true
          can_list: true
FieldDescription
rulesList of reply rules
idUnique rule ID
channel_idChannel ID, or * for all channels
responseMessage the bot sends (max 2000)
triggerevery_message, contains, starts_with, exact, or regex
matchText/regex to match (required unless trigger is every_message)
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

#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).
  • Bot messages are ignored and will not trigger rules.