How weft-rust/weft works
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: client/mod.rs Game client · app.rs Game app · server/mod.rs World server · modloader.rs Mod loader
Components 22
Runtime and content
- Game app
crates/engine/src/app.rs - Frozen content
crates/engine/src/content.rs
World and gameplay
- World generation
crates/engine/src/generation.rs - World server
crates/engine/src/server/mod.rs - Voxel world
crates/engine/src/world/mod.rs - World saves
crates/engine/src/saves.rs
Player experience
- Game client
crates/engine/src/client/mod.rs - Input actions
crates/engine/src/input.rs - HUD and screens
crates/engine/src/hud.rs - Retained UI
crates/engine/src/ui/mod.rs - In-game editor
crates/engine/src/editor/mod.rs
Mods and assets
- Mod loader
crates/engine/src/modloader.rs - C ABI
crates/abi/src/lib.rs - Public SDK
crates/sdk/src/lib.rs - Base game mod
mods/base/src/lib.rs - Assets and packs
crates/engine/src/assets.rs
Rendering and network
- Peer networking
crates/engine/src/net/mod.rs - P2P transport
crates/engine/src/net/p2p.rs - Texture rendering
crates/engine/src/client/textures.rs - Graphics backend
backends/vulkan/src/lib.rs
Other components
- Player
- Server operator
Connections 22
- Player → Game app: launches
- Game app → Mod loader: loads mods
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
crates/engine/src/content.rs - Frozen content → World generation: defines generation
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
crates/engine/src/app.rs - Game client → HUD and screens: presents gameplay
crates/engine/src/hud.rs - HUD and screens → Retained UI: builds interface
crates/engine/src/hud.rs - Player → In-game editor: edits in game
- Assets and packs → Texture rendering: supplies textures
crates/engine/src/client/textures.rs - Game client → Graphics backend: draws world
- Game client → Peer networking: exchanges messages
crates/engine/src/net/mod.rs - Peer networking → P2P transport: bridges peers
crates/engine/src/net/mod.rs - Assets and packs → Player: offers resource packs
- Player → Peer networking: joins multiplayer