Minecraft-Server verbinden
So bindest du einen Paper-Backend-Server oder einen Velocity-Proxy an den Nexus Core an. Hintergrund: Bridge-Architektur, Protokoll.
Voraussetzungen
- Ein laufender Nexus Core (Standard-WebSocket:
ws://<host>:8080/bridge/ws, hinter TLSwss://…). - Paper 1.21+ (Backend) bzw. Velocity (Proxy).
- Berechtigung im ACP, einen Server-Token zu erzeugen.
1. Bridge-Plugin herunterladen
Das Bridge-Plugin (Paper oder Velocity) gibt es als Download-Button direkt im
ACP unter Server → Server verbinden — die angebotene Version passt
automatisch zu deinem Core und Update-Kanal. Die Jar anschließend in den
plugins-Ordner des Servers legen.
2. Token im ACP erzeugen
ACP → Server → Server verbinden → Token erzeugen. Der Einmal-Token legitimiert genau einen Handshake; danach erhält der Server automatisch einen dauerhaften Server-Key.
3a. Paper-Backend einrichten
- Jar nach
plugins/legen, Server einmal starten →plugins/JuByteNexusBridge/config.ymlwird erzeugt. - Token eintragen — entweder ingame/Konsole:
oder in der/nexus setup <token>config.yml(core-url+token) und neu starten. - Der Server erscheint live im ACP; Join-Checks (Bans) laufen ab sofort aus dem lokalen Cache.
config.yml (Paper)
| Schlüssel | Default | Bedeutung |
|---|---|---|
core-url | ws://localhost:8080/bridge/ws | WebSocket-URL des Core (für TLS wss://…) |
server-name | lobby-1 | Anzeigename im ACP |
token | "" | Einmal-Token (oder via /nexus setup) |
server-key | "" | wird nach dem 1. Handshake automatisch gesetzt — nicht manuell ändern |
3b. Velocity-Proxy einrichten
Jar nach plugins/ legen, starten → plugins/jubyte-nexus-bridge/nexus-bridge.properties:
core-url=ws://localhost:8080/bridge/ws
server-name=proxy-1
token=<token-aus-acp>
server-key=
Der Proxy erzwingt Bans netzwerkweit bereits beim Login.
4. Befehle & Berechtigungen (Paper)
| Befehl | Permission | Zweck |
|---|---|---|
/nexus link | – | Link-Code fürs UCP anfordern |
/nexus setup <token> | nexus.setup (oder Konsole) | Token speichern & verbinden |
/ban, /tempban, /punish | nexus.ban | Ban / Tempban / Vorlage |
/mute, /tempmute | nexus.mute | Mute |
/kick | nexus.kick | Kick |
/warn | nexus.warn | Verwarnung |
/unban / /unmute | nexus.unban / nexus.unmute | Aufheben |
/report, /reportchat, /reportskin | – | Spieler melden |
/chatlog <player> | nexus.chatlog | Chat-Snapshot als Beweis |
Dauer-Format: 7d, 12h, 30m, 90s (s/m/h/d/w).
5. Verifizieren
- Im ACP erscheint der Server online mit Live-Metriken (Paper: TPS/RAM/Entities; Proxy: Spielerzahl).
- Ein Test-Ban im ACP kickt einen Online-Spieler sofort; ein gebannter Account kommt beim Login nicht durch.
- Konsole: Paper-Log zeigt „Mit Nexus Core verbunden (Server-ID …)".
Fehlerbehebung
| Symptom | Ursache / Lösung |
|---|---|
| „Kein Bridge-Token konfiguriert" | /nexus setup <token> ausführen bzw. token in der Config setzen |
handshake.error / NX-3001 | Token ungültig oder bereits verbraucht → im ACP neuen Token erzeugen |
| Server bleibt offline, Log „Core unreachable, retrying" | core-url/Port/Firewall prüfen; hinter Proxy muss der WebSocket-Upgrade auf /bridge/ws durchgereicht werden |
| Bans greifen nicht | Bridge nicht verbunden? Ban-Cache wird erst nach handshake.ok (ban.sync) befüllt |
| Ränge erscheinen nicht im ACP | Vault + Permission-Provider (z. B. LuckPerms) installiert? vault.groups wird alle 60 s gemeldet |
| Konsole/Befehle aus ACP wirken nicht | Capability fehlt: Konsole/EXECUTE gibt es nur auf Paper-Backends, nicht auf Velocity |
Sicherheit: In Produktion
wss://(TLS) verwenden — der Token/Server-Key wird sonst im Klartext übertragen.