This is a project for editing parts of an aoe2scenario file from Age of Empires 2
Definitive Edition outside of the in-game editor.
Current up-to-date progress can be found on the Trello board.
| View | Add | Edit | Remove | |
|---|---|---|---|---|
| Triggers | ✔️ | ✔️ | ✔️ | ✔️ |
| Conditions | ✔️ | ✔️ | ✔️ | |
| Effects | ✔️ | ✔️ | ✔️ | |
| Units | ✔️ | ✔️ | ✔️ |
- None that I know of. Please report any bugs you find to the github issue board.
| ScenarioFiles | Read | Write | Reference |
|---|---|---|---|
| 1.36 | ✔️ | ✔️ | - |
| 1.37 | ✔️ | ✔️ | Game update: 35584 |
Run the following pip command for installation:
pip install AoE2ScenarioParser
This project is made in Python but does not support any versions below Python 3.6.
The project uses bidict for bidirectional mapping.
Note: All these dependencies should install automatically when using the above command.
To start, import the main AoE2Scenario class from the module:
from AoE2ScenarioParser.aoe2_scenario import AoE2ScenarioDefine the file you will be reading and the path you will be writing to.
Note: Creating folders isn't supported at this time. Please use an existing folder.
# It is recommended to not overwrite your file. This way you can keep a backup!
input_path = "File/Path/To/Your/Input/File"
output_path = "File/Path/To/Your/Output/File"Now create the Scenario object with the filename as parameter.
scenario = AoE2Scenario(input_path)You can edit your scenario in many ways. Not every part of the scenario can be edited with this project yet (without diving into the source code). Below you can find cheatsheets of the parts that are supported. If you'd like to see a
Please use the links for a cheatsheet of those parts.
As we all now, AoE2 has a lot of data involved. From Terrain types and Units to Effects and Conditions. All this data is impossible to remember. For that reason there are a number of datasets to help you out. You can find the cheatsheet here:
When you are done, you can write all your progress to a file like so:
scenario.write_to_file(output_path)Please remember to use a different path (filename) than your input file. This way you have a backup file incase you encounter a bug.
- Kerwin Sneijders (Main Author)
GNU General Public License v3.0: Please see the LICENSE file.