The LeavePulse Agent is designed to run on modern Minecraft platforms with minimal performance overhead.
System Requirements
- Java: 21 or newer.
- Network: Outbound access to
api.leavepulse.com(ports 80, 443). - Platforms:
- Paper, Spigot, Folia (1.20.1+ recommended)
- Velocity 3.3.0+
- BungeeCord / Waterfall
- Fabric / NeoForge (latest versions)
Bedrock & Geyser Support
The Agent has built-in support for Bedrock players when using Geyser and Floodgate:
- Nickname Resolution: The Agent correctly handles Bedrock prefixes (e.g.,
.playeror+player) during whitelist checks. - Account Linking: Bedrock players can complete the linking process just like Java players.
Placeholders
The Agent provides a set of placeholders for use in chat, tabs, and scoreboards via MagicUtils.
| Placeholder | Description |
|---|---|
%playtime_total% | Player's total time on this server (local data). |
%playtime_session% | Current session duration. |
%verified_playtime_total% | Verified total time from LeavePulse dashboard (synchronized). |
%verified_status% | Player's account verification status. |
Platform Specifics
Velocity
Unlike other proxies, the Velocity Agent doesn't just show the proxy version. It analyzes the versions of all connected backends to form a version range, making your catalog page more informative.
Bukkit (Shared Runtime)
For large projects with MagicUtils already installed, we recommend using the "thin" Agent artifact. This reduces memory usage and prevents library duplication in the JVM.
MOTD & Favicon
The Agent automatically reads your server's MOTD and icon. If you use dynamic MOTD plugins, the Agent will report the current state in every telemetry snapshot.