Player Monitoring
Detects suspicious player behaviour — skywalking, underground glitches, duplication, boosting, and camping — and alerts admins via Discord.
What it does
The Player Monitoring module watches player position and activity data for patterns that indicate exploiting or cheating. When a suspicious event is detected, Vigil posts an alert to your configured Discord channel so admins can investigate in real time.
Detection runs automatically in the background — no manual review of logs required.
Detection types
| Detection | What it looks for |
|---|---|
| Skywalking | Player altitude is abnormally high relative to terrain — indicates flying or noclipping above the map |
| Underground | Player position is below the terrain surface — indicates ground clipping |
| Dupe Detection | Multiple rapid reconnects in a short window — a common indicator of item duplication |
| Boost Detection | Rapid object placement (fireplaces, garden plots) combined with altitude gain — indicates base boosting |
| Anti-Camp | Player remains within a tight radius over multiple position readings — flags stationary players for admin review |
Each detection type can be enabled or disabled independently.
Skywalking
Vigil monitors player altitude against the surrounding terrain. If a player is detected floating significantly above the map surface, an alert fires. There are two detection paths:
- Emote-triggered — Vigil begins watching a player's altitude when they use certain emotes associated with skywalk exploits
- Direct float — Player position is above terrain by the configured threshold without any prior trigger
When first flagged, a "possible skywalk in progress" alert posts. If the player remains elevated, a confirmed skywalk alert fires. If the monitored player disconnects during the watch window, a separate disconnect alert is posted.
Configuration
| Option | Description |
|---|---|
| Enable skywalking detection | Toggle this detection on or off |
| Altitude threshold (metres) | How far above terrain a player must be to trigger |
Underground detection
Vigil detects when a player's position drops below the terrain surface. This typically indicates ground-clipping through a base or structure.
Configuration
| Option | Description |
|---|---|
| Enable underground detection | Toggle this detection on or off |
| Depth threshold (metres) | How far below the surface triggers an alert |
Dupe detection
Vigil tracks connect events per player over a rolling time window. If the same player reconnects more than the configured number of times within that window, an alert fires — this pattern is consistent with item duplication methods that rely on rapid reconnecting.
Configuration
| Option | Description |
|---|---|
| Enable dupe detection | Toggle this detection on or off |
| Reconnect threshold | Number of connects within the window that triggers an alert |
| Time window (minutes) | The rolling window to count reconnects within |
Boost detection
Vigil monitors fireplace and garden plot placement events. If a player places multiple objects in rapid succession and gains altitude between placements, this is flagged as a boost attempt — a technique used to climb over base walls.
Configuration
| Option | Description |
|---|---|
| Enable boost detection | Toggle this detection on or off |
Anti-Camp
Vigil tracks the last 20 position readings for each player. If the most recent readings all fall within a tight radius of the centroid, the player is flagged as stationary and an alert is posted. This is useful for servers that prohibit extended camping in specific areas, or for identifying players who may be AFK exploiting.
The alert includes the player's coordinates, the radius spread across the readings, how many readings were used, and the duration covered.
A per-player cooldown prevents the same player from triggering repeated alerts in a short period.
Configuration
| Option | Description |
|---|---|
| Enable anti-camp | Toggle camping detection on or off |
| Radius (metres) | Maximum spread across readings to consider a player stationary (default: 75m) |
| Minimum readings | How many recent readings must be within radius to trigger (default: 3) |
| Cooldown (minutes) | How long before the same player can trigger another camping alert (default: 60) |
Auto-ban
Underground, skywalking, and boost detections support automatic banning. When enabled, Vigil issues a ban via Nitrado when the detection fires, without waiting for admin action.
| Option | Description |
|---|---|
| Auto-ban | Automatically ban the player when a detection fires |
| Ban duration (hours) | How long the ban lasts (0 = permanent) |
Auto-ban is irreversible until the ban expires. Test your thresholds carefully before enabling — false positives will result in legitimate players being banned.
Discord alerts
Each alert includes the player's gamertag, the detection type, coordinates, and a timestamp. Alerts are posted as embeds with colour-coded detection types so different violations are visually distinct at a glance.
Suggested Discord channel
#admin-alerts or #player-monitoring — keep this channel private to admins only.