Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/marfullsen/aoe2-minimap-generator

Minimap generator for Age of Empires 2 savegames.
https://github.com/marfullsen/aoe2-minimap-generator

aoe2 games mgz minimap pillow python recordedgame

Last synced: about 2 months ago
JSON representation

Minimap generator for Age of Empires 2 savegames.

Awesome Lists containing this project

README 

        
# AoE2 Minimap Generator

[![Python](https://img.shields.io/badge/Python-3.7.7-blue.svg)](https://www.python.org/)

[![Pillow](https://img.shields.io/badge/Pillow-8.0.0-green.svg)](https://pypi.org/project/Pillow/)

[![Mgz](https://img.shields.io/badge/Mgz-1.5.0-green.svg)](https://pypi.org/project/mgz/)



[![Screenshot](./screenshots/screenshot_001.png)](https://github.com/Marfullsen/AoE2-minimap-generator) 

[![Walls](./screenshots/fortress.png)](https://github.com/Marfullsen/AoE2-minimap-generator)



## Description

Minimap generator for Age of Empires 2 savegames.



## Features

Vesion 1.1

- The bugs with some map sizes were fixed.

- Walls are now displayed on the minimap.

- All code was unified to a single 'main.py' file.

- New screenshots added to the readme.

- The code was tidied up, funcions are now more readable.



version 1.0.

- Generate minimap from a saved game (.mgl, .mgx, .mgz and .aoe2record files).

- Rotate the map and add transparency to the background.

- Display the location of each player.

- Display the piles of gold and stone resources.

- Display the food resorces (berry bushes, animals like sheeps, fishes, boars, etc.)

- Display Relics on the minimap



## Dependencies

- [mgz](https://github.com/happyleavesaoc/aoc-mgz) (Also via pip: `pip install mgz`)

- [Pillow](https://pillow.readthedocs.io/en/stable/installation.html). (also via pip: `pip install Pillow`)



## Usage

First, make sure you have **Python3** installed on your machine.



Place the saved games **in the same path as the Python script**, then **after having installed the necessary dependencies** run the Python script **"main.py"**, voilà, minimap images will be generated, displayed and saved in the same directory.



You could also move the python script called 'main.py' to your folder with the savesgames, run the script and it should work.



## Installing Dependencies

Try these commands until you find one that works for you (this is because each linux distro is very picky), one of them should be suitable for you. [source: this question on Stack Overflow](https://stackoverflow.com/questions/20060096/installing-pil-with-pip)



**Linux**

```

sudo pip3 install pillow

sudo python3 -m pip install pillow



```



**Windows**

```

pip install Pillow

```



## The code inside of the Main script file.



**Just scroll to the end of the file, this is the master function**



[![Main script](./screenshots/main_code.png)]()



## Tiles colors available.

Extracted from [recage/examples/map/terrainColors.json](https://github.com/genie-js/recage/blob/master/examples/map/terrainColors.json).



[![colors](./screenshots/colors.png)](https://github.com/Marfullsen/AoE2-minimap-generator/blob/master/colors_available.py)



## TODOs.

:heavy_check_mark: Add new TODOs.



:heavy_check_mark: Fix bugs with some map sizes.



:heavy_check_mark: Add walls when fortress (or whenever).



:heavy_check_mark: Unify all code to a single 'main.py' file.



:black_square_button: Create a .exe file to non-python users.



:black_square_button: Add more tests, with more maps & more sizes.



:heavy_check_mark: Tidy up all the mess with the files and screenshots.



## Development Screenshots



**White walls**



[![White Walls](./screenshots/white_walls.png)]()



**Final without resources**



[![No Resources](./screenshots/screenshot_003.png)]()



**Square without resources**



[![square_no_resources](./screenshots/square_map_no_resources.png)]()



**Square with resources**



[![square_with_resources](./screenshots/square_map_with_resources.png)]()



**Square with resources and players**



[![square_with_resources_and_players](./screenshots/square_map_with_resources_and_players.png)]()



**Extra Large Player Points**



[![Extra-Large PP](./screenshots/extra-large-player-points.png)]()



## Contributing

All contributions are welcome!

Feel free to open a pull request.



## Credits

Thanks to [aoc-mgz](https://github.com/happyleavesaoc/aoc-mgz) by [@HappyLeavesAoC](https://github.com/happyleavesaoc/) for the extract functions.