• Clonk Developer Mode Documentation
• 
• Introduction
• Contents
• Search
• Engine
• Command Line
• Game Data
• Script

Material Definitions

Material Definition Components (Material.c4g)

TexMap.txt

Lookup table for color indices in static and dynamic landscapes. Colors 0-127 are matched to a material-texture-reference. Colors 128-255 are matched to the same list of references only these are marked 'underground'.

The engine will draw materials with a higher index above those with a lower index so that, e.g. using the standard table, rough chunks of earth will overlap water which has a smooth border. Mineral resources have an even higher index so that their rough border overlaps the earth and not the other way around. This is also the reason why there might be differing numbers of total pixels of a given material drawn than you might expect just from calculating the square sizes of the unzoomed map materials.

If a custom map fails with the message 'texture n undefined' you should define the specified texture in the TexMap. You should always use a paint program capable of editing indexed color palettes without modifying the palette (MS Paint is not suited for this).

If TexMap.txt contains OverloadMaterials OverloadTextures at the beginning materials / textures from the default Material.c4g are loaded before the custom definitions, which may also override the default definitions.

*.c4m

The engine will accept up to 125 material definitions at a time. C4M files a simple text files. The materials Vehicle, Tunnel, Water, Snow, Granite, Sand, and Earth must always be available.

*.png / *.bmp

There can be any number of textures in PNG or uncompressed Windows BMP format (with 256 colors) in any material group. Width and height of each bitmap must be powers of 2 (that is 16, 32, 64, 128, 256, etc.) With the old BMP format only the first three colors of the texture bitmap may be used as to these the three material colors are applied.

Material-Texture-References

• Clonk Developer Mode Documentation
• 
• Introduction
• Contents
• Search
• Engine
• Command Line
• Game Data
• Script