First you have to understand how maps are generated in Songs of Syx. In this game maps are heightmaps[en.wikipedia.org] that the game uses to generate the world. The generated map will retain the overall design of the heightmap but will be altered by the game’s world generation which adds mountains, bodies of water and forests. The heightmaps that the game uses are basically 100x100 black and white pictures, this means we can easily paint our own maps. These are the game's heightmaps:



Black is the lowest altitude (sea), white is the highest altitude (mountains) and grey is in between both (land). When creating the map you should know that grey can’t be dark grey or light grey because the game will interpret it incorrectly, either as black or white, depending if its too light or too dark so it's value must be in between, shown in the next image.



To understand it further, we can grab one of the game's files, for example, The Eye. The first image is the file inside the game's folder, the second one is what you see in-game when choosing a map and the third one is an example of the same map after world generation. You can see the differences and similarities.

In order to create a heightmap of your own you will need a photo editor. Since they are just 100x100 black, grey and white pictures you can paint them yourself, so any basic software will do, like Paint, although I personally use GIMP (it’s free). Let's see the whole process with an example:

1. Open your photo editing software and create a new 100x100 image.



2. Paint your map using the colours mentioned above (black, grey and white). I’m doing a simple 8 shape surrounded by water and a mountain range going trough the middle.



3. Save it as .png and place it in the following folder:
Steam\steamapps\common\Songs of Syx\base\data\data\assets\sprite\world\generatorMaps
There is an alternative to this step in the next section.

4. You can now open the game and play your map.



If you want to create a map based on a real map (i.e. the map of your country) head to the last section: Advanced Heightmap Generation Techniques

This option has many advantages if you want to create multiple maps, have them all in the same folder with all your other maps and maybe share them easily. For that you would only need to send the folder to whoever you want and they would need to place it in the game's mods folder.

The following information was taken from the Songs of Syx’s modding guide for version 0.64.1[drive.google.com] (by Jake, Superwutz and Bendigeidfran) I will be merely paraphrasing only what you need to know to implement a map mod:

Open the run dialog box (windows key + R, in Windows) and type %appdata%\songsofsyx. Go to mods and inside that folder create a folder with any name (i.e. the name of your map). Inside that folder you will need a text file called _Info.txt. Open the file (notepad will do) and type the following info:

VERSION: "1",
GAME_VERSION_MAJOR: 66,
GAME_VERSION_MINOR: 0,
NAME: "My Mod",
DESC: "This is a short description of all the wonderful things my mod adds.",
AUTHOR: "Some Handsome Devil",
INFO: "",

You can copy and paste it and change the information as you’d like, but respect the format. GAME_VERSION_MAJOR should indicate the current version of the game (right now it's 66). You will also need a folder that corresponds to the listed major version, in this case you can do V66 as it is the current stable version of the game.



Inside V66 you want a folder called assets, a sprite folder inside, a world folder inside that one and a generatorMaps folder inside the last one. A bit confusing but the whole path inside your mod folder should look like this: V66\assets\sprite\world\generatorMaps. Inside generatorMaps place the map .png file and you will be done.



(The images are outdated, V65 should simply say V66)

Make sure to activate your mod when you open the game. Just click on it, it should have a number on the left (0, 1, 2… depends on how many mods you have on).

Unfortunately, due to the nature of APIs and the frequency of access change, websites that host topographic data often go down without warning. Previous reliable sources like terrain.party no longer function. One of the most reliable ways to get topographic data are through OpenTopography (limit of 50,000 square km for custom area downloads) and OpenStreetMaps.

Heightmaps from real life data are often noisy, come with artifacts, and need to be combed over manually before using. You often need to adjust the luminosity curve to create maps that integrate with Syx well.

Here's an example of what I had to do to the Japanese heightmap to get it to play nicely in SoS. The program I'm using is Paint Dot NET. Any program that lets you adjust luminosity will suffice.


You can use programs such as Gaea and World Machine to generate black-and-white heightmaps for use in Songs of Syx. These programs typically have a resolution limit, but those tend to not be a factor, as the target resolution is simply 100x100.

While I (Captain Klutz) have not made a commentated tutorial on World Machine, many do exist online, and you can find videos of my process on my YouTube channel.