Initial commit: Minecraft Java & Bedrock crossplay server setup
This commit is contained in:
@@ -0,0 +1,202 @@
|
||||
# Minecraft Crossplay-Server (Java + Bedrock)
|
||||
|
||||
Ein PaperMC-Server im Container, der per **GeyserMC** zusaetzlich Bedrock-Clients
|
||||
(Konsole, Handy, Windows-10-Edition) annimmt. **Floodgate** authentifiziert diese
|
||||
Spieler ueber Xbox Live, ein gekaufter Java-Account ist fuer sie nicht noetig.
|
||||
|
||||
Es bleibt ein **Java-Server**: Redstone, Kampfsystem und Mob-Verhalten folgen den
|
||||
Java-Mechaniken. Geyser sitzt als Uebersetzungsschicht dazwischen.
|
||||
|
||||
```
|
||||
Java-Client ──TCP 25565──┐
|
||||
├──► PaperMC (Java-Server)
|
||||
Bedrock-Client ─UDP 19132─┴──► Geyser ──► Floodgate ──► Xbox-Live-Auth
|
||||
```
|
||||
|
||||
## Dateien
|
||||
|
||||
| Datei | Zweck |
|
||||
|---|---|
|
||||
| `docker-compose.yml` | Der Stack: Image, Ports, Plugins, server.properties |
|
||||
| `.env` | Alle Stellschrauben (Version, RAM, Ports, MOTD, Ops, RCON-Passwort) |
|
||||
| `config/plugins/Geyser-Spigot/config.yml` | Geyser-Vorgabe, u.a. `auth-type: floodgate` |
|
||||
|
||||
Die Welt und alle Plugin-Daten liegen im Docker-Volume `mc-crossplay_mc-data`,
|
||||
nicht im Projektordner (deutlich schnellere I/O unter Docker Desktop).
|
||||
|
||||
## Schnellstart
|
||||
|
||||
```bash
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
Der erste Start dauert ein paar Minuten: Paper-Jar, Geyser und Floodgate werden
|
||||
geladen und die Welt wird generiert.
|
||||
|
||||
Logs mitlesen:
|
||||
|
||||
```bash
|
||||
docker compose logs -f
|
||||
```
|
||||
|
||||
Fertig ist der Server, sobald `Started Geyser on UDP port 19132` und danach
|
||||
`Done (…)! For help, type "help"` in den Logs stehen.
|
||||
|
||||
Getestet mit Paper 26.2, Geyser 2.11.1 und Floodgate 2.2.5: Java-Ping auf
|
||||
25565/TCP und RakNet-Ping auf 19132/UDP antworten beide, MOTD und Spielerzahl
|
||||
werden vom Java-Server an die Bedrock-Serverliste durchgereicht.
|
||||
|
||||
## Verbinden
|
||||
|
||||
* **Java Edition:** Adresse `<Server-IP>`, Port `25565`
|
||||
* **Bedrock Edition:** Server hinzufuegen, Adresse `<Server-IP>`, Port `19132`
|
||||
* **Vom selben Rechner:** `localhost` bzw. `127.0.0.1`
|
||||
|
||||
Auf Konsolen (Switch, PS, Xbox) laesst sich oft keine freie Serveradresse
|
||||
eintragen. Ueblicher Weg dort: DNS-Umleitung im Heimnetz oder ein Dienst wie
|
||||
BedrockConnect.
|
||||
|
||||
Bedrock-Spieler erscheinen mit einem Punkt vor dem Namen, z.B. `.MeinGamertag`.
|
||||
Das ist der Floodgate-Praefix; er verhindert Namenskollisionen mit Java-Accounts.
|
||||
Aendern laesst er sich in `plugins/floodgate/config.yml` (`username-prefix`).
|
||||
|
||||
## Firewall (Windows)
|
||||
|
||||
Docker Desktop oeffnet die Ports nur lokal. Fuer Zugriff aus dem LAN muessen
|
||||
beide Ports durch die Windows-Firewall — in einer **Admin-PowerShell**:
|
||||
|
||||
```powershell
|
||||
New-NetFirewallRule -DisplayName "Minecraft Java 25565" -Direction Inbound -Protocol TCP -LocalPort 25565 -Action Allow
|
||||
```
|
||||
|
||||
```powershell
|
||||
New-NetFirewallRule -DisplayName "Minecraft Bedrock 19132" -Direction Inbound -Protocol UDP -LocalPort 19132 -Action Allow
|
||||
```
|
||||
|
||||
Fuer Zugriff aus dem Internet zusaetzlich im Router portforwarden:
|
||||
**25565/TCP** und **19132/UDP**. Bedrock laeuft ueber UDP — ein reines
|
||||
TCP-Forwarding reicht nicht.
|
||||
|
||||
## Erreichbarkeit pruefen
|
||||
|
||||
Sobald der Router-Port offen ist, testet Geyser die Erreichbarkeit von aussen
|
||||
selbst — das fragt einen oeffentlichen GeyserMC-Testdienst an, uebermittelt also
|
||||
deine oeffentliche IP und den Port dorthin:
|
||||
|
||||
```bash
|
||||
docker compose exec minecraft rcon-cli "geyser connectiontest"
|
||||
```
|
||||
|
||||
## Betrieb
|
||||
|
||||
```bash
|
||||
docker compose ps
|
||||
```
|
||||
|
||||
Serverkonsole (Befehle wie `op`, `whitelist`, `save-all`):
|
||||
|
||||
```bash
|
||||
docker compose exec minecraft rcon-cli
|
||||
```
|
||||
|
||||
Einzelner Befehl:
|
||||
|
||||
```bash
|
||||
docker compose exec minecraft rcon-cli op DeinName
|
||||
```
|
||||
|
||||
Sauber stoppen (die Welt wird gespeichert, bis zu 2 Minuten Zeit):
|
||||
|
||||
```bash
|
||||
docker compose down
|
||||
```
|
||||
|
||||
## Updates
|
||||
|
||||
* **Geyser/Floodgate:** werden bei jedem Containerstart in der aktuellsten
|
||||
Version geladen. Nach einem Bedrock-Update also einfach
|
||||
`docker compose restart` — Geyser zieht dann den passenden Build nach.
|
||||
* **Paper/Minecraft:** `MC_VERSION` in der `.env` steht auf `LATEST`. Fuer einen
|
||||
planbaren Betrieb besser fest pinnen, z.B. `MC_VERSION=26.2`.
|
||||
* **Image:** `docker compose pull && docker compose up -d`
|
||||
|
||||
## Weitere Plugins
|
||||
|
||||
URL in `docker-compose.yml` unter `PLUGINS` als weitere Zeile ergaenzen, dann
|
||||
`docker compose up -d`. Aus der Liste entfernte Plugins werden beim naechsten
|
||||
Start auch aus dem `plugins`-Ordner geloescht.
|
||||
|
||||
Fuer Bedrock-Spieler gilt: Plugins moeglichst simpel halten. Komplexe
|
||||
Chest-GUI-Menues (Auktionshaeuser, Shop-Menues) funktionieren ueber Geyser oft
|
||||
nur fehlerhaft. Plugins mit Formular-Unterstuetzung fuer Bedrock sind die
|
||||
bessere Wahl.
|
||||
|
||||
## Konfiguration aendern
|
||||
|
||||
* **server.properties:** ueber die `.env` bzw. die Environment-Variablen in
|
||||
`docker-compose.yml`. Direkte Aenderungen an der `server.properties` im Volume
|
||||
werden bei diesen Werten beim naechsten Start ueberschrieben.
|
||||
* **Geyser:** `config/plugins/Geyser-Spigot/config.yml` bearbeiten, dann
|
||||
`docker compose restart`. Die Datei aus dem Projektordner gewinnt, sobald sie
|
||||
neuer ist als die im Volume.
|
||||
* **Alles andere (Floodgate, weitere Plugins):** liegt im Volume. Anschauen mit
|
||||
|
||||
```bash
|
||||
docker compose exec minecraft cat /data/plugins/floodgate/config.yml
|
||||
```
|
||||
|
||||
Dauerhaft vorgeben laesst es sich, indem man die Datei unter
|
||||
`config/plugins/<Plugin>/` im gleichen Pfadaufbau ablegt.
|
||||
|
||||
## Backup
|
||||
|
||||
Welt und Plugin-Daten aus dem Volume in eine Datei sichern:
|
||||
|
||||
```bash
|
||||
docker run --rm -v mc-crossplay_mc-data:/data -v "$PWD":/backup alpine tar czf /backup/mc-backup.tar.gz -C /data .
|
||||
```
|
||||
|
||||
Vorher `docker compose exec minecraft rcon-cli save-all` ausfuehren oder den
|
||||
Server stoppen, damit die Welt konsistent auf der Platte liegt.
|
||||
|
||||
## Deployment in die Oracle Cloud
|
||||
|
||||
Der Umzug auf die OCI-Instanz hinter `minecraft.djnizz.at` ist in
|
||||
[DEPLOY-ORACLE.md](DEPLOY-ORACLE.md) beschrieben.
|
||||
|
||||
## Bekannte Einschraenkungen
|
||||
|
||||
* Bedrock unterstuetzt nicht alle Java-Features grafisch 1:1 (bestimmte
|
||||
Bannermuster, manche Offhand-Interaktionen) — kleine optische Abweichungen
|
||||
sind normal.
|
||||
* Geyser erzeugt einen leichten CPU-Overhead pro Bedrock-Spieler. Auf moderner
|
||||
Hardware faellt das nicht ins Gewicht.
|
||||
* Bedrock-Spieler haben keine Java-Chatsignatur, deshalb ist
|
||||
`enforce-secure-profile=false` gesetzt. Ohne das fliegen sie beim Chatten raus.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
**Bedrock-Client findet den Server nicht** — meist die Firewall oder ein
|
||||
fehlendes UDP-Forwarding. Test vom Host aus:
|
||||
|
||||
```bash
|
||||
docker compose exec minecraft sh -c "netstat -uln | grep 19132"
|
||||
```
|
||||
|
||||
**„Unable to connect to world"** — pruefen, ob Geyser sauber gestartet ist:
|
||||
|
||||
```bash
|
||||
docker compose logs | grep -i geyser
|
||||
```
|
||||
|
||||
**Container startet in einer Schleife neu, Log sagt „requires Java 25 or
|
||||
above"** — dann zeigt das Image-Tag auf eine zu alte JVM. Minecraft 26.x braucht
|
||||
Java 25, das Tag in `docker-compose.yml` muss `stable-java25` (oder neuer)
|
||||
bleiben.
|
||||
|
||||
**Bedrock-Spieler wird nach Java-Account gefragt** — dann greift `auth-type`
|
||||
nicht. Kontrolle:
|
||||
|
||||
```bash
|
||||
docker compose exec minecraft grep -A2 "^java:" /data/plugins/Geyser-Spigot/config.yml
|
||||
```
|
||||
Reference in New Issue
Block a user