!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

⚖️ Offline server, online experience

Server stays offline ✅ Offline players join normally

Online players get:

• ✅ No manual login (auto-verified)
• ✅ Optional auto-registration
• ✅ Inventory/stats migration
• ✅ Invisible auth messages

Online players might never notice the registration system exists.

🔌 Supported auth plugins

• AuthMe
• OpeNLogin
• Any other

💫 Velocity Support

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

Download PremiumBridge Velocity (github)

1. Put PremiumBridge-Velocity.jar into Velocity/plugins/.
2. Put PremiumBridge.jar into the plugins/ folder of every Paper or Purpur backend.
3. In velocity.toml, enable online-mode = false and player-info-forwarding-mode = "modern".
4. Enable native Velocity forwarding in config/paper-global.yml and use the same forwarding.secret.
5. 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.
6. 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.

🔄 Migration modes

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.

✨ Extra features

• 🌐 Built-in translations
• 📚 Public API for other plugins
• AddHeads integration
• 🛡️ Online nickname protection

📋 Requirements

• Paper 1.21.x or compatible fork
• ProtocolLib