1 unstable release

0.1.0 Jul 22, 2016

#329 in Games

375 stars & 18 watchers

26K SLoC


Build Status

A modern implementation of the Quake engine in Rust.

alt tag


Richter is in pre-alpha development, so it's still under heavy construction. However, the client is nearly alpha-ready -- check out the Client section below to see progress.


The client is capable of connecting to and playing on original Quake servers using sv_protocol 15. To connect to a Quake server, run

$ cargo run --release --bin quake-client -- --connect <server_ip>:<server_port>

Quake servers run on port 26000 by default. I can guarantee compatibility with FitzQuake and its derived engines, as I use the QuakeSpasm server for development (just remember sv_protocol 15).

The client also supports demo playback using the --demo option:

$ cargo run --release --bin quake-client -- --demo <demo_file>

This works for demos in the PAK archives (e.g. demo1.dem) or any demos you happen to have placed in the id1 directory.

Feature checklist

  • Networking
    • NetQuake network protocol implementation (sv_protocol 15)
      • Connection protocol implemented
      • All in-game server commands handled
      • Carryover between levels
    • FitzQuake extended protocol support (sv_protocol 666)
  • Rendering
    • Deferred dynamic lighting
    • Particle effects
    • Brush model (.bsp) rendering
      • Textures
        • Static textures
        • Animated textures
        • Alternate animated textures
        • Liquid texture warping
        • Sky texture scrolling (currently partial support)
      • Lightmaps
      • Occlusion culling
    • Alias model (.mdl) rendering
      • Keyframe animation
        • Static keyframes
        • Animated keyframes
      • Keyframe interpolation
      • Ambient lighting
      • Viewmodel rendering
    • UI
      • Console
      • HUD
      • Level intermissions
      • On-screen messages
      • Menus
  • Sound
    • Loading and playback
    • Entity sound
    • Ambient sound
    • Spatial attenuation
    • Stereo spatialization
    • Music
  • Console
    • Line editing
    • History browsing
    • Cvar modification
    • Command execution
    • Quake script file execution
  • Demos
    • Demo playback
    • Demo recording
  • File formats
    • BSP loader
    • MDL loader
    • SPR loader
    • PAK archive extraction
    • WAD archive extraction


The Richter server is still in its early stages, so there's no checklist here yet. However, you can still check out the QuakeC bytecode VM in the progs module.


Richter makes use of feature gates and compiler plugins, which means you'll need a nightly build of rustc. The simplest way to do this is to download rustup and follow the directions.

Because a Quake distribution contains multiple binaries, this software is packaged as a Cargo library project. The source files for binaries are located in the src/bin directory and can be run with

$ cargo run --bin <name>

where <name> is the name of the source file without the .rs extension.

This software is released under the terms of the MIT License (see LICENSE.txt).

This project is in no way affiliated with id Software LLC, Bethesda Softworks LLC, or ZeniMax Media Inc. Information regarding the Quake trademark can be found at Bethesda's legal information page.

Due to licensing restrictions, the data files necessary to run Quake cannot be distributed with this package. pak0.pak, which contains the files for the first episode ("shareware Quake"), can be retrieved from id's FTP server at ftp://ftp.idsoftware.com/idstuff/quake. The full game can be purchased from a number of retailers including Steam and GOG.


~1.5M SLoC