PremiumBridge

!(https://cdn.modrinth.com/data/cached_images/7bd7b67f43dbfe336d3cf659a5bd5cca077501a1.png)

# 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 (https://modrinth.com/plugin/premiumbridge-velocity) ((https://github.com/goshkow/PremiumBridge/releases/latest)) 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 (https://github.com/goshkow/PremiumBridge/blob/main/VELOCITY_SETUP.md). 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
• (https://modrinth.com/plugin/addheads) integration
• 🛡️ Online nickname protection

## 📋 Requirements

• Paper 1. 21.x or compatible fork
• (https://www.spigotmc.org/resources/protocollib. 1997/)