Novrix Documentation

🔐 Permissions

Novrix uses Discord's native permission system — every action it takes is bound by the permissions you grant its bot role. There's no hidden capability that bypasses this.

Administrator — Optional, but Recommended

Administrator is not required. It's recommended because it guarantees every module works without you having to track individual permissions as new features ship. If you'd rather grant only what you're comfortable with, use the granular list below — Novrix will simply skip actions it doesn't have permission for and log why in your Action Log channel.

Per-Module Requirements

Why Each Permission Is Needed

⚖️ Moderation

Your case history and moderation team's activity, in one place.

• Case list — every warn/kick/ban/timeout with case ID, reason, moderator, and timestamp. Editable reasons.
• Top Moderators — who's been most active, useful for recognizing staff effort.
• Warning thresholds — configure auto-escalation (e.g., 3 warnings → auto-timeout, 5 → auto-ban).

🤖 AutoMod

Every automatic filter, independently toggled and tuned. See the full AutoMod Configuration reference for rule details.

• Enable/disable each filter: word filter, spam detection, caps filter, mention spam, link filter, invite filter, emoji spam, new-account detection.
• Set thresholds per rule (e.g., spam = 5 identical messages in 10 seconds) and choose the action (delete, warn, timeout, kick).
• Add bypass roles per-rule so staff or verified members aren't affected.
• A live incident feed shows recent AutoMod catches as they happen.

🚨 Anti-Raid

Raid detection thresholds and response actions. See Anti-Raid Configuration for the full settings table.

• Set the join threshold and time window that defines a "raid."
• Choose the response: kick, ban, or lock the server entirely.
• Set a minimum account age to auto-filter suspiciously new accounts.
• Pick an alert channel so your mod team is pinged the moment Anti-Raid triggers.

🛡️ Moderation Commands

Full suite of punishment tools with automatic case tracking, appeal support, and DM notifications to users. All actions are logged to your action log channel.

🚨 Anti-Raid Configuration

Anti-Raid watches for sudden spikes in server joins that indicate a coordinated raid. Configure thresholds, actions, and detection sensitivity from the dashboard.

How It Works

Novrix tracks how many members join within a rolling time window. If the join rate exceeds your threshold, Anti-Raid triggers — locking the server, kicking/banning newcomers, and alerting your mod team.

🤖 AutoMod Configuration

AutoMod automatically detects and acts on rule violations without moderator intervention. Each rule type is independently configurable.

Rule Types

Bypass Roles

Set roles that are exempt from AutoMod rules (e.g., Moderator, Verified Member). Bypass roles are configured per-rule.

# Example AutoMod configuration via /settings
/settings automod word-filter enable
/settings automod word-filter add-word "badword"
/settings automod spam threshold 5 window 10
/settings automod bypass-role @Moderators

🛡️ Moderation

Features

• Warnings with configurable auto-escalation thresholds
• Timeouts (native Discord timeout, 1 minute – 28 days)
• Kicks and bans, including temporary bans with auto-expiry
• Bulk message purge with user/content filters
• Channel lock/unlock and slowmode
• Full case tracking — every action gets a case ID, editable reason, and moderator attribution

Permissions

Kick Members, Ban Members, Manage Messages, Manage Roles, Timeout Members. See the full Permissions reference for why each is needed.

Commands

See the full Moderation Commands reference — /warn, /timeout, /kick, /ban, /purge, /lock, and more.

Example

# Warn a user, then check their history
/warn @User Spamming in #general
/warnings @User

Best Practices

• Set warning thresholds (Dashboard → Moderation) so repeat offenders escalate automatically instead of relying on staff to remember.
• Keep Action Logs on for Moderation events from day one — a full audit trail makes appeals and disputes much easier to resolve.
• Use /case and /reason to keep case notes accurate after the fact rather than re-issuing actions.

Common Issues

• Command fails silently: almost always a role hierarchy issue — Novrix's role must sit above the target user's highest role.
• Timeout won't apply: Discord caps timeouts at 28 days; longer durations aren't possible via the API.

🤖 AutoMod

Features

• Word filter, spam detection, caps filter, mention spam, link/invite filter, emoji spam, new-account filter
• AI-powered image scanning — OCR, QR/barcode detection, and logo/creator recognition to catch scam giveaway images and phishing screenshots, not just text
• Per-rule bypass roles and independent enable/disable per rule

Permissions

Manage Messages, Manage Channels, Send Messages.

Commands & Configuration

Configured primarily through the dashboard AutoMod page or /settings automod. See AutoMod Configuration for the full rule-type table.

Example

# Configure spam detection via /settings
/settings automod spam threshold 5 window 10
/settings automod bypass-role @Moderators

Best Practices

• Start with delete-only actions on new rules, watch the incident feed for a day, then escalate to warn/timeout once you're confident there are no false positives.
• Always add a bypass role for your moderators and any bots that post frequently (e.g., a stats bot).

Common Issues

• Messages aren't being deleted: confirm Novrix has Manage Messages in that specific channel — channel-level overrides can silently block it even if the server-wide permission is granted.
• Rule seems too aggressive: check the bypass role list — a common cause is forgetting to exempt a legitimate bot or announcement channel.

🚨 Anti-Raid

Features

• Join-rate monitoring with a configurable threshold and rolling time window
• Automatic response: kick, ban, or full server lock
• Minimum account age filter to catch mass-created throwaway accounts
• Optional temporary bump to Discord's server verification level during an active raid

Permissions

Kick Members, Ban Members, Manage Channels (server lock), Manage Roles (quarantine).

Configuration

See Anti-Raid Configuration for the full defaults table, or the dashboard Anti-Raid page.

Best Practices

• If you run giveaways or cross-server promotion that causes legitimate join spikes, raise your threshold (20–30 joins/30s) beforehand rather than reactively during the spike.
• Always set an alert channel — a raid response that fires with no one watching is far less useful than one your team can immediately verify and adjust.

Common Issues

• False positives during events: lower sensitivity temporarily before running giveaways, contests, or partnership pushes.
• Raid not detected: check the time window — a slow-drip raid (just under threshold, spread over minutes) can evade a tight window; widen it if you see this pattern.

🔍 Troubleshooting

Bot Not Responding

• Check status.novrixbot.com for active incidents
• Ensure the bot role has View Channel and Send Messages in the channel
• Try running /ping — if it responds, slash commands are working
• Re-invite the bot if slash commands stopped appearing (Discord sometimes de-registers them)

Permission Errors

• Move Novrix's bot role above the roles it needs to manage
• Check channel-level permission overrides — they override role permissions
• For voice channel actions, ensure Novrix has Move Members and Connect

Dashboard Not Saving

• Ensure you have Manage Server in the target guild
• Try refreshing the page and re-logging in
• Check the browser console for any network errors and report them to support