SessionGuard
A Minecraft plugin for Paper/Folia servers that prevents session conflicts when players log in from multiple locations.
Install / Use
/learn @snowopard/SessionGuardREADME
SessionGuard - Folia Plugin
<!-- A Minecraft plugin for Paper/Folia servers that prevents session conflicts when players log in from multiple locations. -->Features
- ✅ Folia Compatible: Fully supports Folia's multithreaded architecture
- ✅ Session Conflict Prevention: Detects and handles duplicate logins
- ✅ Graceful Reconnection: Allows reconnection within configurable time window (default: 2 seconds)
- ✅ Thread-Safe Operations: Uses Folia's schedulers for safe player operations
- ✅ Configurable Messages: Customize kick and error messages
- ✅ Comprehensive Logging: Detailed logging options for debugging
- ✅ Permission Support: Secure command access control
Installation
- Download the latest
SessionGuard.jarfrom the releases page - Place it in your server's
plugins/folder - Restart your server
- Configure
plugins/SessionGuard/config.ymlas needed
Configuration
Edit plugins/SessionGuard/config.yml:
reconnect-delay: 2 # Seconds to allow reconnection after kick
kick-messages:
duplicate-login: "You were disconnected because you logged in from another location."
error: "Unable to resolve session conflict. Please try again."
logging:
enabled: true
verbose: false
