Expect the unexpected! An Age of Empires 3 style 2D map generator using Perlin noise and Poisson Disk techniques.
Generate AoE3 minimaps which aim to be (somewhat) similar to the maps included in the game. The currently supported map types are the land and island types, with snow, plains, andes, and decan as available biomes.
The Generator uses Perlin noise to generate the island and lake shapes. For placing forests, mines, hunts, and treasures, the Poisson Disk sampling method is used to ensure a minimum distance between the objects of the same type. Other familiar objects such as Town Centers, Trade Routes and Native Settlements are also randomly generated.
For the Windows platform, a .exe executable is available here, created using the Gooey platform. This can be used to adjust the program's parameters and run the program using a GUI.
Install dependencies using:
pip install -r requirements.txtThis will enable you to use the program in its CLI mode. To use the GUI, also install the Gooey package:
pip install GooeyTo generate a map using the CLI, run the program as follows:
python generate.pyThe generated map will be automatically saved in the out subfolder. Additionally, the following flags can be added to the run command:
| Option | Action | Choices | Default |
|---|---|---|---|
| --out | Specify output directory | str | ./out |
| --size | Specify map size | int | 600 |
| --type | Specify map type | {random, island, land} | random |
| --biome | Specify map biome | {random, snow, plains, andes, decan} | random |
| --seed | Specify map seed | int | None |
| --no | How many maps to generate | int | 1 |
| --compass | Place compass graphic around maps | bool | False |
The same options can also be set using the GUI on windows:
