Pulsify

Lightweight server monitoring SDK for Minecraft. Captures errors, tracks player events and custom metrics, and ships them to the Pulsify backend — across Paper, BungeeCord, and Velocity.

⚙️ Features

• 🐛 Automatic error capture via Log4j2 or JUL with stack traces
• 📊 Custom metrics with optional label support
• 👤 Player join/quit event tracking
• 💓 Periodic server heartbeats with server and plugin info
• 📦 Batched event queue with configurable flush intervals
• 🔌 Multi-platform: Paper, BungeeCord, Velocity (mod support coming soon)

🚀 Quick Start

Initialize the client once during plugin startup:

StatClient client = StatClient.builder()
    .dsn("your-dsn-here")
    .autoCollectErrors(true)
    .build();

Capture errors and metrics manually:

// Report a caught exception
client.error("my-plugin", exception);

// Send a custom metric
client.metric("tps", server.getTPS()[0]);

Close the client on shutdown to flush pending events:

client.close();

📦 Building

To build Pulsify, follow these steps (Make sure you have JDK 17 or higher):

./gradlew build

• Platform jars will be located at platforms/<platform>/build/libs/.

⚖️ License

Pulsify SDK is licensed under the GNU General Public License v3.0. You can find the license here.