Manage Settings

All configuration in FirewallX is managed from the web dashboard. There are no public slash-commands for editing settings.


Access the Dashboard

  1. Open the FirewallX dashboard and sign in with Discord.

  2. Pick the server (guild) you want to configure from the server list.

  3. You must have Administrator on that server to change settings.

If a server doesn’t appear, make sure the bot is invited to it and the OAuth permission “Manage Server” was granted during login.


Global Controls (per-guild)

From the server home in the dashboard you can:

  • Enable/Disable modules you need.

  • Choose a default log channel or per-module log channels.

  • Select interface language (Arabic / English) and RTL/LTR layout.

  • Manage Premium (trial, plan, and premium-only toggles).

Changes are saved to the database (MongoDB) and apply immediately.


Modules & What You Can Configure

Anti-Nuke

Protects against mass destructive actions.

  • Triggers: rapid bans/kicks, role deletions, channel deletions, dangerous guild edits.

  • Thresholds: maximum actions allowed within a time window before protection activates.

  • Punishment: remove roles / timeout / kick / ban for the attacker account.

  • Safelists: exempt trusted users/roles (e.g., other security bots or staff).

  • Logs: send detailed events to the selected log channel.

See the Anti-Nuke section for details on triggers, limits, and punishments.

Anti-Raid

Mitigates join floods and coordinated raids.

  • Join-rate limit: number of joins allowed per time window.

  • Auto-lock: temporarily lock new joins when a raid is detected.

  • Verification gate: optionally require passing the verification step before access.

  • Logs: detection and actions are recorded.

Moderation (Spam/Swear/Filters)

Automated moderation helpers.

  • Spam sensitivity: repeated messages, mentions, or links.

  • Profanity / word filters: optional rulesets and custom keywords.

  • Escalation: warn → timeout → kick/ban (configurable).

  • Whitelists: exempt roles/channels (e.g., staff channels).

  • Logs: all actions recorded.

Verification

Controls how members verify before interacting.

  • Method: button/captcha flow (as configured in your dashboard).

  • Verified role: role granted after successful verification.

  • Message & retry limits: customize the prompt and how many attempts are allowed.

  • Logs: attempts and results are recorded.

Tickets

Support ticket system for your community.

  • Categories / panels: create open buttons per category.

  • Staff roles: who can see and reply.

  • Auto-close: close inactive tickets after a duration.

  • Transcripts: save transcripts to a channel (and files if enabled).

Threat-Intelligence (TI)

Live checks against unsafe patterns.

  • Policies: choose Strict / Balanced / Custom.

  • Feeds: badDomains, suspicious name patterns, link detection, and custom entries.

  • Link Whitelist: allow specific domains/URLs to bypass link blocks.

  • Custom Policy: add your own TI rules per guild.

  • Logs: any block/allow decision is logged.

Whitelists (Access)

Fine-grained exemptions.

  • Users / Roles / Channels: exempt from certain checks or punishments.

  • Use cases: allow a bot role to manage channels, or allow a staff channel to post external links.


Logs & Premium (Deep Audit Logs)

Standard Logs

  • Every module can post rich logs to its assigned channel.

  • Logs include actor, target, action, reason (when available), and contextual fields.

Deep Audit Logs (Premium)

  • Hash-chained per guild (SHA-256 chain).

  • Each event stores a requestId and the previous event’s hash to ensure log integrity.

  • Tamper-evident: any modification breaks the chain.

  • Designed for long-term auditing and dispute resolution.

Premium can be started with a 14-day free trial. Plans are per guild.


Saving & Applying Changes

  • Save in each section when you modify settings; changes apply instantly.

  • If logs don’t appear, confirm:

    • The bot can see and send messages in the selected log channel.

    • The correct channel is selected per module (not a single static channel).

    • No role hierarchy blocks the bot from moderating.


Troubleshooting

  • Settings not showing up? Hard refresh the dashboard and reselect the server.

  • Can’t change settings? Ensure your Discord account has Administrator on that server.

  • Module doesn’t trigger? Check its toggle, threshold, and whitelists.

  • Link blocked by mistake? Add it to Threat-Intelligence → Link Whitelist.


Summary

Use the dashboard to manage everything: enable modules, tune thresholds, set punishments, pick log channels, build whitelists, and—if you’re on Premium—record an immutable Deep Audit Log for your guild.