Zone Alerts
Players and factions set personal alert zones. Any player who enters triggers an instant Discord alert.
What it does
Zone Alerts lets your players and factions define their own personal zones on the map. When any other player enters that zone, Vigil fires an instant alert to a dedicated Discord channel — acting as a proximity alarm for bases, stashes, or any area a player wants to watch.
Unlike server-wide safezones or admin-defined build zones, these are player-controlled. Each player or faction manages their own zones from their Vigil profile.
How it works
- A player or faction creates a zone from their Vigil profile page — they set a name, coordinates, and radius
- Vigil creates a dedicated Discord webhook channel for that zone
- When another player's position is detected inside the zone boundary, Vigil fires an alert to that channel
- The player who owns the zone sees the alert in Discord in real time
Position data is read from your server's .ADM log, which records player positions every few seconds during gameplay.
Zone types
Personal zones
Zones created by individual players. Only that player receives the alerts (via their zone's Discord channel).
Faction zones
Zones created by a faction (requires Factions to be set up). All faction members receive alerts. Faction members inside the zone do not trigger alerts — only outsiders do.
Configuration options (server-level)
These settings apply to all zones on your server:
| Option | Description | Default |
|---|---|---|
| Show location | Include a clickable map link in the alert | Off |
| Show distance | Include how far the intruder is from the zone centre | On |
| Alert on leave | Post when a player exits the zone | Off |
| Alert on disconnect | Post if a player disconnects while inside the zone | Off |
| Alert cooldown | Minimum minutes between repeated alerts for the same player in the same zone | 5 minutes |
Ignore lists
Each zone can have an ignore list — a set of gamertags that will not trigger alerts for that zone. This is managed per zone from the zone settings.
Suggested Discord channel
Zone alerts post to a per-zone channel that Vigil manages. These are typically private channels that only the zone owner (or faction) can see. The overall module should have its base webhook in a #zone-alerts admin channel, but individual zone alerts go to their own channels.
Encourage your players to set up zones around their bases as part of your server's feature set. It adds a meaningful layer of strategic play — knowing when someone is scouting your base can change the game entirely.