1. Run the program.
2. In the main menu you'll see a list of players on the left. Choose a player count and select which nations will be used.
3. Click the generate button. The generation process could take up to 3 minutes depending on the player count and your computer specs.
4. Once the map is generated, you can move the camera around by clicking and dragging.
5. Right click a province node or connection node to open the editor panel for that node.
6. Once you are happy with the map, click the export button. Maps are exported to the data folder.

In addition to coding the entirety of MapNuke i created all of my sprites from scratch for the default art style. For the most part i'm pretty happy with how they turned out, however there are some that need improvement and i just don't have the time/expertise to make better ones.

I made a little pocket pocket change from donations for MapNuke so i'm putting some of it towards bounties for improved sprites.

The default art style for MapNuke is somewhat limited in its color palette so that is one restriction to bear in mind. I tried to combine a simple color palette with nice crisp sprites. If you do accept any of these bounties please check in with me before you invest a lot of time into your sprites so i can give pointers etc... Checking in often is good, as it helps avoid situations where lots of work ends up needing adjustments. I try to be somewhat flexible but if a submission doesn't follow the rules in place or lacks a certain degree of quality then I won't accept it. Remember, these sprites are going to appear on a lot of maps people use so I'm aiming for quality over quantity.

You can inquire about bounties here: https://discord.gg/aZMJwSR7

The current mountain sprites have wack shading and weird shapes.

What needs work: All of the mount and bigmount sprites (ignoring the bigmountb sprites) in Gfx/MapArt/Default/Mountains. In total there are 10 sprites plus another 10 winter versions of the sprites (although the winter versions can be ignored if you don't feel like doing those).

The rules: Try and keep the same color scheme. You can introduce 1 or 2 more shades of the same color but it's best to not go overboard. Less is more. Cave sprites need to have the colored shadow at the botton so they blend nicely into the ground. The smaller mountain sprites can be totally overhauled and replaced with something else if you have any ideas. They kind of felt out of place anyhow.

The bounty: $55 CAD.

The cave sprites suffer from the same issues as the mountains. It would be trivial to copy over the mountain sprites and reuse them as caves with a color swap but i'd like it if caves were also unique looking in their own way.

What needs work: All of the cave and bigcave sprites (ignoring the bigcaveb sprites) in Gfx/MapArt/Default/Caves. I'd like it if caves had the same amount of sprites as mountains, ie. 7 large sprites in various sizes plus the 3 smaller ones. In total there are 6 sprites plus another 6 winter versions of the sprites (although the winter version is easy to do since it's the same sprite but with a lighter set of colors and some snow on top). In addition there would be the 4 new large cave sprites.

The rules: Try and keep the same color scheme. You can introduce 1 or 2 more shades of the same color but it's best to not go overboard. Less is more. Cave sprites need to have the colored shadow at the botton so they blend nicely into the ground. For new sprites, try and copy the sizing scheme used in the existing mountain sprites. The smaller cave sprites can be totally overhauled and replaced with something else if you have any ideas. They kind of felt out of place anyhow.

The bounty: $55 CAD.

The highland sprites have weird shading and i'm not sure i like them in their current state. Maybe something more hill-like would be better. Open to ideas.

What needs work: All of the bigmound sprites (ignoring the bigmoundb sprites) in Gfx/MapArt/Default/Highlands. I'd like it if highlands had the same amount of sprites as mountains, ie. 7 large sprites in various sizes plus the 3 smaller ones. In total there are 3 sprites plus another 3 winter versions of the sprites (although the winter version is easy to do since it's the same sprite but with a lighter set of colors and some snow on top). In addition there would be the 4 new large highland sprites.

The rules: Try and keep the same color scheme. You can introduce 1 or 2 more shades of the same color but it's best to not go overboard. Less is more. Highland sprites need to have the colored shadow at the botton so they blend nicely into the ground. For new sprites, try and copy the sizing scheme used in the existing mountain sprites.

The bounty: $55 CAD.

The sea caves and reefs are just reskinned mountain sprites and look similarly crappy.

What needs work: All of the bigseacave and bigseareef sprites in Gfx/MapArt/Default/Sea. In total there are 6 sprites plus another 6 winter versions of the sprites (although the winter version is easy to do since it's the same sprite but with a lighter set of colors and some snow on top). My kelp sprites are also kind of lame, if you can think of a better version of those i'm all ears (and i'd increase the bounty accordingly if you were to redo them).

The rules: Try and keep the same color scheme. You can introduce 1 or 2 more shades of the same color but it's best to not go overboard. Less is more. These sprites need to have the colored water shadow at the botton so they blend nicely into the sea texture.

The bounty: $40 CAD.

There are house sprites for large provinces. Some people have suggested replacing them with something more city-esque instead of it just being a single house. There's a bit of freedom here for replacing them, if you think of something better then i'm all ears.

What needs work: All of the house sprites for plains, farms, wastelands, swamps, forests. In total there are 10 sprites plus another 10 winter versions of the sprites (although the winter version is easy to do since it's the same sprite but with some snow on top).

The rules: Stick with the same color theme the existing sprites have and avoid adding too many shades of the same color. Less is more. There's some freedom here for how you approach the replacement. It might be possible to just have a centerpiece single city sprite instead of sprinkling houses all over the place.

The bounty: $55 CAD.

MapNuke now allows you to add your own custom art styles. The sprites and materials used by the map generator are dictated by the art style. Here's a step by step guide for adding your own.

1. Fork this repository on GitHub.
2. Clone your forked repository using SourceTree or some other source control app.
3. Install Unity Hub.
4. Download Unity version 2019.2.11f1 through the Unity Hub then open the MapNuke project using that Unity version.

⚠ Only Unity 2019.2.11f1 is currently compatible with this project! Using any other version will cause issues. ⚠

5. Create the folders you'd like to store your art assets in. For example, the default art assets are stored in Gfx/MapArt/Default. Your folder will be named something like Gfx/MapArt/MyArtStyle.

6. Add your desired sprite assets in your new folder. Click on art assets to view and edit their import settings.

⚠ Make sure your sprites have the "Art" packing tag in their import settings or they will have rendering issues! If you aren't sure about something, just copy the settings used in one of the default sprites. ⚠

⚠ Do not use a perfectly white color (ie. a color with 100% red, green, and blue) in your sprite. It will cause issues. Dominions 5 uses that color to track province positions. If you need to use white in your sprite, make it an off-white. ⚠

7. Create the folders you'd like to store your materials in. For example, the default materials are stored in Gfx/Materials/Default. Follow a similar naming convention to what you did in step 2 here. Import any textures being used for the province materials (if applicable) into this folder. You can examine the default materials which use a noise shader to see how those are done. You'll want to use a different shader if you're doing a texture-based material.

8. Open the main scene (File -> Open Scene -> Scenes -> Main) and navigate to the Prefabs folder in the project browser.

Duplicate the Default art style prefab and rename it (in this example, the newly created prefab is MyArtStyle). Click and drag your new prefab into the ArtStyles in the scene browser.

9. Click on the newly made art style prefab and examine its properties. You'll see a collection of values you can modify.

It's a bit complex so i'll try to describe what the values for each terrain type do:

• Cull Chance - A value between 0 and 1. Higher values will result in less sprite density on the province. Try generating a map using a value of 0 and then with a value of 0.99 if you want to see the difference it makes.

• Province Edge Threshold - How close to the edge of the province can sprites be? This helps stop sprites from overlapping over borders into other provinces.

Each sprite has several parameters:

• Sprite - The sprite to use in summer. Use transparent_pixel.png for your summer sprite if you don't want anything to render in summer.

• Winter Sprite - The sprite to use in winter. Use transparent_pixel.png for your winter sprite if you don't want anything to render in winter.

• Size - How large the sprite is. This value is used to determine if it's too close to the edge of the province or overlaps another sprite.

• Culling Radius - This value is used to remove potential sprite placement positions near the sprite. This helps with reducing overlap between sprites.

• Cull Sprite Positions - This boolean value determines whether a sprite should ever cull nearby sprite positions.

• Spawn Chance - Value between 0 and 1, 0 being nonexistent and 1 being very common.

• Can Flip - Can the sprite be flipped on the X axis? If so, there is a 50% chance it will randomly flip a given sprite. Mostly used with grass sprites.

• Can Flip Winter - Same as above but in winter.

• Is Centerpiece - Some province types (ie. caves, mountains) have a large central sprite. These are centerpieces. Only one centerpiece is used and it's selected based on the size. Examine the cave province centerpieces in the default art style to understand this better.

• Place At Least One - If this is enabled, each province will have at least one of these sprites present. Disable this option if you want to make certain sprites more rare.

• Valid Colors - List of valid colors to tint the sprite with. Just use white with 100% alpha if you don't want the sprite to be tintable.

• Valid Colors Winter - Same as above for winter.

• Valid Terrain - What type of terrain flag is required for this sprite to get used? Certain provinces (ie. wasteland) use this to specify special sprites for hotter/colder province modifiers. Examine the default art style to understand this better.

10. Add your materials from step 3 to the material list.

11. Click the play button and test your art style out. It should appear in the art style dropdown list next to the nation picker menu.

Custom art styles can specify which materials each province type uses. There are several custom shaders included with MapNuke you can make use of in your custom materials.

The perlin noise shaders create a randomized set of colorful blobs. Perlin3 lets you choose 3 colors, Perlin4 is for 4 colors and Perlin5 is for 5 colors.

There are some special perlin noise shaders used in niche cases:

• Custom/Perlin5write
• Custom/Perlin6write
• Custom/Perlin5read

These use stencil buffers to create a shoreline effect in bodies of water (and rivers). The materials for sea provinces would use the Perlin5write shader and the shorelines would use the Perlin5read shader.

These shaders are useful for just basic textures. In many cases it's probably preferable to use this shader since handmade textures are always nicer than basic perlin noise. The size of your texture needs to match the shader, ie. Custom/Texture2048 should be used with a texture that is 2048x2048 pixels.

I recommend using 2048x2048 as your texture resolution. 1024x1024 is a bit low and 4096x4096 is a bit overkill.

There are some special texture shaders used in niche cases:

• Custom/Texture1024read
• Custom/Texture1024write
• Custom/Texture2048write
• Custom/Texture4096write

These use stencil buffers to create a shoreline effect in bodies of water (and rivers). The materials for sea provinces and rivers would use the TextureXXXXwrite shader and the shorelines would use the Texture1024read shader.

Your texture import settings should look something like:

Use point filtering if you want crisp pixel art and bilinear/trilinear filtering if you want antialiasing.

These shaders combine perlin noise with textures. Could be useful for some niche cases.