AutoMod Rules

From the dashboard sidebar, click Arkanis AutoMod. The page lists every rule with status (Enabled/Disabled), trigger type, action, mode, and recent-match count. If you haven't built any rules yet, an empty state offers a prompt to create your first.

The number of rules you can create depends on your plan:

Click Create Rule at the top of the AutoMod page to open the rule builder. The builder is organized into four sections: Basic, Trigger Type, Action Type, and Advanced.

• Rule Name — Max 100 characters. Use something descriptive like "Block Slurs" or "No Invite Links"
• Description — Max 500 characters. Optional context for other staff
• Priority — Numeric. Higher priority rules evaluate first when a message could match multiple
• Mode — Log Only records matches without taking action, Live applies the configured action
• Enabled — Toggle on/off without deleting the rule

Matches messages that contain banned words or phrases. Options:

• Preset packages — Hate speech, Harassment, Sexual explicit, NSFW, Profanity. Check any combination
• Allow swearing toggle to keep general profanity but block targeted hate
• NSFW server toggle to relax content rules appropriately
• Custom words list — Add your own words or phrases

Matches a list of regular expressions. A Test Input field lets you paste a sample message and see if it matches before saving, which catches broken patterns early.

Fires when a user sends too many messages too quickly.

• Max messages — Default 5
• Window seconds — Default 10

Triggers when a single message contains too many mentions.

• Max mentions — Default 5

Flags messages that are mostly uppercase.

• Min length — Default 8 (messages shorter than this are ignored)
• Max percent — Default 70 (the percentage of characters that can be uppercase before the rule fires)

Controls which URLs are allowed.

• Block all links toggle for a total blackout
• Blocked domains list for specific bans
• Allowed domains list for an allowlist-only approach

Blocks all Discord invite links. No additional configuration needed.

Triggers when a user repeats the same message too often.

• Max duplicates — Default 3
• Window size — Default 10 messages

Fires when a message contains too many emojis.

• Max emojis — Default 10

Fires when a message contains too many file attachments.

• Max attachments — Default 5

Removes the offending message.

• Reason — Optional text logged for context

Sends a formal warning to the user and records it.

• Reason code — Structured category
• Reason text — Human-readable explanation shown to the user

Times out the user for a configurable duration.

• Duration (minutes)
• Reason text

Issues a strike through the enforcement system.

• Category
• Severity — Minor or Major
• Reason text

Bans the user. Use sparingly and pair with Log Only first to catch false positives.

• Category
• Reason
• Discord ban toggle — On = also bans from Discord itself, Off = records in Arkanis only

Prevent the rule from firing against certain users or in certain places:

• Exempt Roles — Multi-select. Members with any of these roles are skipped
• Exempt Channels — Multi-select. The rule never fires in these channels

• Case Sensitive toggle — Default off (e.g., "SPAM" matches "spam")
• Word Boundary toggle (word filter only) — On matches whole words, Off matches substrings
• Allowlist Words — Words that prevent a rule from firing even if other patterns match

• DM on Trigger toggle — Send the user a private message explaining the rule
• Per-User Cooldown (seconds) — Minimum gap between triggers for the same user
• Per-Channel Cooldown (seconds) — Minimum gap between triggers in the same channel

On the AutoMod page, click Simulate Rule. The simulator lets you test a rule end-to-end without affecting real users.

• Select the rule from the dropdown
• Enter a test message into the input field
• Click Simulate

The result shows either "Matched" with a breakdown of what action would have been taken, or "No match" with the reason. Try both positive and negative samples to catch false positives early.

Every rule card on the AutoMod page has a quick Enabled toggle so you can pause a rule without deleting it. Click a card to open the builder again with every setting pre-populated. Changes apply immediately; no restart or re-deploy needed.

Each card shows the number of recent matches and the last-fire timestamp. Use these to spot noisy rules (firing too often) and silent rules (never firing, probably misconfigured).