Skip to content

Legacy Texture Pack Format

Cgameworld edited this page May 9, 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.

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.

Clone this wiki locally