Telos

A world-class, high-performance voxel engine and game written in Rust and Vulkan.

Its primary design goal is extreme render distance at minimal resource cost, using compressed chunk representations, GPU-driven rendering, and pixel-level far-field LOD.

Project Documentation

• Architecture & Binding Decisions (ADRs): analysis/analysis.md
• Agent Operating Manual & Workflow: GEMINI.md
• Roadmap & Phase Tracker: todo.md
• Discipline Runbooks: analysis/*/SKILL.md

Prerequisites

• Rust: 1.98.1+ stable (rust-toolchain.toml pinned)
• Vulkan: 1.3 compatible driver and loader
• Shader tools: glslc (shaderc) and spirv-val (spirv-tools)

Run the environment doctor to check your system:

cargo run -p xtask -- doctor
# or via alias
cargo doctor

Running the Quality Pipeline

cargo run -p xtask -- ci
# or via alias
cargo ci

Running the Server

cargo run --bin telos-server --release

License

MIT License. See LICENSE for details. Placeholder development assets live in dev-assets/ and are strictly excluded from the repository.