Documentation

Darklock docs

Everything you need to set up, configure and run Darklock. For the full in-app command reference, use /help in your server.

Getting started

Add Darklock with the invite link, then run /setup start in your server. The guided setup center:

  • Shows permission, hierarchy, logging, verification, ticket, backup and plan readiness
  • Lets you configure anti-raid, anti-spam, anti-phishing, verification, welcome messages and tickets without the dashboard
  • Previews full server templates before creating anything and keeps existing roles, channels and overwrites by default

Darklock does not claim a setting or Discord object changed until the save or Discord operation is confirmed.

Core commands

Darklock uses 16 top-level slash commands plus one message context action:

  • /setup: guided server setup and reconfiguration
  • /config: quick settings, language, voice monitoring and runtime sync
  • /security: scans, incidents, audit logs, permission review and lockdown
  • /mod: warnings, timeouts, kicks, bans, cases, quarantine and channel controls
  • /ticket: private tickets, transcripts, staff controls and Pro ModMail
  • /roles: autorole, self-role, reaction-role and channel-access panels
  • /backup, /analytics, /xp, /community: operations and community tools
  • /info, /trust, /invite, /status, /help: information and assistance
  • /appeal: member appeal flow; Redact & Delete is the message context action
Legacy commands such as /admin, /automod, /anti-raid, /ban, /serverbackup and /trustscore are not registered. Use the canonical paths above or run /help.

Protection systems

Anti-raid

Monitors join velocity, account age and name patterns. When thresholds trip, the configured action runs automatically: the default is quarantine, which strips access but keeps the accounts in place for review. Lockdown mode can pause all joins until you release it.

Anti-nuke

Watches for mass channel/role deletion, mass bans, webhook floods and permission escalation. Offending accounts have their roles stripped immediately and the incident is logged. Whitelist trusted admins before doing planned bulk changes.

Anti-phishing & anti-spam

Messages are checked against the configured phishing and spam systems. Floods, duplicate messages and mention storms are rate-limited. Configure them through /setup anti-phishing, /setup anti-spam and /config change.

Verification

New members must pass a button or captcha challenge before receiving the verified role. Unverified accounts can be removed automatically after a timeout you set.

Tickets and appeals

Post a ticket panel with /ticket. Members click Open Ticket to get a private channel; staff can claim, prioritize and close with a saved transcript. Ban appeals arrive in your review channel with the original case attached. Approve or deny with one click, and the user is notified.

Multi-server moderation

Enterprise servers can be linked into a network from the dashboard under Setup → Multi-Server Moderation:

  • Link servers with a one-time code; unlink any time
  • Synced actions: bans and mutes propagate to linked servers after a staff member approves the network action
  • Watchlist: flag a user once and get an alert when they join any linked server
  • Exemptions: override any synced action per server
  • Network audit log: one timeline across the whole network

Dashboard

The web dashboard mirrors and extends the slash commands: toggle protection modules, edit thresholds and filters, browse the moderation case history, manage tickets and appeals, restore backups and view analytics. Sign in with Discord. Access follows your server permissions, and owners can grant scoped dashboard roles to staff.

Troubleshooting

  • Bot isn't responding: check status, then confirm Darklock's role is above the roles it needs to manage.
  • Commands missing: re-invite with the official link so the applications.commands scope is granted.
  • A filter is too aggressive: tune it with /setup, /config or the dashboard; review recorded actions with /mod cases and /security incidents.
  • Something else: ask in the support server or file a bug report.

Ready to try it?

Add Darklock, then run /setup start to choose your server settings.