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.36 Version at Release (November 14th, 2019) → 1.58 Current 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

License

MIT License: Please see the LICENSE file.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for KSneijders from gravatar.com KSneijders

Credits

Author: Kerwin Sneijders

License

MIT License

Requires

Python >=3.8

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aoe2scenarioparser-0.8.4.tar.gz (2.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aoe2scenarioparser-0.8.4-py3-none-any.whl (2.2 MB view details)

Uploaded Python 3

File details

Details for the file aoe2scenarioparser-0.8.4.tar.gz.

File metadata

  • Download URL: aoe2scenarioparser-0.8.4.tar.gz
  • Upload date:
  • Size: 2.1 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aoe2scenarioparser-0.8.4.tar.gz
Algorithm Hash digest
SHA256 8e55d9ba26f83ed15fad2a5e2a679ee377644439cd025baef76df8d4934fe67b
MD5 17aed53e547be40366ae1b9c80baf7d6
BLAKE2b-256 f05a6e12c5479a7424e8f7ef46a3701cd0fee16d442a6c5532c89309ed08d88f

See more details on using hashes here.

File details

Details for the file aoe2scenarioparser-0.8.4-py3-none-any.whl.

File metadata

File hashes

Hashes for aoe2scenarioparser-0.8.4-py3-none-any.whl
Algorithm Hash digest
SHA256 6293fc16f510784ee5481b17c1f40f5c1915beba2eafd82d1eef5baeff3c5446
MD5 3fb929980609c912fe51b3302aa9255e
BLAKE2b-256 e4d0593636f5ebdf6d0ea2a315823bc8e75345ba66af401125b75adfea455ade

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.8.4 This release

2 files

0.8.3

2 files

0.8.2

2 files

0.8.1

2 files

0.8.0

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4

2 files

0.6.3

2 files

0.6.2

2 files

0.6.0

2 files

0.5.3

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

Pre-release

0.5.0b2

2 files

Pre-release

0.5.0b1

2 files

0.4.7

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.6

2 files

0.3.5

2 files

Yanked

0.3.4

2 files

Yanked reason: Can corrupt scenarios. Please use version 0.3.5 and above

Yanked

0.3.3

2 files

Yanked reason: Can corrupt scenarios. Please use version 0.3.5 and above

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

Pre-release

0.3.0.dev3

2 files

Pre-release

0.3.0.dev2

2 files

Pre-release

0.3.0.dev1

2 files

Pre-release

0.3.0.dev0

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.1.74

2 files

0.1.73

2 files

0.1.72

2 files

0.1.71

2 files

0.1.70

2 files

0.1.69

2 files

0.1.68

2 files

0.1.67

2 files

0.1.66

2 files

0.1.65

2 files

0.1.64

2 files

0.1.63

2 files

0.1.62

2 files

0.1.61

2 files

0.1.60

2 files

0.1.59

2 files

0.1.58

2 files

0.1.57

2 files

0.1.56

2 files

0.1.55

2 files

0.1.54

2 files

0.1.53

2 files

0.1.52

2 files

0.1.51

2 files

0.1.50

2 files

0.1.49

2 files

0.1.48

2 files

0.1.47

2 files

0.1.46

2 files

0.1.45

2 files

0.1.44

2 files

0.1.43

2 files

0.1.42

2 files

0.1.41

2 files

0.1.40

2 files

0.1.39

2 files

0.1.38

2 files

0.1.37

2 files

0.1.36

2 files

0.1.35

2 files

0.1.34

2 files

0.1.33

2 files

0.1.32

2 files

0.1.31

2 files

0.1.30

2 files

0.1.29

2 files

0.1.28

2 files

0.1.27

2 files

0.1.26

2 files

0.1.25

2 files

0.1.24

2 files

0.1.23

2 files

0.1.22

2 files

0.1.21

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.20

2 files

0.0.19

2 files

0.0.18

2 files

0.0.17

2 files

0.0.16

2 files

0.0.15

2 files

0.0.14

2 files

0.0.13

2 files

0.0.12

2 files

0.0.11

2 files

0.0.10

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page