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
- In Discord: Server Settings → Integrations → Webhooks → New Webhook.
- Pick the channel (a private staff channel — alerts name players).
- 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.