The LeavePulse whitelist is an integrated system that automates server access based on website applications.
Enforcement Modes
Choose how the Agent reacts to unauthorized players in the server settings on the dashboard:
- Kick: The player is instantly disconnected upon join. This is the lowest-impact mode for server performance.
- Restrict: The player can join, but the Agent blocks:
- Block/item interaction.
- Chat messages.
- Most commands.
- Movement (optional).
Importing Existing Lists
If you already have a player base, you can migrate it to LeavePulse.
/whitelist import Command
Upload a local whitelist.json (vanilla format) directly to the LeavePulse database.
- Obtain an Import Token from the server settings on the website.
- Run the command in the console:
text
/whitelist import <token> - The Agent reads player names and UUIDs and submits them to create Approved applications.
Synchronization
The Agent uses a hybrid sync approach:
- WebSocket (Push): When an application is approved on the website, LeavePulse sends an instant signal to the Agent.
- Auto-Refresh: Every 60 seconds (configurable in
whitelist.refresh_interval_seconds), the Agent polls the HTTP API for updates. - Manual Sync: Force a full list update using
/whitelist sync.
In-Game Moderation
Manage applications without leaving the game:
/whitelist list pending: List players awaiting review./whitelist find <query>: View a player's application details./whitelist find <query> approve [reason]: Approve an application directly from chat.