# weft-rust/weft architecture

> Architecture diagram of the GitHub repository weft-rust/weft, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/weft-rust/weft
- Repository: https://github.com/weft-rust/weft

## Overview

Weft is a Rust voxel sandbox engine whose playable game is the `mods/base` mod, built on the public SDK. A player launches the app, which loads mods and starts a client or headless server; gameplay then combines world simulation, rendering, and peer communication, while saves preserve world state. The README also describes modding, resource packs, and in-game development tools. Edges below use documented capabilities or visible references; unsampled subsystems are represented where the README establishes them, without guessing their internal calls.

Main entry points: [`crates/engine/src/client/mod.rs`](https://github.com/weft-rust/weft/blob/master/crates/engine/src/client/mod.rs) (Game client), [`crates/engine/src/app.rs`](https://github.com/weft-rust/weft/blob/master/crates/engine/src/app.rs) (Game app), [`crates/engine/src/server/mod.rs`](https://github.com/weft-rust/weft/blob/master/crates/engine/src/server/mod.rs) (World server), [`crates/engine/src/modloader.rs`](https://github.com/weft-rust/weft/blob/master/crates/engine/src/modloader.rs) (Mod loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and content"]
  node_app["Game app<br/>[app.rs]"]
  node_content[("Frozen content<br/>[content.rs]")]
end

subgraph group_simulation["World and gameplay"]
  node_worldgen["World generation<br/>[generation.rs]"]
  node_server["World server<br/>[mod.rs]"]
  node_world[("Voxel world<br/>[mod.rs]")]
  node_saves[("World saves<br/>[saves.rs]")]
end

subgraph group_player["Player experience"]
  node_client["Game client<br/>[mod.rs]"]
  node_input["Input actions<br/>[input.rs]"]
  node_hud["HUD and screens<br/>[hud.rs]"]
  node_ui["Retained UI<br/>[mod.rs]"]
  node_editor["In-game editor<br/>[mod.rs]"]
end

subgraph group_extensibility["Mods and assets"]
  node_modloader["Mod loader<br/>[modloader.rs]"]
  node_abi["C ABI<br/>[lib.rs]"]
  node_sdk["Public SDK<br/>[lib.rs]"]
  node_base["Base game mod<br/>[lib.rs]"]
  node_assets["Assets and packs<br/>[assets.rs]"]
end

subgraph group_platform["Rendering and network"]
  node_network["Peer networking<br/>[mod.rs]"]
  node_p2p["P2P transport<br/>[p2p.rs]"]
  node_textures["Texture rendering<br/>[textures.rs]"]
  node_render["Graphics backend<br/>[lib.rs]"]
end

node_player(("Player"))
node_server_actor(("Server operator"))

node_player -->|"launches"| node_app
node_app -->|"loads mods"| node_modloader
node_modloader -->|"loads game mod"| node_base
node_base -->|"uses public API"| node_sdk
node_sdk -->|"exposes mod interface"| node_abi
node_modloader -.->|"registers content"| node_content
node_content -.->|"defines generation"| node_worldgen
node_worldgen -->|"generates terrain"| node_world
node_server_actor -->|"runs headless"| node_server
node_server -->|"ticks regions"| node_world
node_server -.->|"persists worlds"| node_saves
node_player -.->|"provides actions"| node_input
node_app -.->|"starts client"| node_client
node_client -.->|"presents gameplay"| node_hud
node_hud -.->|"builds interface"| node_ui
node_player -->|"edits in game"| node_editor
node_assets -->|"supplies textures"| node_textures
node_client -.->|"draws world"| node_render
node_client -->|"exchanges messages"| node_network
node_network -->|"bridges peers"| node_p2p
node_assets -->|"offers resource packs"| node_player
node_player -->|"joins multiplayer"| node_network

click node_app "https://github.com/weft-rust/weft/blob/master/crates/engine/src/app.rs"
click node_modloader "https://github.com/weft-rust/weft/blob/master/crates/engine/src/modloader.rs"
click node_abi "https://github.com/weft-rust/weft/blob/master/crates/abi/src/lib.rs"
click node_sdk "https://github.com/weft-rust/weft/blob/master/crates/sdk/src/lib.rs"
click node_base "https://github.com/weft-rust/weft/blob/master/mods/base/src/lib.rs"
click node_content "https://github.com/weft-rust/weft/blob/master/crates/engine/src/content.rs"
click node_worldgen "https://github.com/weft-rust/weft/blob/master/crates/engine/src/generation.rs"
click node_server "https://github.com/weft-rust/weft/blob/master/crates/engine/src/server/mod.rs"
click node_world "https://github.com/weft-rust/weft/blob/master/crates/engine/src/world/mod.rs"
click node_saves "https://github.com/weft-rust/weft/blob/master/crates/engine/src/saves.rs"
click node_network "https://github.com/weft-rust/weft/blob/master/crates/engine/src/net/mod.rs"
click node_p2p "https://github.com/weft-rust/weft/blob/master/crates/engine/src/net/p2p.rs"
click node_client "https://github.com/weft-rust/weft/blob/master/crates/engine/src/client/mod.rs"
click node_input "https://github.com/weft-rust/weft/blob/master/crates/engine/src/input.rs"
click node_hud "https://github.com/weft-rust/weft/blob/master/crates/engine/src/hud.rs"
click node_ui "https://github.com/weft-rust/weft/blob/master/crates/engine/src/ui/mod.rs"
click node_editor "https://github.com/weft-rust/weft/blob/master/crates/engine/src/editor/mod.rs"
click node_assets "https://github.com/weft-rust/weft/blob/master/crates/engine/src/assets.rs"
click node_textures "https://github.com/weft-rust/weft/blob/master/crates/engine/src/client/textures.rs"
click node_render "https://github.com/weft-rust/weft/blob/master/backends/vulkan/src/lib.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_content toneBlue
class node_worldgen,node_server,node_world,node_saves toneAmber
class node_client,node_input,node_hud,node_ui,node_editor,node_server_actor toneMint
class node_modloader,node_abi,node_sdk,node_base,node_assets toneRose
class node_network,node_p2p,node_textures,node_render,node_player toneIndigo
```

## Components

### Runtime and content

- [Game app](https://github.com/weft-rust/weft/blob/master/crates/engine/src/app.rs): `crates/engine/src/app.rs`
- [Frozen content](https://github.com/weft-rust/weft/blob/master/crates/engine/src/content.rs): `crates/engine/src/content.rs`

### World and gameplay

- [World generation](https://github.com/weft-rust/weft/blob/master/crates/engine/src/generation.rs): `crates/engine/src/generation.rs`
- [World server](https://github.com/weft-rust/weft/blob/master/crates/engine/src/server/mod.rs): `crates/engine/src/server/mod.rs`
- [Voxel world](https://github.com/weft-rust/weft/blob/master/crates/engine/src/world/mod.rs): `crates/engine/src/world/mod.rs`
- [World saves](https://github.com/weft-rust/weft/blob/master/crates/engine/src/saves.rs): `crates/engine/src/saves.rs`

### Player experience

- [Game client](https://github.com/weft-rust/weft/blob/master/crates/engine/src/client/mod.rs): `crates/engine/src/client/mod.rs`
- [Input actions](https://github.com/weft-rust/weft/blob/master/crates/engine/src/input.rs): `crates/engine/src/input.rs`
- [HUD and screens](https://github.com/weft-rust/weft/blob/master/crates/engine/src/hud.rs): `crates/engine/src/hud.rs`
- [Retained UI](https://github.com/weft-rust/weft/blob/master/crates/engine/src/ui/mod.rs): `crates/engine/src/ui/mod.rs`
- [In-game editor](https://github.com/weft-rust/weft/blob/master/crates/engine/src/editor/mod.rs): `crates/engine/src/editor/mod.rs`

### Mods and assets

- [Mod loader](https://github.com/weft-rust/weft/blob/master/crates/engine/src/modloader.rs): `crates/engine/src/modloader.rs`
- [C ABI](https://github.com/weft-rust/weft/blob/master/crates/abi/src/lib.rs): `crates/abi/src/lib.rs`
- [Public SDK](https://github.com/weft-rust/weft/blob/master/crates/sdk/src/lib.rs): `crates/sdk/src/lib.rs`
- [Base game mod](https://github.com/weft-rust/weft/blob/master/mods/base/src/lib.rs): `mods/base/src/lib.rs`
- [Assets and packs](https://github.com/weft-rust/weft/blob/master/crates/engine/src/assets.rs): `crates/engine/src/assets.rs`

### Rendering and network

- [Peer networking](https://github.com/weft-rust/weft/blob/master/crates/engine/src/net/mod.rs): `crates/engine/src/net/mod.rs`
- [P2P transport](https://github.com/weft-rust/weft/blob/master/crates/engine/src/net/p2p.rs): `crates/engine/src/net/p2p.rs`
- [Texture rendering](https://github.com/weft-rust/weft/blob/master/crates/engine/src/client/textures.rs): `crates/engine/src/client/textures.rs`
- [Graphics backend](https://github.com/weft-rust/weft/blob/master/backends/vulkan/src/lib.rs): `backends/vulkan/src/lib.rs`

### Other components

- **Player**
- **Server operator**

## Connections

- Player → Game app: launches
- Game app → Mod loader: loads mods (evidence: `crates/engine/src/app.rs`)
- Mod loader → Base game mod: loads game mod
- Base game mod → Public SDK: uses public API
- Public SDK → C ABI: exposes mod interface
- Mod loader → Frozen content: registers content (evidence: `crates/engine/src/content.rs`)
- Frozen content → World generation: defines generation (evidence: `crates/engine/src/content.rs`)
- World generation → Voxel world: generates terrain
- Server operator → World server: runs headless
- World server → Voxel world: ticks regions
- World server → World saves: persists worlds
- Player → Input actions: provides actions
- Game app → Game client: starts client (evidence: `crates/engine/src/app.rs`)
- Game client → HUD and screens: presents gameplay (evidence: `crates/engine/src/hud.rs`)
- HUD and screens → Retained UI: builds interface (evidence: `crates/engine/src/hud.rs`)
- Player → In-game editor: edits in game
- Assets and packs → Texture rendering: supplies textures (evidence: `crates/engine/src/client/textures.rs`)
- Game client → Graphics backend: draws world
- Game client → Peer networking: exchanges messages (evidence: `crates/engine/src/net/mod.rs`)
- Peer networking → P2P transport: bridges peers (evidence: `crates/engine/src/net/mod.rs`)
- Assets and packs → Player: offers resource packs
- Player → Peer networking: joins multiplayer
