How kurobeats/ashfall works
Ashfall is a server-authoritative co-op mod for Fallout 3 and New Vegas. Players connect through the desktop client, authenticate with a dedicated server, and synchronize game state; the client relays engine commands and events through an injected bridge. The server also supports master-server listings, imported game data, combat and world simulation, persistence, and WASM game modes. The graph combines README-documented product flows with sampled module references; some runtime wiring is documented but its implementation files were not sampled, so those relationships cite the README.
Main entry points: game.rs Client session · src/network.rs Server networking · dispatch.rs Packet dispatch · src/network.rs Bridge pipe server
Components 23
Player client
- Client UI
crates/ashfall-client/src/ui/app.rs - Client session
crates/ashfall-client/src/game.rs - Client networking
crates/ashfall-client/src/network.rs - State sync
crates/ashfall-client/src/sync.rs - Client world view
crates/ashfall-client/src/world/registry.rs - Engine IPC
crates/ashfall-client/src/ipc/mod.rs
Authoritative services
- Server browser master
crates/ashfall-master/src/server_list.rs - Server networking
crates/ashfall-server/src/network.rs - Packet dispatch
crates/ashfall-server/src/dispatch.rs - Authentication
crates/ashfall-server/src/handlers/auth.rs - Player sessions
crates/ashfall-server/src/session.rs - Gameplay handlers
crates/ashfall-server/src/handlers - World simulation
crates/ashfall-server/src/world - Combat resolution
crates/ashfall-server/src/combat/resolver.rs - Game database
crates/ashfall-server/src/db - Mod importer
crates/ashfall-server/src/db/esm_import.rs - WASM game modes
crates/ashfall-server/src/script/engine.rs
Game integration
- Injected DLL proxy
crates/ashfall-bridge-proxy/src/lib.rs - Bridge pipe server
crates/ashfall-bridge/src/network.rs - Engine commands
crates/ashfall-bridge/src/commands.rs - Engine hooks
crates/ashfall-bridge/src/hooks
Shared protocol
- Game protocol
crates/ashfall-core/src/protocol/mod.rs
Other components
- Player
Connections 25
- Player → Client UI: uses
README.md - Client UI → Client session: connects
crates/ashfall-client/src/ui/app.rs - Client session → Client networking: sends packets
crates/ashfall-client/src/game.rs - Client networking → Server networking: exchanges UDP
README.md - Server networking → Packet dispatch: dispatches packets
- Packet dispatch → Authentication: routes auth
- Authentication → Player sessions: creates session
crates/ashfall-server/src/handlers/auth.rs - Packet dispatch → Gameplay handlers: routes gameplay
- Gameplay handlers → World simulation: updates state
- Gameplay handlers → Combat resolution: resolves combat
- World simulation → Game database: persists world
- Mod importer → Game database: imports records
crates/ashfall-server/src/db/esm_import.rs - Packet dispatch → WASM game modes: dispatches events
- Client session → State sync: synchronizes state
crates/ashfall-client/src/game.rs - State sync → Client world view: updates view
- Client session → Engine IPC: polls bridge
crates/ashfall-client/src/game.rs - Engine IPC → Bridge pipe server: sends TCP
README.md - Injected DLL proxy → Bridge pipe server: hosts in-game
README.md - Bridge pipe server → Engine commands: dispatches commands
crates/ashfall-bridge/src/network.rs - Engine commands → Engine hooks: calls engine hooks
crates/ashfall-bridge/src/commands.rs - Engine hooks → Bridge pipe server: reports events
crates/ashfall-bridge/src/hooks/mod.rs - Client networking → Game protocol: encodes messages
- Server networking → Game protocol: encodes messages
- Server browser master → Client UI: lists servers
README.md - Server networking → Server browser master: publishes listing
README.md