👋 Welcome — what this is, and how to get started

[molotovgit]

Welcome, and thanks for stopping by. 👋

This project is a native Android (arm64) port of Command & Conquer: Generals — Zero Hour. It runs the original game engine on your phone through GeneralsX (the GPLv3 engine source EA released in 2025), with SDL3 for the window and input and DXVK translating the game's Direct3D 8 calls to Vulkan (tested on Mali-G57). It reaches the main menu, plays skirmish and the USA/GLA/China campaigns, renders terrain/units/water/shadows/HUD/minimap, plays audio and the Bink cutscenes — all with a purpose-built multi-touch control scheme.

The one hard rule

This repo is source code and documentation only. It contains no game data and never will — the .big archives, movies and maps are Electronic Arts' copyright. You bring your own from a retail copy you own. Please never post, attach, or link game data (.big/.bik/maps/ISOs) or a built self-contained APK (it embeds the data) anywhere in these Discussions. Posts that do will be removed. Buy the game — it keeps this project legal and alive.

Where to start

• 🎮 Get it running: docs/SETUP-GAME-FILES.md — find your install → copy the files → one packaging command → build → install.
• 🛠️ Build it yourself: BUILDING.md
• 🧠 How the hard parts were solved: docs/DISCOVERIES.md — deep-dive engineering write-ups.
• 🗺️ What's next / how to help: ROADMAP.md

Current status

Area	State
Boot → main menu, skirmish, campaigns	✅ playable
Rendering / audio / cutscenes / touch controls	✅ working
LAN multiplayer	🚧 in progress

Be excellent to each other

We follow a Code of Conduct. Be kind, be helpful, assume good faith.

Say hi 👇 — introduce yourself, tell us your device (model + GPU + Android version), and what you're hoping to run or build. Welcome aboard.