How gixakickflight/kick-flight-private-server works
Kick Flight: The Fenix Returns is a community private server for the Android game. The main workflow is client requests to the compatibility API, which handles game sessions and matchmaking, persists player state, and directs matches to the separate Photon server; clients also fetch game resources from the CDN. The README documents these service boundaries and the catalog/CDN and APK-preparation capabilities. Some runtime wiring is visible in the API excerpts and source index; unsampled deployment and data-generation internals are represented only at the documented subsystem level.
Main entry points: Program.cs API Host · DemoSessionApi.cs Game Sessions · IPlayerStore.cs Player Store · PlayerStoreFactory.cs Store Selection
Components 23
Compatibility API
- API Host
src/KickFlight.BootstrapApi/Program.cs - Game Sessions
src/KickFlight.BootstrapApi/DemoSessionApi.cs - D2C Codec
src/KickFlight.BootstrapApi/D2CCodec.cs - Request Capture
src/KickFlight.BootstrapApi/RequestCaptureMiddleware.cs - Safe Inspector
src/KickFlight.BootstrapApi/SafeRequestInspector.cs - Maintenance State
src/KickFlight.BootstrapApi/MaintenanceState.cs - Client Updates
src/KickFlight.BootstrapApi/ClientUpdateState.cs
Game Services
- Matchmaking
src/KickFlight.BootstrapApi/BattleMatchmakingService.cs - Photon Server
submodules/luxonserver - Photon Health
src/KickFlight.BootstrapApi/PhotonServerManager.cs
Player State
- Session State
src/KickFlight.BootstrapApi/SessionState.cs - Player Store
src/KickFlight.BootstrapApi/PlayerStore/IPlayerStore.cs - Store Selection
src/KickFlight.BootstrapApi/PlayerStore/PlayerStoreFactory.cs - PostgreSQL Store
src/KickFlight.BootstrapApi/PlayerStore/PostgresPlayerStore.cs - JSON Store
src/KickFlight.BootstrapApi/PlayerStore/JsonPlayerStore.cs
Game Content
- Fixtures
src/KickFlight.BootstrapApi/FixtureStore.cs - Resource Catalog
src/KickFlight.BootstrapApi/ResourceCatalogStore.cs - Resource Catalog Data
config/resources/catalog.json - Game CDN
content - Catalog Generator
scripts/build-title-resource-catalog.py - CDN Builder
scripts/build-cdn-tree.py - APK Preparation
scripts/patch-il2cpp-endpoints.py
Other components
- Android Client
Connections 30
- Android Client → API Host: API requests
- Android Client → Photon Server: plays matches
- Android Client → Game CDN: downloads resources
- API Host → Game Sessions: routes requests
src/KickFlight.BootstrapApi/Program.cs - API Host → Matchmaking: registers service
src/KickFlight.BootstrapApi/Program.cs - API Host → Store Selection: creates store
src/KickFlight.BootstrapApi/Program.cs - API Host → Fixtures: registers fixtures
src/KickFlight.BootstrapApi/Program.cs - API Host → Resource Catalog: registers catalog
src/KickFlight.BootstrapApi/Program.cs - API Host → Request Capture: registers middleware
src/KickFlight.BootstrapApi/Program.cs - API Host → Safe Inspector: registers inspector
src/KickFlight.BootstrapApi/Program.cs - API Host → Maintenance State: registers state
src/KickFlight.BootstrapApi/Program.cs - API Host → Client Updates: registers state
src/KickFlight.BootstrapApi/Program.cs - API Host → Photon Health: registers manager
src/KickFlight.BootstrapApi/Program.cs - Game Sessions → Player Store: loads player data
src/KickFlight.BootstrapApi/DemoSessionApi.cs - Game Sessions → Matchmaking: manages battle entry
src/KickFlight.BootstrapApi/DemoSessionApi.cs - Game Sessions → Maintenance State: checks mode
src/KickFlight.BootstrapApi/DemoSessionApi.cs - Game Sessions → Client Updates: checks versions
src/KickFlight.BootstrapApi/DemoSessionApi.cs - Game Sessions → D2C Codec: encodes payloads
src/KickFlight.BootstrapApi/DemoSessionApi.cs - Store Selection → PostgreSQL Store: selects configured
src/KickFlight.BootstrapApi/PlayerStore/PlayerStoreFactory.cs - Store Selection → JSON Store: selects fallback
src/KickFlight.BootstrapApi/PlayerStore/PlayerStoreFactory.cs - PostgreSQL Store → Player Store: implements
src/KickFlight.BootstrapApi/PlayerStore/PostgresPlayerStore.cs - JSON Store → Player Store: implements
src/KickFlight.BootstrapApi/PlayerStore/JsonPlayerStore.cs - Player Store → Session State: loads and saves
src/KickFlight.BootstrapApi/PlayerStore/IPlayerStore.cs - Photon Health → Photon Server: checks ports
src/KickFlight.BootstrapApi/PhotonServerManager.cs - Resource Catalog → Resource Catalog Data: reads definitions
src/KickFlight.BootstrapApi/ResourceCatalogStore.cs - API Host → Resource Catalog: serves resources
src/KickFlight.BootstrapApi/Program.cs - Catalog Generator → Resource Catalog Data: updates catalog
- CDN Builder → Resource Catalog Data: builds from
- CDN Builder → Game CDN: rebuilds tree
- APK Preparation → Android Client: patches endpoint