Campaign map AI Model Editor

The aim of this project is to allow Total War modders to create or modify campaign ai model files, such as map_data.esf, pathfinding.ppd and so on. Games supported:

• Total War: ROME 2
• Total War: ATTILA
• Total War: WARHAMMER
• Total War: WARHAMMER 2
• Total War: WARHAMMER 3
• Total War: THREE KINGDOMS
• Total War Saga: Thrones of Britannia
• Total War Saga: TROY

Build instructions:

1. Clone the project to any location on your PC.
2. Open CampaignMapToolkit.sln solution.
3. Right Mouse Click on Solution in Solution Explorer and select "Restore NuGet Packages" from context menu.
4. Build.

GitHub workflow:

1. Branch from master and give a meaningful name for your branch (like a feature name);
2. Commit all your changes and push them to this repo;
3. Create a pull request (PR) (your_branch -> master) and assign either @victimized0 or @MrJox as a reviewer;
4. Your PR will be reviewed and either a) returned to your for improvements/fixes or b) approved;
5. If your PR was returned to you, please, perform the requested improvements/fixes and request merge again.

Project founders:

• MrJox (aka victimized.) - Lead software engineer, reverse engineer. Project author and owner;
• Maruka - Reverse engineer, brain behind pathfinding exporter. Project owner;
• Marthenil - Reverse engineer. Project owner.

Credits:

• Causeless - Info on some aspects of the campaign map, some implementation ideas;
• Ophis - A lot of helpful info of various aspects: campaign map, database, startpos, tilemapping and a lot more;
• PeteCA - General info on how some aspects of campaign work as well as some details on file formats;
• Daniu - ESF library;
• Mitch - Details on some aspects of the campaign map;
• Celebdil - Research and work on borders.pbd file;
• Leoman - Research on tilemapping and help with figuring out hlp_data and spd_data (together with Ophis);

Contributors:

• MrJox - Architecture and vast majority of the source code programming;
• Celebdil - Borders exporter code;
• CharlesWoodhill - Hex spacing setting in preferences;
• TadeoM - Painting tool feature;

Terms of use:

• All files generated by CAIME may not be given away without express permission from at least one of the project founders: MrJox (aka victimized.), Maruka and Marthenil. All rights reserved.
• We prohibit the use of files generated by CAIME for any commercial use (including donations), unless explicitly allowed otherwise.
• Breaching the terms of use might lead to legal implications. Please, respect the amount of work we've put in this project.