Skip to content
SCULKANTICHEAT

Discord Webhook Setup

Your staff already live in Discord. Sculk pushes alerts and ban-wave summaries there so detections reach humans even when nobody's in-game. Premium and Network feature.

Create the webhook

  1. In Discord: Server Settings → Integrations → Webhooks → New Webhook.
  2. Pick the channel (a private staff channel — alerts name players).
  3. Copy the webhook URL.

Configure Sculk

discord:
  enabled: true
  webhook-url: "https://discord.com/api/webhooks/…"

  alerts:
    # Push alerts at or above this VL. Keep this higher than the
    # in-game threshold — Discord should get signal, not noise.
    min-vl: 15
    # Batch window (seconds): multiple alerts for the same player
    # collapse into one message.
    batch-window: 30

  banwave:
    # Post a summary after each wave: who, which checks, evidence links.
    summary: true

Reload with /sculk reload, then test:

/sculk webhook test

You should see a test embed in the channel within a few seconds.

What gets posted

  • Alerts — player, check, VL, and a one-line evidence summary, colour-coded by severity.
  • Ban-wave summaries — the wave's player list with per-player check totals, posted after the wave executes.

Troubleshooting

Nothing arrives. Run /sculk webhook test. A 401/404 in console means the URL is wrong or the webhook was deleted; recreate it. A 429 means Discord is rate limiting — raise batch-window.

Too noisy. Raise discord.alerts.min-vl. In-game alerts can stay sensitive while Discord only sees serious cases.

Player names must stay private. Point the webhook at a channel only staff can read; webhook posts inherit no Discord permissions of their own.