banner

PremiumBridge

PremiumBridge is a smart offline/online session manager for offline-mode Paper/Purpur servers.

Designed for servers that must stay offline (so offline players can join), while giving online players a clean, vanilla-like experience.

🎯 What makes it different

Feature	Benefit
Session-aware verification	Checks online via Mojang sessions, not just nicknames
Smart identity linking	Intelligently connects offline/online UUIDs
Data migration	Moves offline inventory/stats to online profile
Known player protection	Remembers verified online accounts
Auto-login	Seamless login to auth plugins
Auto-registration	Optional one-click online registration
Hidden messages	No auth-plugin spam for online users

Server stays offline ✅ Offline players join normally

Online players get:

Online players might never notice the registration system exists.

PremiumBridge supports Velocity but does not require it. To turn on velocity support you should:

Put PremiumBridge-Velocity.jar into Velocity/plugins/.
Put PremiumBridge.jar into the plugins/ folder of every Paper or Purpur backend.
In velocity.toml, enable online-mode = false and player-info-forwarding-mode = "modern".
Enable native Velocity forwarding in config/paper-global.yml and use the same forwarding.secret.
Start Velocity once, copy the generated shared-secret from plugins/PremiumBridge/velocity.properties, and set it as premium-verification.velocity-modern.shared-secret in the backend config.
Set premium-verification.mode to velocity-modern and fully restart Velocity and the backend.

The complete setup is available in github. Spigot does not support this modern forwarding mode.

Mode	Description
`disabled`	No data migration
`automatic`	Auto-migrate before player spawns
`ask-player`	Player chooses via clickable chat buttons

Reconnect-based for reliability — player re-joins after accepting migration.