Skip to content

Auto-Reactor

✨ Introduced in Frogge v1.0

Auto-Reactor automatically adds an emoji reaction to messages that match rules you set up: by channel, a keyword, an author's role, or any combination of the three. Available on both Discord and the Dashboard.

Quick Start

  1. Run /admin menu → Utilities → Auto-Reactor → Add: a blank rule is created immediately and its detail screen opens.
  2. Set any combination of Channel, Keyword, and Author Role to narrow which messages match; leave any of them unset and that condition matches anything.
  3. Set Emoji: type a standard emoji directly, or use Pick a Server Emoji for one of your server's own custom emoji.

  1. Open Auto-Reactor, fill in the blank row at the bottom - Channel, Keyword, Author Role, and Emoji (only Emoji is required) - then + Add Rule.
  2. Every rule is its own editable row right on the page: change any field and hit that row's own Save, or Remove to delete it.
  3. Toggle Enabled at the top of the page (with its own Save) to turn every rule on or off at once.

The Auto-Reactor page in the Dashboard, showing the Enabled toggle, a rule count, one existing rule row, and a blank row to add a new one.

Full reference

Creating & editing a rule

A rule has four independently-editable fields; only Emoji is required, everything else is optional and defaults to "match anything":

  • Channel: restricts matching to one channel.
  • Keyword: a case-insensitive substring match against the message's content.
  • Author Role: restricts matching to members who hold this role.
  • Emoji: the reaction added when the rule matches.

All of a rule's set conditions have to match together (Channel and Keyword and Author Role, not any one of them) for it to fire. Every rule is checked independently against every message, so a single message can pick up more than one reaction if it matches more than one rule. Bot messages are never matched. Up to 2 rules per venue (10 on premium).

Seeing it in action

The rule from the Quick Start above (#posting-pond, author with the @Discord Queen role has said 'ribbit', 🐸 emoji) firing on a real message that matches both conditions:

A message in Discord that matched an Auto-Reactor rule, with a 🐸 reaction added automatically.

Settings

/admin menu → Utilities → Auto-Reactor → ⚙️ Settings has one toggle:

Auto-Reactor Enabled. When off, no rules fire at all, regardless of how many exist.

  • Standalone: doesn't connect to any other module.