The client is a Godot Engine (4.7, Forward+ renderer) project using both GDScript and C# (Mono) in the same codebase, split cleanly by concern:

  • GDScript owns UI, menus, scene/game-state orchestration, and most gameplay glue — anything that benefits from Godot’s fast edit-reload cycle.
  • C# owns the two performance- and correctness-critical layers: the network/protobuf stack and the voxel terrain engine.

Both sides interoperate natively through Godot’s own scene tree, signals and [GlobalClass] exports — there is no external interop shim. See Networking for a concrete example of a GDScript autoload driving a C# node.

The client talks to two independent backend services (see the server architecture docs for their side of this):

graph LR
  subgraph Client [bestia-client - Godot]
    UI[GDScript: UI / Menus / Scene flow]
    NET[C#: BnetSocket + protobuf wrappers]
    TERR[C#: Voxel chunk streaming + meshing]
    UI <--> NET
    UI <--> TERR
  end

  LOGIN[login-server<br/>REST, issues JWT]
  ZONE[zone-server<br/>Netty TCP socket, ECS, protobuf Envelope]

  NET -- "HTTPS POST /api/v1/auth/static" --> LOGIN
  NET <-- "TCP, length-prefixed Envelope frames" --> ZONE

login-server is only ever contacted once per session, to exchange credentials for a signed JWT. zone-server is the actual game: entity state, movement, combat, inventory, chat and terrain all flow over the same TCP socket as typed protobuf messages.

Subsystems

PageCovers
NetworkingThe Envelope wire format, BnetSocket, the CMSG/SMSG wrapper pattern, the login → JWT → socket-auth handshake, and disconnect handling
Scenes & MenusAutoload singletons, SceneManager’s scene-transition mechanism, and the full boot flow from the main menu to being in the game world
Entity SyncHow server entities become Godot nodes, client-side movement prediction, Master vs. Bestia, and the data-driven Resource + *DB pattern used across Items/Attacks/Bestia species
World & TerrainThe voxel chunk streaming, decoding and meshing pipeline
InteractionThe mouse state machine (move/attack/loot/targeting) and the orbit camera
UI OverviewA map of every HUD/window screen (inventory, equipment, skills, chat, …)
Shortcuts SystemThe hotbar/shortcut system in detail

Known rough edges

A few areas are intentionally incomplete or provisional — worth knowing before you go looking for something that isn’t there yet:

  • Pet/owned-Bestia ownership isn’t wired up: EntityManager only ever tracks one owned entity (the player’s Master).
  • The Ping/Pong keepalive exists but liveness detection isn’t wired to it yet — a lost connection is currently only detected when the TCP stream itself errors or closes.
  • The right-click Context Menu is a stub with no actions yet.
Edit this page

Last updated 19 Sep 2026, 01:24 +0200 . history