GenieToolingPython Tools for AoE2 DE

High-level toolkit for editing Age of Empires II Definitive Edition DAT files

Get Started

View on GitHub

🎯

Object-Oriented API

Work with proper Handle objects for Units, Graphics, Sounds, Effects, and Techs instead of raw data structures.

🌍

Multi-Civ Propagation

Changes automatically apply to all civilizations. Easily target specific civs when needed.

⚡

Attribute Flattening

Access nested properties directly (unit.hit_points) instead of navigating complex hierarchies.

🔧

Fluent Builders

Create tasks and effect commands with readable, auto-complete friendly methods.

🛡️

Safe Cloning

Deep copy operations prevent shared reference bugs across civilizations.

📊

Type-Safe Datasets

IntEnum constants for resources, tasks, attack classes, and more.

Quick Example

python

from aoe2_genie_tooling import GenieWorkspace

# Load workspace
workspace = GenieWorkspace.load("empires2_x2_p1.dat")

# Get managers
unit_manager = workspace.unit_manager
effect_manager = workspace.effect_manager

# Modify existing unit
archer = unit_manager.get(4)  # Archer
archer.hit_points = 50
archer.max_range = 7.0
archer.add_attack(class_=4, amount=8)

# Create a new unit from template
hero = unit_manager.create("Elite Guard", base_unit_id=4)
hero.hit_points = 200
hero.add_task.combat(class_id=0)

# Save changes
workspace.save("output.dat")

Installation

bash

pip install aoe2-genie-tooling

Documentation

Section	Description
Getting Started	Installation and first steps
Units	Managing units, tasks, attacks
Effects	Technology effects and commands
Techs	Research and upgrades
Graphics	Sprites and animations
Sounds	Audio management
Civilizations	Civ bonuses and resources
Datasets	Enums and constants