AoE2ScenarioParser
AoE2ScenarioParser is a Python library that allows you to edit aoe2scenario files from every version of
Age of Empires 2 Definitive Edition.
Getting Started
Installing using pip:
pip install AoE2ScenarioParser
More documentation about installing etc. can be found below.
Documentation
Documentation for installation, usage, examples, cheatsheets and API docs can be found on GitHub Pages.
Quick links
- Installing → A quick guide on how to install
AoE2ScenarioParser - Hello World Example → Step-by-step guide to get you going
- Discord Server → For questions about
AoE2ScenarioParser, Python or scenarios in general. - API Docs → Technical documentation for all exposed functions & classes
Discord
If you have any questions regarding AoE2ScenarioParser? Join the discord!
Support
Every Single Scenario Version* from Age of Empires 2 Definitive Edition is SUPPORTED!
Support:
1.36Version at Release (November 14th, 2019) →1.58Current Version (Since: June 2026)
Every single version of Age of Empires 2 Definitive Edition is supported*! If a new version of Age of Empires 2 Definitive Edition just released, it can take a bit for it to be able to be read. Check the Discord Server for more up-to-date information if this is the case.
If you find a scenario which can be opened by the game itself, but results in an error when using AoE2ScenarioParser,
please report it as an issue or in the #bug‑reports channel in the Discord Server.
*: All scenario versions are supported, though older structure versions of the same scenario version are not. For more context see this Discord post.
To view the full-blown support table previously shown on this page, visit: support.md.
Progress
Every related change to the library is documented and can be found in the CHANGELOG.
Features:
AoE2ScenarioParser allows you to edit anything inside a scenario.
For general usability "managers" have been created to make working with the files easier.
These managers allow you to quickly change aspects of units, triggers, the map, player data and more!
Below is a simplified overview of some of the features:
| Inspect | Add | Edit | Remove | |
|---|---|---|---|---|
| Triggers | ✔️ | ✔️ | ✔️ | ✔️ |
| Conditions | ✔️ | ✔️ | ✔️ | ✔️ |
| Effects | ✔️ | ✔️ | ✔️ | ✔️ |
| Units | ✔️ | ✔️ | ✔️ | ✔️ |
| Map | n/a *1 | ✔️ | ✔️ | ✔️ |
| Players | n/a *1 | ✔️* | ✔️ | ✔️* |
| Messages | n/a | ✔️ | ✔️ | ✔️ |
*: You can disable or enable players like in the in-game editor (min 1, max 8).
*1: There's no specific inspection function. Though, they can still be printed with clean formatting.
Authors
- Kerwin Sneijders (Main Author)
- Alian713 (Dataset Wizard)
License
MIT License: Please see the LICENSE file.
1 maintainer
Release files for AoE2ScenarioParser 0.8.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aoe2scenarioparser-0.8.4.tar.gz | 2.1 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aoe2scenarioparser-0.8.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.4 MB
Release files / aoe2scenarioparser-0.8.4.tar.gz
| Download URL | aoe2scenarioparser-0.8.4.tar.gz |
|---|---|
| Size | 2.1 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8e55d9ba26f83ed15fad2a5e2a679ee377644439cd025baef76df8d4934fe67b
|
|
BLAKE2b-256 checksum How to use checksums |
f05a6e12c5479a7424e8f7ef46a3701cd0fee16d442a6c5532c89309ed08d88f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / aoe2scenarioparser-0.8.4-py3-none-any.whl
| Download URL | aoe2scenarioparser-0.8.4-py3-none-any.whl |
|---|---|
| Size | 2.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6293fc16f510784ee5481b17c1f40f5c1915beba2eafd82d1eef5baeff3c5446
|
|
BLAKE2b-256 checksum How to use checksums |
e4d0593636f5ebdf6d0ea2a315823bc8e75345ba66af401125b75adfea455ade
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
