ChronoStorm is an open-source, modern engine reimplementation of the classic RTS games Command & Conquer: Red Alert 2 and Yuri's Revenge. Built from scratch utilizing Python and Pygame, it aims to provide a highly moddable, cross-platform foundation for isometric 2D strategy games.

ChronoStorm is a game engine, NOT a full game. This repository does not contain any original game assets, artworks, sounds, or copyrighted materials belonging to Electronic Arts. To use or test this engine, you must own a legal copy of Red Alert 2 / Yuri's Revenge and provide your own .MIX asset files.

The ultimate goal is to recreate the authentic 2.5D isometric experience while replacing the 20-year-old legacy codebase with flexible, Pythonic architecture—opening the doors for modern AI implementations and limitless modding capabilities.

• Phase 1: Asset Forging
  • .MIX file archive extraction.
  • .SHP (Sprite) and .VXL (Voxel) rendering via Pygame.
  • Palette (.PAL) loading and color mapping.
• Phase 2: The Grid
  • Map (.MAP) parsing and isometric grid rendering.
  • Terrain tilesets and basic world rendering.
• Phase 3: Mechanics & AI
  • A* Pathfinding optimized for isometric tiles.
  • Classic Sidebar UI implementation.
  • Entity state machines and modern AI behavior trees.
• Phase 4: Integrate Large Language Model
  • Integrate the LLM like DeepSeek
  • Use DeepSeek to command the enemy AI

• Python 3.10 or higher
• Pygame Community Edition (Pygame-CE recommended for better performance)

git clone https://github.com/cookgreen/ChronoStorm.git
cd ChronoStorm
pip install -r requirements.txt

(Note: Instructions on where to place your original game .MIX files will be updated soon.)

Game development is a journey. We document our engine-building process, tackling challenges like isometric coordinate math, Pygame render optimizations, and integrating advanced AI into indie games.

Watch the full development journey and technical deep-dives on the My YouTube channel!

Whether you are a Pygame enthusiast, a pathfinding algorithm wizard, or a veteran C&C modder familiar with file structures, your pull requests are welcome! Check out our CONTRIBUTING.md (coming soon) to see how you can help.

Distributed under the MIT License. See LICENSE for more information.