How oteryn/oteryn-game works
Oteryn is a native Rust multiplayer game: a player uses the native client to enter and play in an authoritative, multichannel game world. The principal runtime path spans client interaction, gameplay transport and admission, server-side gameplay, and durable state. The client tree also documents substantial UI and feature areas, while the repository README establishes the protocol, authoritative-server, and PostgreSQL architecture. The excerpts do not expose most client wiring or server domain internals, so those links are shown as unverified rather than asserted calls.
Main entry points: connection.rs Gameplay connection · bevy_shell Bevy shell · src Gameplay dispatch · gameplay Gameplay domains
Components 17
Native client
- Client entry
apps/client/src/bin/oteryn-client-bevy.rs - Bevy shell
apps/client/src/bevy_shell - Gameplay UI
apps/client/src/bevy_shell/game_ui - Gameplay features
apps/client/src/features - Play runtime
apps/client/src/play
Gameplay transport
- Gameplay connection
crates/gameplay/dispatch/src/gameplay_transport/connection.rs - Capability negotiation
crates/gameplay/dispatch/src/gameplay_transport/capabilities.rs - Game protocol
crates/protocol-oteryn
Game server
- Server entry
apps/game-server/src/main.rs - Gameplay dispatch
crates/gameplay/dispatch/src - Gameplay domains
crates/gameplay - Session services
crates/session
Durable state
- PostgreSQL
- Durability services
crates/gameplay/durability
World and content
- Native content
crates/gameplay/content/src/content - World and content tooling
tools/content-schema
Other components
- Player
Connections 16
- Player → Client entry: launches
- Client entry → Bevy shell: starts
- Bevy shell → Gameplay UI: presents
- Bevy shell → Gameplay features: hosts
- Gameplay features → Play runtime: uses
apps/client/src/features/0152-item-forge/controller.rs - Play runtime → Gameplay connection: exchanges gameplay
- Gameplay connection → Game protocol: uses
crates/gameplay/dispatch/src/gameplay_transport/connection.rs - Gameplay connection → Capability negotiation: negotiates
crates/gameplay/dispatch/src/gameplay_transport/capabilities.rs - Gameplay connection → Session services: delegates admission
crates/gameplay/dispatch/src/gameplay_transport/connection.rs - Gameplay connection → Gameplay dispatch: dispatches gameplay
crates/gameplay/dispatch/src/gameplay_transport/connection.rs - Server entry → Gameplay dispatch: serves gameplay
- Gameplay dispatch → Gameplay domains: invokes
crates/gameplay/dispatch/src/gameplay_transport/postgres_tests/support/questpc8_retrieval_routes_fixtures.rs - Gameplay domains → Durability services: persists state
- Durability services → PostgreSQL: reads and writes
- World and content tooling → Native content: authors content
- Native content → Gameplay domains: supplies world data