Skip to main content

Xindeler Docs

Xindeler is an open-source fantasy MMORPG built in Rust. This is the technical documentation — for developers, contributors, and designers who want to understand or contribute to the project.

What's in here?​

SectionWho it's for
ProjectArchitecture, tech stack, local setup
ContributionHow to make your first PR, guides for adding NPCs, items, and spells
Game systemsCombat, magic, classes, crafting
ORACLEThe world director — procedural narrative and ecosystem simulation
AURORANPC AI — minds with memory, social relationships, and generative dialogue
ReferenceGlossary, ECS components, asset formats

Quick start​

Want to contribute? The shortest path:

git clone https://github.com/Matute289/xindeler
cd xindeler
cargo build
cargo run --bin xindeler-server   # in one terminal
cargo run --bin voxygen            # in another terminal

Full guide: Local Setup

The stack in one line​

Rust nightly · ECS with specs · QUIC via Quinn · wgpu for rendering · RON for assets · MessagePack for persistence

What makes Xindeler different​

ORACLE — World director​

There are no content designers manually scripting events. ORACLE is an AI system that runs inside the server and directs the world: it generates narrative arcs, controls the creature ecosystem, and manages weather and faction relationships. Every Xindeler server develops its own history.

AURORA — NPCs with minds​

Xindeler's NPCs don't follow fixed scripts. Each one has a mind with its own values, fears, episodic memory of its interactions, and a network of social relationships. A merchant remembers that you robbed them. A guard has loyalties. An old woman tells you something she saw weeks ago. With the optional LLM module, dialogue is generative.

Project repos​

RepoDescription
Matute289/xindelerGame engine
Matute289/xindeler-documentationThis site
Matute289/xindeler-wikiPlayer wiki

Community​