Lokale Entwicklung
Nur Client gegen Staging
Die Staging-Konfiguration enthält einen Platzhalter-Key; reale Builds müssen ihn sicher injizieren. Staging benötigt erreichbares Nakama und Registry sowie mindestens einen registrierten Hub-Server.
Client mit lokalem Nakama
Starte den Compose-Stack und dann:
Nakama allein genügt für Auth/RPC/Chat, aber nicht für den Hub-Wechsel: Hub-Discovery erwartet einen Registry-Eintrag.
Client mit lokalem Headless-Server
Starte Registry/Redis/Nakama, dann den Headless-Server aus Headless-Server, anschließend einen Client. Der Server registriert hub_local_001 und Port 7001. Prüfe http://127.0.0.1:8080/servers und Serverlogs.
Vollständiger Stack
docker compose --env-file src/server/.env -f src/server/docker-compose.yaml up --build -d
godot --headless --path src/HolodeckArena.Game3D -- --env=local --server-mode --server-hub-id=hub_local_001 --server-port=7001 --server-max-players=5 --server-public-host=127.0.0.1 --server-registry-url=http://127.0.0.1:8080/
godot --path src/HolodeckArena.Game3D -- --env=local --client-profile=client_a
Mehrere Clients und Profile
godot --path src/HolodeckArena.Game3D -- --env=local --client-profile=client_a
godot --path src/HolodeckArena.Game3D -- --env=local --client-profile=client_b
RuntimeOptions.DeviceId bildet das Profil deterministisch per MD5 auf eine GUID ab. Dasselbe Profil ist dieselbe lokale Device-Identität; für parallele Gäste deshalb nie doppelt verwenden. Rider bietet sechs Local-Player-Profile.
Rider und Godot Debugging
Die .run/*.run.xml-Profile bauen vor dem Start die bereinigte Solution. Fuer C#-Breakpoints Godot Mono als .NET Executable starten; fuer Scene-/Physics-Probleme zusaetzlich Godot Remote Scene Tree und Debugger verwenden.
Logs
docker compose --env-file src/server/.env -f src/server/docker-compose.yaml logs -f nakama
docker compose --env-file src/server/.env -f src/server/docker-compose.yaml logs -f registry
docker compose --env-file src/server/.env -f src/server/docker-compose.yaml logs -f dashboard
docker compose --env-file src/server/.env -f src/server/docker-compose.yaml logs -f redis
Der Dashboard-Port 8000 zeigt Registry-Daten, ist aber keine vollständige Operations-Konsole. Siehe Debugging und Troubleshooting.