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

1. Drop the SessionTracer.jar into your /plugins/ folder.
2. Restart your server.
3. 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!)