Troubleshooting
Start und Backend
| Fehler |
Prüfschritte |
Dateien |
| Runtime config invalid |
Environment/HTTPS/Loopback/ServerKey/UploadReplays prüfen; Local explizit setzen |
Core/Runtime/RuntimeConfigValidator.cs, Config-JSON |
| Auth schlägt fehl |
Nakama health/logs, Scheme/Host/Port/Key, Clientprofil |
NakamaAuthService.cs, NakamaClientService.cs |
| Kein Hub gefunden |
/servers, region/joinable, Heartbeatalter, Headless läuft |
Registry main.py, HubDiscoveryService.cs |
| ENet connect fail |
PublicHost/UDP-Port/Firewall, Server-Port, Registrywert |
NetworkManager.cs, ServerBootstrap.cs |
| Nakama-RPC unknown |
main.ts Registrierung, tsconfig.json, npm run build, Container rebuild |
Nakama modules |
Dungeon und Content
| Fehler |
Prüfschritte |
Dateien |
| No compatible room template |
Kategorie/Size/Role/Bounds/Doors/Depth/Weight aus Fehler vergleichen |
RoomTemplateSelector.cs, Catalog .tres |
| Catalog invalid |
Template Preview; ID, GeometryRoot, Socket boundary/forward/plug/collision, Pflichtmarker |
RoomTemplateValidator.cs |
| Tür bleibt geschlossen |
RoomState/AliveEnemyCount, Encounter Completed, Startgate, RuntimeDoor vs Socket |
RoomEncounterRuntime3D.cs, RuntimeDoor3D.cs |
| Gegner fehlt |
Objective-Enemy für Room, SpawnOrigin, Markerindex/ID, Raumaktivierung |
EncounterSpawnRequestFactory.cs, DungeonRun3DController.cs |
| Boss/Quota fehlt |
EnemyInstanceId, IsBoss, CountsForProgress, Origin, RequiredBossIds |
DungeonObjectiveTracker.cs |
| Exit gesperrt |
HUD Bosses und Enemy %, Profilquote |
DungeonObjectiveTracker3D.cs, DungeonRunProfile.cs |
Waffen und Replay
| Fehler |
Prüfschritte |
Ist-Zustand |
| Weapon Scene missing |
ScenePath/IconPath auf Existenz prüfen |
Factory-Pfade sind aktuell Placeholder |
| Loadout invalid |
Issue.Code und FieldPath, UnlockSnapshot, RunRules |
Shared-Domain ist testbar |
| Mastery nicht angewendet |
Policy, Masterylevel, TrackId, Tierkonflikt |
Official deaktiviert Mastery |
| Replay upload reject |
Auth/Ownership, Run-Ticket, Schema/Hashes, Chunkstatus und ReplayLimits |
Recorder und resumierbarer Upload sind aktiv; Client-/Serverlimits müssen identisch sein |
| Kein Leaderboardeintrag |
Submission-/Validationstatus, Eligibility, Migrationen, leaderboard_run_entries |
Manual-SQL-Leaderboard wird erst nach akzeptierter Runvalidierung projiziert |
Builds
dotnet build HolodeckArena.sln ist der kanonische Vollbuild. Godot-Export benoetigt Mono-Binary und Templates exakt 4.6.3. Production-Start mit Placeholder-Key ist absichtlich ungueltig. Container-Fehler zuerst mit docker compose ... config, dann build, ps und logs eingrenzen.
Weitere Diagnose: Debugging, Getting Started.