public class VelocityNexAuth {
    private final ProxyServer server;
    private final AuthProvider authProvider;
    private final SessionManager sessionManager;
    
    @Subscribe
    public void onPlayerJoin(PostLoginEvent event) {
        Player player = event.getPlayer();
        
        // Authenticate before server transfer
        AuthResult result = authProvider.authenticate(player);
        
        if (result.isSuccess()) {
            // Create session for backend servers
            Session session = sessionManager.createSession(player);
            
            // Transfer to backend server
            player.createConnectionRequest(server.getServer("lobby"))
                   .fireAndForget();
        } else {
            // Handle authentication failure
            player.disconnect(Component.text("Authentication failed"));
        }
    }
}

# velocity.toml
[server-config]
# Forward player info to backend servers
player-info-forwarding = "modern"

[servers]
# Configure backend servers
lobby = "127.0.0.1:25566"
survival = "127.0.0.1:25567"
creative = "127.0.0.1:25568"

[plugins]
# NexAuth handles authentication
# Backend servers should NOT have auth plugins

# NexAuth config (Velocity)
# Premium authentication is automatically detected
online-mode=false

# Backend server settings
backend-auth-required=true
session-timeout=604800

public class PaperNexAuth extends JavaPlugin {
    private AuthManager authManager;
    private SessionManager sessionManager;
    
    @Override
    public void onEnable() {
        // Initialize authentication
        authManager = new AuthManager(this);
        sessionManager = new SessionManager(this);
        
        // Register commands
        registerCommands();
        
        // Register events
        registerEvents();
    }
    
    @EventHandler
    public void onPlayerJoin(PlayerJoinEvent event) {
        Player player = event.getPlayer();
        
        if (isBackendMode()) {
            // Verify proxy session
            verifyProxySession(player);
        } else {
            // Handle standalone authentication
            handleStandaloneAuth(player);
        }
    }
    
    @EventHandler(priority = EventPriority.LOWEST)
    public void onPlayerLogin(AsyncPlayerPreLoginEvent event) {
        // Pre-login authentication check
        String username = event.getName();
        
        if (!authManager.isRegistered(username)) {
            // Allow new player
            return;
        }
        
        // Check if player can authenticate
        if (!authManager.canAuthenticate(username)) {
            event.disallow(AsyncPlayerPreLoginEvent.Result.KICK_OTHER, 
                          "Authentication required");
        }
    }
}

# server.properties (Paper)
online-mode=false  # NexAuth handles authentication
server-port=25566

# paper.yml (if needed)
settings:
  velocity-support:
    enabled: true  # If using Velocity
    secret: "shared_secret"

# NexAuth config (Paper)
# Platform is auto-detected, no mode setting needed

# Authentication settings
auto-register=false
max-login-attempts=-1

# Session management
session-timeout=604800
hide-player-inventory=true

// Access Velocity-specific features
ProxyServer server = NexAuthVelocity.getProxy();

// Player management
Player player = server.getPlayer(username);

// Server transfer
player.createConnectionRequest(server.getServer("lobby"))
       .connect()
       .thenAccept(result -> {
           // Handle transfer result
       });

// Messaging
server.sendMessage(Component.text("Authentication successful"));

// Access Paper-specific features
JavaPlugin plugin = NexAuthPaper.getPlugin();

// Player management
Player player = Bukkit.getPlayer(username);

// World management
World world = player.getWorld();
Location location = player.getLocation();

// Scheduler
Bukkit.getScheduler().runTaskLater(plugin, () -> {
    // Delayed task
}, 20L);  // 1 second delay

# Optimize for high player counts
# These are internal optimizations handled by NexAuth
# No manual configuration needed

# Optimize for server performance
# These are internal optimizations handled by NexAuth
# No manual configuration needed

# Enable debug mode (add to server startup)
-Dnexauth.debug=3

# Enable debug mode (add to server startup)
-Dnexauth.debug=3