LeavePulse Diagnostics is a built-in self-check system that analyzes the Agent's health and its connectivity to the platform.
Running Diagnostics
Use this on Paper, Spigot, Folia, Fabric, or NeoForge server builds.
Diagnostics export
/leavepulse diagnostics exportShort alias: /lpa
This command creates a detailed JSON report saved at:
plugins/LeavePulseVerified/diagnostics/latest.json
Core Check Areas
1. Gateway
Verifies the WebSocket session activity.
- Missing Token: Agent lacks a token. Fix: run
connect. - Expired Token: Token is no longer valid. Fix: The Agent usually refreshes this automatically; if not, relink.
- WebSocket URL: Verification of the gateway address (
wss://...).
2. Network
Verifies LeavePulse service reachability from your server.
- DNS Resolution: Whether the server can resolve
api.leavepulse.com. - TCP Reachability: Whether a firewall is blocking outbound connections on ports 80/443.
3. Enrollment
Crucial security step where the Agent generates signing keys.
- Missing Environment ID: Environment is not yet registered.
- Key Mismatch: Local keys don't match what the website expects.
4. Whitelist
- Binding Check: Whether the Agent knows which web whitelist form to use.
- Sync Status: Last successful player list synchronization state.
Common Errors and Fixes
| Message | Action Hint |
|---|---|
malformed token | Relink your server (/leavepulse connect). |
endpoint unreachable | Check outbound traffic or contact your hosting provider. |
missing server_id | Agent is not linked. Run connect. |
filesystem read-only | Grant the Agent write permissions to the plugin folder. |
Diagnostic Suites
Run targeted checks for specific modules without exporting a file:
/leavepulse diagnostics suite leavepulse.network— Network status./leavepulse diagnostics suite leavepulse.whitelist— Whitelist status./leavepulse diagnostics suite leavepulse.gateway— Gateway status.