Skip to content

Legacy Texture Pack Format

Cgameworld edited this page May 6, 2026 · 6 revisions

Folder Layout

A legacy texture pack is made up of a folder containing six PNG files with the following names and one JSON config file. Before the in-editor workflow was added in the 1.5.2f patch this was the main method used to create texture packs.

MyTexturePack/
├── Grass_BaseColor.png
├── Grass_Normal.png
├── Dirt_BaseColor.png
├── Dirt_Normal.png
├── Cliff_BaseColor.png
├── Cliff_Normal.png
└── maptextureconfig.json

Texture Files

Each terrain type (grass, dirt, cliff) has two textures:

  • *_BaseColor.png — replaces the diffuse texture seen in game for that terrain type
  • *_Normal.png — replaces the roughness map for that terrain type

The vanilla game ships with 4096×4096 grass textures and 2048×2048 dirt and cliff textures, but smaller textures still work (for example the Desert Map Theme pack ships 1024×1024 textures).

maptextureconfig.json

The JSON config sets the display name of the pack and the tiling values the mod loads when the pack is selected.

Example maptextureconfig.json:

{
    "pack_name": "Example Pack",
    "far_tiling": "160",
    "close_tiling": "1600",
    "close_dirt_tiling": "2400"
}

Fields:

  • pack_name — the name of the pack as it appears in the in-game dropdown
  • far_tiling — far distance terrain tiling (default 160)
  • close_tiling — close distance grass and cliff tiling (default 1600)
  • close_dirt_tiling — close distance dirt tiling (default 2400)

There's also an optional far_tiling_breakpoints field that lets the far tiling value change automatically based on camera height — see Far Tiling Breakpoints for details.

Publishing

Once your pack folder is ready, see the Pre 1.5.2f Game Patch Instructions in Publishing Map Texture Packs to PDXMods for the steps to upload it to PDXMods.

Clone this wiki locally