Map making support and conversion tool: post-Atlas

[Grautvornix]

Trying Atlas I found a few things I wasn't able to manage properly (or wasn't careful or patient enough) such as properly connected wall segments and turrets. I finally started to write (with heavy support by Anthropic Claude) a little map analyzer/checker/converter tool, written in python, able to 

• check the maps created with Atlas and offer options to correct issues
• analyze existing maps , also from older game versions, giving statistics, finding and offering to fix glitches (resource placed underneath a building or wall, trapped units, gaps in wall segments etc.)
• add a (poor) map preview if not existing or convert the Atlas screenshot into a preview file.
• converting and fixing older scenario and skirmish maps using the conversion scripts by @Stan` (e.g. renaming persian objects/units to achaemenids)

I was only able to test on windows, it should theoretically work on Linux or MacOS as well (Python 3.14, pyQT6, numpy and pillow needed, see documentation). No real guarantee to always work (definitely NOT on random maps), but I was able to successfully convert a few great maps from past I found in the forum and play them.

 

Note: I only started experimenting with maps  so I haven't seen all pitfalls by far.
Should you have observed further typical mapping issues, I'd be interested to know and try integrating these into the analyzing and fixing section of the tool if possible.

 

 

 

 

 

 

 

post-atlas-1.1.0.zip README.md

Edited 44 minutes ago by Grautvornix
Updated tool version to 1.1.0 plus one new screenshots

[Asher]

Just ran it on macos, it worked, though I didn't really try anything. The gui is pretty small, could you make it bigger please

[Grautvornix]

Thanks exellent news!

Your are right - the GUI is a bit "fiddly" and appears overloaded will have a careful look and try and imporve.

Used it to convert very nice older skirmish and scenario maps already that I was missing 

[Grautvornix]

Did a total review and refactoring of the user interface and functionality. Hope it is better now.

I am placing the python code and new screenshots in the original post on top of this conversation. @Asher I'd love to have  your comemnts - please have a look!

Edited 19 hours ago by Grautvornix

[Asher]

3 hours ago, Grautvornix said:

Did a total review and refactoring of the user interface and functionality. Hope it is better now.

I am placing the python code and new screenshots in the original post on top of this conversation. @Asher I'd love to have  your comemnts - please have a look!

I loaded some maps, and it worked. Can you make it so you can load mods for it, like if you are making a map for a mod that adds new structures. Because it was saying a certain civ name was undefined, but it was, just in a mod. Maybe you already added the setting, but I didn't see it

[Asher]

Also if you could add tool tips. When on dark theme, it is had to tell which buttons you can click and not click (see photos). Could you have some other colors, pwease. Also, do you use github or gitlab or any of those type things? It might be easier for other people to update or something

[Grautvornix]

8 hours ago, Asher said:

Can you make it so you can load mods for it, like if you are making a map for a mod that adds new structures. Because it was saying a certain civ name was undefined, but it was, just in a mod. Maybe you already added the setting, but I didn't see it

Thanks! Very good - I'll take that on board.

 

8 hours ago, Asher said:

Also if you could add tool tips. When on dark theme, it is had to tell which buttons you can click and not click (see photos). Could you have some other colors, pwease. 

Oops! Good point as well. Needs to be changed. 

8 hours ago, Asher said:

Also, do you use github or gitlab or any of those type things? It might be easier for other people to update or something

You are right, was just lazy and tried to keep it initially simple for me on a local repository. Will change that.

[Grautvornix]

@Asher  Here is a bit of feedback on dependencies on entities in other mods:

post-Atlas already reads dependencies and shows them on the Analyse tab. What it does not do is connect them to the entities a map places — which is your actual request

• A maps mod.json provides Dependencies as a real key: "dependencies": ["0ad>=0.28.0", "millenniumad>=1.0"]. Operators are <=, >=, =, <, >.
• A dependency with no operator is not checked at all. CheckForIncompatibleMods only compares when it finds an operator in the string, so "dependencies": ["millenniumad"] is documentation, nothing more. Write millenniumad>=0 if you want it enforced.
  CAVEAT: It requires the other mod to be enabled, not merely installed — the version table is built only from the mods in that launch list. 
• It names the mod's name key, not its folder. The base game is 0ad, though its folder is public.

Proposed solution: 

Today a template that isn't in public or the map's own mod produces entity-template-missing, a FAIL, while another mod might have it. Four steps:

1. When templates are missing, search the other mods in the selected install — its own binaries/data/mods and the user's Documents\My Games\0ad\mods, both of which Session already knows — for simulation/templates/<name>.xml, and for actors under art/actors/. Only when something is missing, so nothing slows down.
2. Report what was found by name: "structures/mil/tower is in mod millenniumad (Millennium A.D. 1.2)" — the finding turns from "broken map" into "enable this mod". Where nothing is found: say plainly that these are probably from a mod not installed here, and name the count.
3. Check the map's own mod.json against that: entities from mod X with X not in dependencies → WARN, with an automatic fix that adds X>=<installed version>. write_mod_json already preserves keys it doesn't own, and the converter already writes the file.
4. Conversion and Test in Game: carry the dependency into the converted mod's mod.json, say in the report which mods must also be enabled, and add them to the -mod= list when launching.

The other issues,

• inactive buttons not being visible on dark schem,
• missing light scheme, 
• missing tooltips

Are also addressed. As usual I'll put the release into the top message of this thread. Let me know if something is missing or failing!