Monitoring & Integrations
TPS Monitor
Watches server TPS and applies graduated optimization levels — each threshold can chain a different action (reduce spawn rate, lower view distance, force clearlag, ...). When TPS recovers, the changes are reverted automatically.
| Threshold | Example action |
|---|---|
18 TPS | Reduce spawn rate |
16 TPS | Reduce view / simulation distance |
14 TPS | Trigger emergency clearlag |
The thresholds and actions are fully configurable in config.yml. Auto-recovery restores normal settings once TPS climbs back above all thresholds.
Web Dashboard
XAntiLag registers a module with XCore's web panel exposing JSON endpoints for remote monitoring.
| Endpoint | Returns |
|---|---|
GET /api/xantilag/status | Feature toggles, TPS (1m / 5m / 15m), entity count, loaded chunks, online players, low-TPS mode flag |
GET /api/xantilag/chunks/top | Top 10 most expensive loaded chunks with full breakdown |
GET /api/xantilag/stats | Clearlag timing and stacker configuration |
- Token auth — Same Bearer token as XCore's web panel
- Rate limiting —
30requests per minute per IP - Folia-safe — Chunk endpoint samples each chunk on its owning region thread
PlaceholderAPI
| Placeholder | Description |
|---|---|
%xantilag_afk% | Returns (AFK) if the player is AFK, empty otherwise |
%xantilag_isAfk% | Returns yes or no |
%xantilag_clearlag% | Time remaining until next scheduled clearlag |