Metadata-Version: 2.4
Name: genieutils-py
Version: 0.1.1
Summary: Re-implementation of genieutils in Python
Project-URL: Homepage, https://github.com/SiegeEngineers/genieutils-py
Project-URL: Issues, https://github.com/SiegeEngineers/genieutils-py/issues
Author-email: SiegeEngineers <genieutils@siegeengineers.org>
License-File: LICENSE
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# genieutils-py

Python implementation of [genieutils](https://github.com/Tapsa/genieutils).

This library can be used to read and write `empires2_x2_p1.dat` files for Age of Empires II Definitive Edition.


## Supported dat versions

Currently, only the recent versions used in Age of Empires II Definitive Edition are supported
(`GV_C20` and above, corresponding to FileVersion 7.7 and above).


## Installation

```shell
pip install genieutils-py
```

## Usage examples

### Dump the whole dat file as json

The package comes with a handy command line tool that does that for you.

```shell
dat-to-json path/to/empires2_x2_p1.dat
```


### Change cost of Loom to 69 Gold

```python
from genieutils.datfile import DatFile

data = DatFile.parse('path/to/empires2_x2_p1.dat')
data.techs[22].resource_costs[0].amount = 69
data.save('path/to/modded/empires2_x2_p1.dat')
```

### Prevent Kings from garrisoning

```python
from genieutils.datfile import DatFile

data = DatFile.parse('path/to/empires2_x2_p1.dat')
for civ in data.civs:
    civ.units[434].bird.tasks.pop()
data.save('path/to/modded/empires2_x2_p1.dat')
```

## Running tests

**Before running tests, you need to add sample `empires2_x2_p1.dat` files into the `tests/testdata` subfolder.**

1. Create a virtual environment  
   `python3 -m venv venv`
2. Activate the virtual environment  
   `source venv/bin/activate`
3. Install the dev dependencies  
   `pip install -r requirements-dev.txt`
4. Install the local checkout of genieutils-py in editable mode
   `pip install -e .`
5. Run the test script
   `./test`


## Authors

[HSZemi](https://github.com/hszemi) - Original Author
