Skip to content

Repository files navigation

VERA20K

PRs WelcomeDocs

VERA20k hero image

Red Alert 2: Yuri's Revenge — rebuilt from scratch in Rust for large multiplayer battles.

VERA20k skirmish setup screen and in-game view

Join the VERA20k Discord

This project stands on the shoulders of giants. Thanks to OpenRA, XCC mixer, ModEnc website, PPM website, EA for open source RA1, World Altering Editor, Final Alert,YRpp, Ares, Phobos and much more.

VERA20K operates after contributor-owned cooperative principles. Contributors earn equity shares through contributions or donations. Those shares give automatically income rights and governance weight.


Project Goals

1. A drop-in replacement for gamemd.exe focused first on retail-convincing stock skirmish.

2. Constructed from the ground up for large multiplayer — targeting support for up to 30 players and 20,000 units on significantly bigger maps.

3. Offer known old and new rts feautures never seen before to enhance the cnc ra2 experience.

Development process

The reference is the decompiled gamemd.exe. New behavior is read from the original function in Ghidra first, and the Rust that matches it cites that function and address; 1,100+ reverse-engineering notes in docs/research/ back this. Playtesting in retail and in VERA decides what gets worked on next.

Current Status

Early development — Work is focused on the core engine. Approximately 40% complete.

Runs today (still being matched to the original engine):

  • Retail Yuri's Revenge maps with the original menus, loading screen and sidebar
  • Base building, power, tech tree, placement, selling and repair
  • Harvesting with War, Chrono and Slave miners
  • Ground, naval, air and spawned-unit combat; garrisons, transports, engineer capture, mind control, cloak
  • Lightning Storm, Iron Curtain, Force Shield, Genetic Mutator, Psychic Reveal, Paradrop
  • Save/load mid-match, match recording and replay

Not yet

  • Network play (lockstep and checksums exist, no transport)
  • A real AI opponent (the current one builds a base and sends waves)
  • Nuke, Chronosphere, Psychic Dominator, Spy Plane
  • Campaign missions and most map triggers

Requirements

  • Rust 1.85+ (edition 2024)
  • A copy of Red Alert 2: Yuri's Revenge (the engine reads .mix files from your install)

Setup

  1. Clone the repo:

    git clone https://github.com/yrvera/vera20k.git
    cd vera20k
    
  2. Copy the example config and set your RA2 install path:

    cp config.toml.example config.toml
    

    Edit config.toml and set ra2_dir to where your RA2/YR is installed.

  3. Build and run:

    cargo run --bin vera20k
    

Contributing

Read the architecture overview before diving in.

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/my-feature)
  3. Make your changes and commit
  4. Push to your fork and open a Pull Request

License

Releases

Packages

Contributors

Languages