Skip to content

Patch Files

Excederus edited this page Aug 24, 2026 · 1 revision

Purpose

Patch files hold the values/names of your modded blocks, items or entities.

Every value has to be assigned to a MappingKey - one MappingKey can hold multiple values.

Values have to be written without a namespace/modid, because Shader Patcher will automatically add the namespace/modid by extracting it from the filename.

Example

ExampleMod wants to add support for these blocks:

  • example_grass
  • example_tall_grass
  • example_flower_1
  • example_flower_2
  • example_glass
  • example_glass_pane
  • example_leaves
  • example_blue_candle

ExampleMod has to create the file block.examplemod.yaml in ~/assets/examplemod/shaderpatcher/patches/ with this content:

waving:
  grass:
    short:
      - example_grass
    tall:
      - example_tall_grass
  flower:
    small:
      - example_flower_1
      - example_flower_2
  leaves:
    - example_leaves
translucent:
  glass:
    regular:
      - example_glass
emissive:
  candle:
    blue:
      - example_blue_candle

Why this file doesn't contain example_glass_pane will be explained in the Transform Files wiki page.

Clone this wiki locally