An open API service indexing awesome lists of open source software.

https://github.com/mike42/age-tools

Python library and command-line tools for working with Age of Empires I data files.
https://github.com/mike42/age-tools

hacktoberfest

Last synced: 11 days ago
JSON representation

Python library and command-line tools for working with Age of Empires I data files.

Awesome Lists containing this project

README

          

# age-tools [![Build Status](https://travis-ci.org/mike42/age-tools.svg?branch=master)](https://travis-ci.org/mike42/age-tools)

Python library and command-line tools for working with Age of Empires I data files.

## Examples

Render a scenario file to a diamond-shaped image showing terrain, resources and unit locations:

```
age-scenario minimap foo.scx --out foo.png
```

Extract game data to a YAML file. This makes it possible to compare game data files (eg. using `diff`) to check the contents of a mod:

```
age-gamedata extract empires.dat --out empires.yml
```

Extract files from a DRS asset archive to find the "wololo" priest sound:

```
mkdir sounds
age-archive extract sounds.drs --directory sounds/
aplay sounds/5051.wav
```

Render the Babylonian-style Wonder as a PNG image as player 3 (yellow):

```
mkdir graphics interfac output/
age-archive extract --directory interfac Interfac.drs
age-archive extract --directory graphics graphics.drs
age-slp extract graphics/177.slp --palette interfac/50500.bin --player 3 --directory output/
```

Create an empty map (scenario file):

```
age-scenario create --size 50 my-sceanrio.scn
```

Show an XML representation of the parameters in an AOE2 random map script (`*.rms` file):

```
age-rms validate Arabia.rms | xmllint -format -
```

## Attribution

- `dat`, `scn` and `drs` format handling is directly based on [SiegeEngineers/genie-rs](https://github.com/SiegeEngineers/genie-rs).
- SLP file format handling is based on the description at [SFTtech/openage](https://github.com/blob/9f13a91184e16af761fd9b654ff66cb3665261dd/doc/media/slp-files.md)
- RMS parsing is based on the description in the [Random Map Scripting Guide](http://aok.heavengames.com/blacksmith/showfile.php?fileid=12178) by Bultro and Zetnus.