ID mapping

../_images/icon_id_mapping.webp

One of many numbers.

Block ID mapping

The block ID mapping is defined in shaders/block.properties included in the shader pack.

Forge mods may add custom block mapping as assets/<modid>/shaders/block.properties in the mod JAR file. The block.properties file can use conditional Compilation directives (#ifdef, #if, etc.)

For more details see section Macros A to I. Option macros are also available. Format: block.<id>=<block1> <block2> ... The key is the substitute block ID, the values are the blocks which are to be replaced. Only one line per block ID is allowed.

See Syntax for the block matching rules.

# Short format
block.31=red_flower yellow_flower reeds

# Long format
block.32=minecraft:red_flower ic2:nether_flower botania:reeds

# Properties
block.33=minecraft:red_flower:type=white_tulip minecraft:red_flower:type=pink_tulip botania:reeds:type=green

Item ID mapping

The item ID mapping is defined in shaders/item.properties included in the shader pack. Forge mods may add custom item mapping as /assets/<modid>/shaders/item.properties in the mod JAR file.

See Block ID Mapping for the overview.

# Short format
item.5000=diamond_sword dirt

# Long format
item.5001=minecraft:diamond_sword botania:reeds

Entity ID mapping

The entity ID mapping is defined in shaders/entity.properties included in the shader pack. Forge mods may add custom entity mapping as assets/<modid>/shaders/entity.properties in the mod JAR file.

See Block ID Mapping for the overview.

# Short format
entity.2000=sheep cow

# Long format
entity.2001=minecraft:pig botania:pixie

Assumes the latest OptiFine version.
Updated to commit 15ef3106.

Last update: 2024 April 30