How to Add Provinces

We use This Tool, so take a look. It should explain a lot before starting.

After you place the tool in some folder, you have to open config.properties and edit moddirectory and installdir paths to your like on this example:

Images

Also, you should enable Debug Mode

Steps to add provinces:

• First, open Warcraft-Guardians-of-Azeroth-2\map_data\provinces.png.
• Open Warcraft-Guardians-of-Azeroth-2\_mapFiller\provinceDef.xls.
• Add new colours on the map (try to stick to one colour pallet per region). Better don't do more than one region at a time. Otherwise, your work may become a mess.
  • The average province size is 40x40 - 30x30 pixels.
  • We recommend using GIMP.
    • If using Photoshop, make sure you only use Pencil Tool (and Pencil Mode on Eraser) so there's no anti-aliasing. All colors must be uniform with hard edges. Verify all your files are saved as either 24- or 32-bit PNG (right-click -> Properties -> Details -> Bit depth).
  • Don't use tools except for Pencil and Bucket Fill with Dissolve Mode.
  • I recommend drawing outlines (black line - baronies, white line - counties) on separate layers first.

Outlines

Picking Colour

• Copy the colour you just added to provinceDef.xls. You can add this at the end or in between of other provinces in case you add a province to an existing region.
  • Make sure you copy colours in RGB 0-255 format.
  • Try to keep the original provinces. Don't remove them completely from the map. It may cause conflicts and errors in the future.

Images

• After copying, set province ID (the B column), lieges, culture, religion, etc. DO NOT use the same name for titles of the same rank (barony and barony, county and county).
  • For names, you may take a look at This Site. I use character names for provinces, yes.
  • Don't forget that you can run the tool and open the game to see intermediate results. It may be needed.
  • Each county should have 3-4 baronies. If it's a highly-developed province, it may have 4-5 baronies.
  • Name baronies short, using 1 or 2 words. Avoid names like Forest of Shadows. Words in the name must start with a capital letter.
  • If the province is tribal (U is capital holding), it must have only one tribe.
  • If the province isn't tribal, it shouldn't have 3 castles or cities. There should be diversity.
  • Don't rename the existing counties. If you want another name for them, you can override their names in Warcraft-Guardians-of-Azeroth-2\localization\replace\english\wc_title_replacements_l_english.yml.
  • To find our what ID is free to use, open map_data\definition.csv, scroll to the bottom. You will find the last used ID so higher numbers are free to use.

Images

• When everything is ready, run the tool, open the game and test it.

Images

Pushing to GitHub

Separate this into 2 commits:

• The first one contains only provinceDef.xls without writing GDC in the commit comment.
• The second one contains provinces.png and generated contents with GDC written in the commit comment.

Troubleshooting

Trouble: Province names disappeared from definition.csv.

Solution: Most likely you have some colours undefined. Check Documents\Paradox Interactive\Crusader Kings III\logs\error.log. Look for Undefined colors: message.

Trouble: The game crashes.

Solution: Most likely titles of the same rank (barony and barony, county and county) have the same name. Check Documents\Paradox Interactive\Crusader Kings III\logs\error.log. Look for gamestate.cpp:2739 error.