SessionTracer
A blazing-fast, fully asynchronous anti-alt account plugin for Paper servers.
A blazing-fast, fully asynchronous anti-alt account plugin for Paper servers.
SessionTracer allows you to control IP limits, whitelist players, and notify your staff—all with zero impact on your server's main thread.
Features
- Zero Lag: 100% async SQLite database operations powered by Caffeine caching.
- Smart Alerts: Real-time staff notifications when known alt accounts join.
- Interactive Whitelist: Manage allowed alts easily via clickable chat buttons.
- Live-Reloads: Adapts to new IP limits and configuration changes on the fly.
Installation
- Drop the SessionTracer.jar into your /plugins/ folder.
- Restart your server.
- Configure your limits and messages in the generated config.yml.
Note for Proxy Users: Ensure IP-Forwarding is correctly configured (e.g., Velocity, BungeeCord, TCPShield) so the plugin reads the actual player IPs.
Commands & Permissions
Staff members require the trace.alert permission to receive alt warnings in chat.
- /trace reload - Reloads the config and applies new limits instantly.
- /trace whitelist - Shows whitelisted players (with an interactive [DELETE] button).
- /trace whitelist add <Player> - Bypasses the IP limit for a specific player.
- /trace whitelist remove <Player> - Removes a player from the whitelist.
Developer API
SessionTracer fires an asynchronous DuplicateSessionEvent immediately before a player joins. You can listen to this event in your own plugins to trigger custom actions, such as sending Discord webhooks.
(The plugin is designed with extensibility in mind. Check the source code for easy ways to implement custom DataSources!)
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
SessionTrace is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 10 times (via Spigot). Download it and open it directly in the game.