How festivaldev/paradise works
Project Paradise emulates UberStrike, combining a patched game client with web services and realtime communication/game servers. The principal flow is client login and game use through web-service authentication, followed by lobby and gameplay sessions handled by the realtime servers; server events also feed persistence and optional Discord integration. The graph retains documented client, file-serving, console, and compatibility capabilities. Relationships not visible in the sampled excerpts or SOURCE INDEX are omitted or marked unverified rather than inferred from names alone.
Main entry points: ParadiseService.ts Service orchestrator · current Current APIs · Hooks Client hooks · WebServiceHost.ts Web-service host
Components 28
Game client
- Client hooks
packages/client/current/Paradise.Client/Hooks - Client preferences
packages/client/current/Paradise.Client/ParadisePrefs.cs - Custom maps
packages/client/current/Paradise.Client/Plugins/Maps/ParadiseMapManager.cs - Menu music
packages/client/current/Paradise.Client/Plugins/ParadiseMainMenuMusicManager.cs - Rich presence
packages/client/current/Paradise.Client/Plugins/RichPresence/RichPresenceClient.cs
Web services
- Web-service host
packages/ws/src/services/web-services/WebServiceHost.ts - Current APIs
packages/ws/src/services/web-services/current - Legacy APIs
packages/ws/src/services/web-services/legacy - Persistent data
packages/ws/src/Database.ts - Game sessions
packages/ws/src/utils/GameSessionManager.ts
Realtime servers
- Realtime host
packages/realtime/Paradise.Realtime.Host/PhotonDomainManager.cs - Comm server
packages/realtime/Paradise.Realtime/Server/Comm/CommServerApplication.cs - Lobby rooms
packages/realtime/Paradise.Realtime/Server/Comm/Lobby/LobbyManager.cs - Game server
packages/realtime/Paradise.Realtime/Server/Game/GameServerApplication.cs - Game peer
packages/realtime/Paradise.Realtime/Server/Game/GamePeer.OperationHandler.cs - Room manager
packages/realtime/Paradise.Realtime/Server/Game/Managers/GameRoomManager.cs - Match rooms
packages/realtime/Paradise.Realtime/Server/Game/Rooms/BaseGameRoom.cs - Match statistics
packages/realtime/Paradise.Realtime/Server/Game/Managers/StatisticsManager.cs - Web-service clients
packages/realtime/Paradise.Realtime/ServiceClients/UserWebServiceClient.cs - Photon protocol shim
packages/shims/Photon.SocketServer/ClientPeer.cs
Shared and operations
- Domain models
packages/paradise-models/src - Service orchestrator
packages/ws/src/ParadiseService.ts - Admin console
packages/ws/src/console/CommandHandler.ts - Discord integration
packages/ws/src/discord/DiscordClient.ts - File server
packages/ws/src/services/file-server/FileServerHost.ts - Server socket
packages/ws/src/services/socket/Host.ts
Other components
- Player
- UberStrike game
Connections 29
- Player → UberStrike game: plays
README.md - UberStrike game → Client hooks: patched by
README.md - Client hooks → Current APIs: authenticates via
packages/client/current/Paradise.Client/Hooks/AuthenticationManagerHook.cs - Client hooks → Custom maps: loads maps
packages/client/current/Paradise.Client/Hooks/AuthenticationManagerHook.cs - Client preferences → Menu music: configures
packages/client/current/Paradise.Client/Plugins/ParadiseMainMenuMusicManager.cs - Client hooks → Web-service host: calls APIs
- Web-service host → Current APIs: routes requests
- Web-service host → Legacy APIs: supports legacy
- Current APIs → Persistent data: reads and writes
- Current APIs → Domain models: uses models
packages/ws/src/services/web-services/current/AuthenticationWebService.ts - Current APIs → Game sessions: manages sessions
- Game sessions → Domain models: persists sessions
packages/ws/src/utils/GameSessionManager.ts - Service orchestrator → Web-service host: starts host
packages/ws/src/ParadiseService.ts - Service orchestrator → Game sessions: creates manager
packages/ws/src/ParadiseService.ts - Service orchestrator → Admin console: starts console
packages/ws/src/ParadiseService.ts - Service orchestrator → Discord integration: notifies events
packages/ws/src/ParadiseService.ts - Service orchestrator → File server: starts host
packages/ws/src/ParadiseService.ts - Service orchestrator → Server socket: starts service
- Realtime host → Comm server: hosts application
- Realtime host → Game server: hosts application
- Comm server → Lobby rooms: manages lobby
- Game server → Game peer: creates peers
packages/realtime/Paradise.Realtime/Server/Game/GameServerApplication.cs - Game server → Room manager: creates manager
packages/realtime/Paradise.Realtime/Server/Game/GameServerApplication.cs - Room manager → Match rooms: creates rooms
packages/realtime/Paradise.Realtime/Server/Game/Managers/GameRoomManager.cs - Game peer → Match rooms: handles operations
packages/realtime/Paradise.Realtime/Server/Game/GamePeer.OperationHandler.cs - Match rooms → Match statistics: calculates results
packages/realtime/Paradise.Realtime/Server/Game/Rooms/BaseGameRoom.cs - Game peer → Web-service clients: requests player data
packages/realtime/Paradise.Realtime/Server/Game/GamePeer.OperationHandler.cs - Photon protocol shim → Game peer: dispatches requests
- Rich presence → Discord integration: shares presence