查看“地图模组制作”的源代码

{{version|2.7}}
Many things can break the game while modding the map files, see [[#Troubleshooting|troubleshooting]].

The most important is the format used while saving, as wrong formats will cause CTDs while loading:

{| class="wikitable"
|-
! File
! Role
! Format
|-
| [[#Provinces|provinces.bmp]] 
| Province boundaries
|rowspan=2| '''RGB Color (24 bits)''', no color space information
|-
| [[#Lighting|world_normal_height.bmp]]
| Lighting
|-
| [[#Rivers|rivers.bmp]]
| Flow of minor rivers
|rowspan=3| '''Indexed color''' (8 bits)
|-
| [[#Terrain|terrain.bmp]]
| Terrain textures
|-
| [[#Trees|trees.bmp]]
| Tree types and density
|-
| [[#Topology|topology.bmp]]
| Height of the terrain
| '''Greyscale''' (8 bits)
|-
|}

The height and width of these images should be multiples of 64 to avoid CTD at startup.

But in practice it needs to be a multiple of 256, otherwise some black bars will appear on the edge of the map.<ref>[[forum:1115808/#post-24825843]]</ref>

== default.map ==

'''Default.map''' contains general information about the map. Most items in it should be left alone. Here are the ones you need to worry about:
* '''max_provinces''': This is the number of the last province + 1. If you forget to add one, the last province will get ignored.
* '''sea_zones''': This contains two sea province IDs that are at opposite ends of a range of contiguous sea province IDs. You must have exactly two province IDs listed for each sea zone. You may have multiple sea_zones defined, one for each range of contiguous sea provinces. Note: Each sea province in a sea zone is considered to be reachable by ship from every other one in the same sea zone. (Exception: A sea province that has no neighboring sea provinces is assumed by the game to be a lake, and does not generate ports adjacent to it.)
* '''ocean_region''': This contains a list of sea zones (automatically numbered based on their position in the file), all of which can be navigated to from the others. You may have multiple ocean_regions.
* '''major_rivers''': All sea zones listed here are major rivers, and can be navigated by any religion with allow_rivermovement = yes.
* '''externals''': A list of points that are considered outside all provinces. Used (for instance) as the start points of trade routes that extend off the map. A single point of the color defined for this province is placed on the map in the direction the trade route is intended to come from.

Note: sea_starts was made obsolete as of patch 2.1 (Rajas of India). The above information is current as of patch 2.6.

== Provinces ==

[[File:Provinces.png|thumb|500px|right|provinces.bmp]]

'''Provinces.bmp''' is probably the most important file in your map, because it shows the boundaries of all counties and sea zones. Each color corresponds to an entry in [[definition.csv]]. When editing provinces.bmp, make sure to only use solid colors, and no antialiasing, transparency, or anything else. 

== Adding a province ==

Adding a province requires to follow many steps. Here is a list of what needs to be done.<ref>[http://citadel.prophpbb.com/topic6223.html  Guide on adding new provinces on the citadel forum]</ref>

* Choose a colour that's not already taken. In case of uncertainty of how to find a new one, pick one of the already existing RGB values at the end of <code>map/definition.csv</code>. You can use the RGB values of other Clausewitz games which have a higher province count (like HoI4 with >13k)

* Colour in the province on [[#Provinces|map/provinces.bmp]]. Make sure to only use solid colours, and no antialiasing, transparency, or anything else. If GIMP is used, follow the instructions on [[#GIMP editing|GIMP editing]].

* Open [[#Definition|map/definition.csv]]. After the last province entry, add the new province. 

* In [[#default.map|map/default.map]], increase the amount max_provinces by 1.

If everything was done right, when the game is opened it should be possible to see the new province in grey on the map.

* Create a file with the number and name of the province in <code>history/provinces/</code>

* Add a title for the province in the appropriate [[Title modding|common/landed_titles/]] file

* Create a history file for the title in <code>history/titles/</code>.

* Add an entry for the province in the appropriate <code>common/province_setup/</code> file. (Unless you are modding older versions, this is no longer needed)

* Add a climate for the province in [[#Climate|map/climate.txt]] if necessary

* Add the name of the province in the appropriate [[Localisation| localisation/]] file for province names. 

* Add the name of the title in the appropriate [[Localisation| localisation/]] file for titles.

* Add a coat of arms for the title in <code>gfx/flags/</code>. It needs to be 128x128 and saved as .tga

* Fix the positions of the new province using the [[Nudge| Nudge tool]]

=== GIMP editing ===

When using the Pencil tool, set mode to Dissolve, brush "Hardness 100", size 1.00, and dynamics to "Dynamics Off". When using Bucket Fill, set mode to Dissolve.

When saving, make sure "Do not write color space information" under Compatibility Options is checked, and under Advanced Options pick 24 bits, R8 G8 B8. Using different settings will cause CTDs while loading.

== Definition ==

The file '''definition.csv''' lists all provinces and their colors in [[provinces.bmp]]. Each line is formatted like this:

 1;42;3;128;Vestisland;x

1 is the province's id number. 42,3,128 is its RGB color in provinces.bmp. Vestisland is the name of the province, but the name that actually shows up on the map is determined by the localisation. The "x" is just there to mark the end of the line.


== Adjacencies ==

'''Adjacencies.csv''' is used to make special connections between provinces. This file can be associated with Microsoft Excel although it is advised to use text editors like Notepad++ when editing this file.

=== Seas ===
Connections through seas are often used to connect pieces of land that are close together, for example the Aegean islands.

Making a connection for two provinces through a sea is coded like this:
<pre>Province number 1;Province number 2;sea;The sea the connection will go through;X₁;Y₁;X₂;Y₂;Comment</pre>

For example is this the connection between Corsica and Sardinia:
<pre>324;325;sea;1027;-1;-1;-1;-1;Corsica-Arborea</pre>

In most cases, the game automatically chooses a point in each province based on proximity to draw the crossing path. If custom points are required (for example to prevent overlap with other crossings, to simulate a historical crossing point, or simply for stylistic reasons) the parameters '''X₁''', '''Y₁''', '''X₂''' and '''Y₂''' may be used to define these points. In most cases this isn't necessary, so these values are set to -1, allowing the game to determine the points automatically.

=== Major rivers ===

Connections through Major rivers are used to connect the land that would be connected if there were a normal river or no river at all.

Making a connection for two provinces through a major river is coded like this:
<pre>Province number 1;Province number 2;major_river;The major river that the connection will cross;-1;-1;-1;-1;Comment</pre>

For example, this is the connection between Holland and Breda across the Rhine:
<pre>80;92;major_river;1043;-1;-1;-1;-1;Holland-Breda</pre>

=== Portages ===
A Portage is a connection for seas through land. Portages are coded like this:
<pre>Sea number 1;Sea number 2;portage;The land province the connection will go through;X₁;Y₁;X₂;Y₂;Comment</pre>

For example this is the connection for the Don and the Volga:
<pre>1089;1094;portage;595;-1;-1;-1;-1;Don-Volga</pre>

Like sea crossings, the '''X₁''', '''Y₁''', '''X₂''' and '''Y₂''' parameters may be used to define where the crossing is drawn.

== Positions ==

{{Main|Positions.txt}}

The file '''positions.txt''' determines where cities, ports, councillors and armies are placed on a province.

== Rivers ==

[[File:Rivers.png|thumb|500px|right|rivers.bmp]]

'''Rivers.bmp''' shows all minor rivers on the map. It does not include major navigable rivers, which are treated as sea zones, and colored pink in rivers.bmp.

Any river that merges with or splits from another river is part of a river system. Each river system can only have one source (green dot). Each individual river can only be one pixel. Two river pixels must be orthogonally (not diagonally) adjacent to be part of the same river. When a river joins another river, a red dot needs to be used. In addition, the color of the river corresponds with the size of the river and the defense bonus received. <ref>[https://forum.paradoxplaza.com/forum/index.php?threads/map-mod-testing.588084/page-6]</ref>

rivers.bmp uses an indexed color palette. CTDs will occur if you save it without the right palette, so I recommend opening the vanilla rivers.bmp and copying and pasting your map over it.

{| class="wikitable"
! Category
! Color
! RGB
! Hex Code
|-
|River Source
|style="background:#00ff00;"|
|0 255 0
|#00FF00
|-
|Minor River source from Major River
|style="background:#009e00;"|
|0 158 0
|#009E00
|-
|Merging River
|style="background:#ff0000;"|
|255 0 0
|#FF0000
|-
|Splitting River
|style="background:#fffc00;"|
|255 252 0
|#FFFC00
|-
|Water & Major Rivers
|style="background:#FF0080;"|
|255 0 128
|#FF0080
|-
|Land
|style="background:#FFFFFF;"|
|255 255 255
|#FFFFFF
|-
|rowspan=8| Rivers
|style="background:#00ffff;"|
|0 255 255
|#00FFFF
|-
|style="background:#00c8ff;"|
|0 200 255
|#00C8FF
|-
|style="background:#0096ff;"|
|0 150 255
|#0096FF
|-
|style="background:#0064ff;"|
|0 100 255
|#0064FF
|-
|style="background:#0000e1;"|
|0 0 225
|#0000E1
|-
|style="background:#0000c8;"|
|0 0 200
|#0000C8
|-
|style="background:#000096;"|
|0 0 150
|#000096
|-
|style="background:#000064;"|
|0 0 100
|#000064
|-
|}

Some other colors are in the index of rivers.bmp, but their usage is not clear.  They do seem to work as rivers as long as there is river source.
{| class="wikitable"
! Note
! Color
! RGB
! Hex Code
|-
|
|style="background:#005500;"|
|0 85 0
|#005500
|-
|Not in the vanilla rivers.bmp
|style="background:#007d00;"|
|0 125 0
|#007D00
|-
|
|style="background:#18ce00;"|
|24 206 0
|#18CE00
|-
|}

== Terrain ==

[[File:Terrain.png|thumb|500px|right|Terrain.bmp]]

'''Terrain.bmp''' is the file that determines the texture of your map and [[terrain]] combat modifiers in a province (although the modifiers can be overridden manually in the files found in '''history/provinces'''). The file is a 4-bit indexed bitmap and so contains a total of 16 possible colors (indices); however, only 14 of these are used on the default map. Each index is mapped to a particular terrain type in '''map/terrain.txt'''. 

Each of the indices corresponds to the tile index in the sprite '''map/terrain/atlas0.dds''' to use for rendering. Several of the indices map to the same terrain type and are merely used to change the texture used - from a gameplay perspective they are identical.

The two indices (13 and 14) which are not used by the base game may still be used by modders. By default they are mapped to the same terrain type as index 15 (i.e. water/ocean; referred to in terrain.txt as coastal_desert) but can be re-mapped in terrain.txt. By default both use a dark brown soil texture (found in the two bottom middle boxes of map/terrain/atlas0.dds).

{| class="wikitable"
! Index
! Color
! Type
! Default terrain type mapped to in terrain.txt 
! style="min-width:6em"|RGB
! Notes
|-
!0
|style="background:rgb(86,124,27);"|
|Plains
|plains
|86 124 27
|
|-
!1
|style="background:RGB(138,11,26);"|
|Farmland
|farmlands
|138 11 26
|
|-
!2
|style="background:RGB(130,158,75);"|
|Coastal desert
|plains
|130 158 75
|Mix between desert and patches of grass.
|-
!3
|style="background:rgb(206,169,99);"|
|Desert
|desert
|206 169 99
|
|-
!4
|style="background:RGB(112,74,31);"|
|Sandy mountain
|mountain
|112 74 31
|Should be in the valleys or where the desert meets the mountains
|-
!5
|style="background:RGB(255,186,0);"|
|Steppe
|steppe
|255 186 0
|
|-
!6
|style="background:RGB(13,96,62);"|
|Arctic
|arctic
|13 96 62
|Similar color to pine needles
|-
!7
|style="background:RGB(86,46,0);"|
|Desert mountain
|mountain
|86 46 0
|Mix of desert and mountain rock
|-
!8
|style="background:rgb(0,86,6);"|
|Forest
|hills
|0 86 6
|
|-
!9
|style="background:rgb(65,42,17);"|
|Snowless mountain
|rowspan="3"|mountain
|65 42 17
|
|-
!10
|style="background:rgb(155,155,155);"|
|Snow covered mountain
|155 155 155
|
|-
!11
|style="background:rgb(255,255,255);"|
|More snow covered mountain
|255 255 255
|
|-
!12
|style="background:RGB(40,180,149);"|
|Jungle
|jungle
|40 180 149
|
|-
!13
|style="background:RGB(213,144,199);"|
|N/A
|rowspan="3"|coastal_desert
|213 144 199
|rowspan="2"|Not used in the base game
|-
!14
|style="background:RGB(127,24,60);"|
|N/A
|127 24 60
|-
!15
|style="background:rgb(69,91,186);"|
|Water
|69 91 186
|On the default map this covers all sea/ocean areas and navigable rivers. Additionally it extends approximately 1 pixel in around coastlines, giving the appearance of a beach
|-
|}

Example of the mapping of ''Plains'' (index 0) and ''Coastal desert'' (index 2) to the same <code>plains</code> terrain in '''map/terrain.txt''', allowing to use a different texture for each one: 
<pre>
categories =  {

  plains = {
	movement_cost = 1.1
	color = { 241 221 184 }
	supply_limit = 5
	bottleneck_chance = 5
  }

}

text_0 = { type = plains color = { 0 } priority = 0 }
text_2 = { type = plains color = { 2 } priority = 2 }
</pre>

== Trees ==

[[File:Trees.png|thumb|500px|right|trees.bmp]]

The '''trees.bmp''' file determines where the trees are, how many there are, and what type of tree they are.

Each colored pixel corresponds to one in-game clump of trees. Note that tree.bmp in the base game is 8.04188481675 times smaller than the other .bmp files so divide the map dimensions by 8.04188481675 and use the result as a reference for this. Custom tree.bmp files may be different sizes/scales than this, but higher-resolution files may cause performance issues as more trees will be spawned on the map, and will lead to a higher density of tree groups, which may be visually unappealing.

=== Type ===

There are '''4''' types of trees:

{| class="wikitable"
! Category
! Density 1
! Density 2
! Density 3
! RGB
! Hex Code
|-
|Palm trees
|style="background:#FFFF00;"|
|style="background:#D5A000;"|
|{{sup}}
|255 255 0
|#FFFF00
|-
|Coniferous trees 
|style="background:#1E8B6D;"|
|style="background:#12644E;"|
|style="background:#083A2C;"|
|30 139 109
|#1E8B6D
|-
|Mediterranean trees
|style="background:#9A9C33;"|
|style="background:#767818;"|
|style="background:#535500;"|
|154 156 51
|#9A9C33
|-
|Deciduous trees
|style="background:#4C9C33;"|
|style="background:#2F7818;"|
|style="background:#145500;"|
|76 156 51
|#4C9C33
|-
|}

=== Density and size ===

Each pixel in trees.bmp represents a hexagon of trees in game.

The '''darker''' the color the more '''dense & larger''' the trees.

For instance if we use the lightest color of deciduous trees we will get a hexagon of 6 or more small trees. If we use the darkest color we get a hexagon of full of bigger trees.

== Topology ==

[[File:Topology.jpg|thumb|500px|right|topology.bmp]]

Topology.bmp is the file that determines the height of the terrain.

The topology of the map is determined by how white a pixel is, the whiter the higher.
When editing this it is important that you make the coast above the water so that it doesn't break the game.

Note that the highest value for water is 94/94/94 , while the lowest value for land is 96/96/96. Avoid using 95/95/95 which can cause buggy behaviour. Note: the file ''must'' be saved in grayscale format, which can't always be done in common graphics editors such as paint.net.

Make the transitions between heights smooth, otherwise you will create noticeable jagged edges.

== Lighting ==

[[File:World_normal_height.jpg|thumb|500px|right|world_normal_height.bmp]]

World_normal_height.bmp is a [[wikipedia:normal mapping|normal map]] which provides the game with information on how to light the map. As of version 3.2, the maximum size of a square world_normal_height.bmp is 3344×3344 (i.e. 209<sup>2</sup>×256 pixels or just over 11.18 megapixels). Normal maps of a different aspect ratio may exceed one of these dimensions as long as the total area does not. Exceeding this area will cause your terrain to have no lighting and therefore be very dark. Fortunately, world_normal_height.bmp does not have to be the same dimensions as your other map files, or even the same aspect ratio; smaller (or larger) normal maps will be scaled automatically to the map's dimensions.

Normal maps can be generated from the height map (topology.bmp) using [https://developer.nvidia.com/nvidia-texture-tools-adobe-photoshop Nvidia's texture tools], or by using Filter > 3D > Generate Normal Map in Photoshop CC.

== Colormaps ==

Ck2 uses two colormaps, both of which can be found in the terrain sub-directory of the map directory, colormap.dds and colormap_water.dds . They add additional detail to the map, acting as an overlay for the land and water, respectively. Like world_normal_height.bmp they scale to the total dimensions of your map. Unlike other map files, they use the dds format, which may require a special plugin to load or edit.

When using the Nvidia dds plugin to save the colormaps, save them as "DXT5 ARGB 8 bpp | interpolated alpha" with 2D textures and no MIP maps 

[[File:Colormap.jpg|500px|colormap.dds]]
[[File:Colormap_water.jpg|500px|colormap_water.dds]]

== Climate ==

Modding the climates of provinces works somewhat similarly to geographic_region and island_region, except here only provinces work. This means that all provinces that have some sort of climate need to have their province ids added to the appropriate block.

Although it is tedious, it is very simple. For example, in a world with 16 provinces, here is an example of how to add climates:

 mild_winter = {
     1 2 3 4
 }
 normal_winter = {
     5 6 7 8
 }
 severe_winter = {
     9 10 11 12
 }

Provinces 13, 14, 15 and 16 will have temperate climate. This does not have to be added. Any provinces that have not been placed inside one of the blocks will automatically get temperate climate. If provinces are placed in multiple blocks, the lowest block it is placed in will be used (but it is still recommended to avoid placing provinces in multiple blocks).

== Frame ==

The map frame is defined in the folder ''static''. Predefined values are:
*frame (2048x2048)
*frame3072 (3072x2048)
*frame3200 (3200x{{sup}})
*frame4096 (4096x{{sup}})
*Landmark_Domeoftherock ({{sup}})

With an empty file, the map will have no frame.
If your custom map is not in the same ratio it's possible to add a custom frame. You will need to do make a new one and export it in a pxdmesh format and change the 00_static.txt and mapitems.gfx

== Fonts ==

See [[forum:653817|Custom Map Fonts]].

== Minimap ==

In addition to graphics files, creating a custom minimap also requires some interface modding. [[Minimap modding|See here]] for more.

== Troubleshooting ==

This section is dedicated to troubleshooting map issues. For other modding, see also generic [[troubleshooting]].

{| class="wikitable"
|-
! Symptom !! Troubleshooting
|-
| Provinces do not show up on realm view
| 
*Check error.log for "Province xxx has no pixels in provinces.bmp" for all the provinces defined in definition.csv
*Verify provinces.bmp is saved '''without color space information'''.
|-
|}

== Tools ==
* [http://www.gimp.org/ GIMP]: A free image editing program, similar to Photoshop. Available for Windows, Mac, and Linux.
* [[forum:697082|Map Filler]]: Fills in definitions.csv, landed titles, localisation, and province and title histories.
* [[forum:598974|Clausewitz Map Checker]]: Validates provinces.bmp and definition.csv.
* [[Nudge]] - A tool built into the game allowing map positions to be edited from within the game engine.

== Links ==
* [[forum:588084|Map Mod Testing]]: General thread for map modding.
* [[forum:801599|Guide to Total Conversion Map Modding]] 
* [[forum:697082|How to fill a custom map]] 
* [[forum:653817|Custom Map Fonts]]


==参考资料==
<references/>

{{ModdingNavbox}}
[[Category:地图模组制作|#]]
[[Category:模组制作]]
[[en:Map modding]]