Get Empire Forge

Now on the Microsoft Store. It needs only Age of Empires II: Definitive Edition on the same PC.

Portable

GitHub release

The same app as a single AOE2EmpireForge.exe. No installer – download it and double-click.

  • Always the newest release, usually the same day
  • The app tells you when a newer version is out
  • Windows shows a SmartScreen warning the first time – here's why and what to click
Download from GitHub

Requirements

WindowsWindows 10 or 11, 64-bit
GameAge of Empires II: Definitive Edition on Steam or PC Game Pass / Microsoft Store, installed on the same PC
ConsolesNot supported – the Xbox and PlayStation versions only allow official mods
Mac & LinuxNo ready-made app. The source code runs with Python if you're comfortable setting that up
Everything elseNothing – no Python, no modding tools, no account

First launch: "Windows protected your PC"

The GitHub download isn't code-signed – a certificate is a yearly cost for a free hobby project – so Windows SmartScreen doesn't recognise it yet and shows a warning the first time you run it. It doesn't mean anything is wrong. To continue:

  1. Click More info.
  2. Click Run anyway.
SmartScreen warning with the More info link
1. Click "More info"
SmartScreen showing the Run anyway button
2. Click "Run anyway"

Wary of running an unsigned file? That's healthy. Every line of Empire Forge is public on GitHub, and the exe is built from it by GitHub's own servers – you can see each build in the repository's Actions tab. The Microsoft Store version skips this step entirely.

Switching from the GitHub download

The exe never installed anything, so moving to the Store version is simple: close its console window, delete AOE2EmpireForge.exe, and install from the Microsoft Store. Your saved civ files open in either version, and mods you've already built stay in the game's mods folder.

What happens when it runs

A console window opens and, a moment later, your browser opens Empire Forge. The app is a small web page served from your own computer – your civs and your game files never leave it. Close the console window to quit.

Clicked it and nothing happened? Your antivirus may have quietly quarantined it. See the FAQ for the fix.

Next

Read How It Works for the full walkthrough, from first civ to installed mod.

Empire Forge is free, and always will be. If it brought you some joy, you can buy me a coffee on Ko-fi – entirely optional, and very much appreciated.