编辑“Building modding”（章节）

== Overview ==
Buildings require at least two files: a text document containing the building definition in {{Path|common/buildings}} and a language file in {{Path|localisation}}. Additionally, a custom icon for the building can be placed in {{Path|gfx/interface/icons/buildings}}. Districts are similar to buildings, except they are stacked together in the planet view. They are defined at {{Path|common/districts}}. This article will focus on building definitions. 

<pre>
building_sample_monument = { 

}
</pre>

The above is the start of a building definition called sample_monument. To the left of the equal sign is the building's identifier, which will be used to reference this building in other game files. Everything within the curly-brackets sets the behavior of the building, including its cost, upkeep, and prerequisites. The building's actual name and description are not part of this definition, however, but are instead looked up in the relevant localisation file. The keys for this are determined by the building's id, as seen below. See [[Localisation modding]] for more on how text is displayed in game.

<pre>
 building_sample_monument: "Sample Building"
 building_sample_monument_desc: "Description of sample building."
</pre>

In order to display the building in the planetary management window, the game will look for an image in {{Path|gfx/interface/icons/buildings}} folder with a file name matching the building's id and will generate an entry in the error log if it is not found. However, it will not use this image unless the icon attribute is actually set within the building definition, and instead use a generic building icon. See [[Icon modding]] for more on changing icons used by the game.