Discord Webhooks
How to create Discord webhook URLs for your Vigil modules.
Each Vigil module posts to Discord using a webhook URL. A webhook is a simple link that lets an external service post messages into a specific Discord channel. You create one per channel, and then paste it into the module's configuration in Vigil.
Creating a webhook
- Open Discord and go to the server where you want events posted
- Right-click the channel you want to receive events (e.g.
#killfeed) - Click Edit Channel
- Go to the Integrations tab
- Click Webhooks, then New Webhook
- Give it a name (this becomes the default bot name — you can override it in Vigil)
- Click Copy Webhook URL
- Paste that URL into the relevant module's Webhook URL field in Vigil
You can use the same webhook URL in multiple modules if you want all events in one channel. Most server owners prefer one channel per module (e.g. separate channels for killfeed, connections, and admin alerts).
Recommended channel setup
Here's a typical Discord channel structure for a Vigil-powered server:
| Channel | Module(s) |
|---|---|
#killfeed | Kill Feed |
#deathfeed | Death Feed |
#connections | Connect Feed, Disconnect Feed |
#base-activity | Build Feed, Dismantle Feed |
#leaderboards | Leaderboards, Player Stats |
#economy | Economy (transaction alerts) |
#bounties | Bounty System |
#safezone-alerts | Safezone Enforcement, PVE Safezone |
#admin-alerts | Alt Detection, XML Detection, JSON Detection |
#announcements | Scheduled Announcements, Restart Feed |
#achievements | Achievements |
You don't need all of these — just set up the ones for the modules you're using.
Webhook permissions
Make sure the webhook has permission to Send Messages and Embed Links in the target channel. These are enabled by default for most channels.
If you're posting to a private or restricted channel, double-check that the webhook integration is allowed in that channel's permissions.
Updating a webhook URL
If you delete a webhook and create a new one, just paste the new URL into the module's settings in Vigil and save. There's no reconnection process — Vigil uses the URL directly each time it posts.