How vvbocko/mindduck works
MindDuckServer is the backend for a Unity multiplayer card game. Players request a room, connect over WebSocket, and exchange game commands and state; the server manages rooms and matches while the rules engine applies turns and decisions. The code excerpts show the room API, WebSocket dispatch, in-memory room management, and rules behavior. The README establishes PostgreSQL as a runtime dependency; repository implementations and registrations are indexed, but their runtime call paths beyond card listing are not established by the excerpts.
Main entry points: GameEngine.cs Game Engine · FakeGameEngine.cs Fake Engine · Program.cs HTTP/WebSocket Host · GameWebSocketHandler.cs Game Socket Handler
Components 24
Server API
- HTTP/WebSocket Host
MindDuckServer/src/MindDuck.Server/Program.cs - Game Socket Handler
MindDuckServer/src/MindDuck.Server/WebSockets/GameWebSocketHandler.cs
Rooms and Matches
- Room Manager
MindDuckServer/src/MindDuck.Server/Services/RoomManager.cs - Room State
MindDuckServer/src/MindDuck.Server/Models/Room.cs - Match Manager
MindDuckServer/src/MindDuck.Rules/MatchManager.cs
Game Rules
- Match State
MindDuckServer/src/MindDuck.Rules/Models/Match.cs - Game Service
MindDuckServer/src/MindDuck.Rules/GameService.cs - Game Engine
MindDuckServer/src/MindDuck.Rules/GameEngine.cs - Fake Engine
MindDuckServer/src/MindDuck.Rules/Fakes/FakeGameEngine.cs - Game State
MindDuckServer/src/MindDuck.Rules/Models/GameState.cs - Player and Card Model
MindDuckServer/src/MindDuck.Rules/Models/Player.cs - Board and Zones
MindDuckServer/src/MindDuck.Rules/Models/Board.cs - Card Mechanics
MindDuckServer/src/MindDuck.Rules/Models/Card.cs - Player Commands
MindDuckServer/src/MindDuck.Rules/Commands/GameCommand.cs - Apply Results
MindDuckServer/src/MindDuck.Rules/Results/ApplyResult.cs - Combat Rules
MindDuckServer/src/MindDuck.Rules/CombatRules.cs
Card Persistence
- Card Repository
MindDuckServer/src/MindDuck.Persistence/PostgreSql/PostgreSqlCardRepository.cs - Match Repository
MindDuckServer/src/MindDuck.Persistence/PostgreSql/PostgreSqlMatchRepository.cs - Player Repository
MindDuckServer/src/MindDuck.Persistence/PostgreSql/PostgreSqlPlayerRepository.cs - PostgreSQL
Client Protocol
- Wire Message DTOs
MindDuckServer/src/MindDuck.Contracts/Messages/ClientMessages.cs - State View DTO
MindDuckServer/src/MindDuck.Contracts/State/GameStateView.cs - REST DTOs
MindDuckServer/src/MindDuck.Contracts/Rest/RestDtos.cs
Other components
- Unity Player
Connections 27
- Unity Player → HTTP/WebSocket Host: requests
MindDuckServer/src/MindDuck.Server/Program.cs - HTTP/WebSocket Host → Room Manager: creates room
MindDuckServer/src/MindDuck.Server/Program.cs - Room Manager → Room State: stores
MindDuckServer/src/MindDuck.Server/Services/RoomManager.cs - Unity Player → Game Socket Handler: sends commands
- HTTP/WebSocket Host → Game Socket Handler: dispatches
MindDuckServer/src/MindDuck.Server/Program.cs - Game Socket Handler → Room Manager: looks up rooms
MindDuckServer/src/MindDuck.Server/WebSockets/GameWebSocketHandler.cs - Match Manager → Match State: stores
MindDuckServer/src/MindDuck.Rules/MatchManager.cs - Game Service → Match Manager: manages matches
MindDuckServer/src/MindDuck.Rules/GameService.cs - Game Service → Game Engine: applies commands
- Game Engine → Game State: updates
MindDuckServer/src/MindDuck.Rules/GameEngine.cs - Game Engine → Player and Card Model: changes zones
MindDuckServer/src/MindDuck.Rules/GameEngine.cs - Game Engine → Card Mechanics: checks mechanics
MindDuckServer/src/MindDuck.Rules/GameEngine.cs - Game Engine → Player Commands: dispatches
MindDuckServer/src/MindDuck.Rules/GameEngine.cs - Game Engine → Apply Results: returns
MindDuckServer/src/MindDuck.Rules/GameEngine.cs - Fake Engine → Game State: updates
MindDuckServer/src/MindDuck.Rules/Fakes/FakeGameEngine.cs - Fake Engine → Player and Card Model: deals and draws
MindDuckServer/src/MindDuck.Rules/Fakes/FakeGameEngine.cs - Fake Engine → Player Commands: dispatches
MindDuckServer/src/MindDuck.Rules/Fakes/FakeGameEngine.cs - Fake Engine → Apply Results: returns
MindDuckServer/src/MindDuck.Rules/Fakes/FakeGameEngine.cs - Player and Card Model → Board and Zones: owns zones
MindDuckServer/src/MindDuck.Rules/Models/Player.cs - Player and Card Model → Card Mechanics: holds cards
MindDuckServer/src/MindDuck.Rules/Models/Player.cs - HTTP/WebSocket Host → Card Repository: serves card list
MindDuckServer/src/MindDuck.Server/Program.cs - Card Repository → PostgreSQL: reads cards
MindDuckServer/src/MindDuck.Persistence/PostgreSql/PostgreSqlCardRepository.cs - Match Repository → PostgreSQL: persists matches
- Player Repository → PostgreSQL: persists players
- Unity Player → Wire Message DTOs: exchanges messages
- Game Socket Handler → Wire Message DTOs: uses protocol
- Game State → State View DTO: projects state