Skip to main content

State Matchers

Each state matcher represents one block at one specific position in the multiblock, and depending on the type of matcher it may only allow one specific block, or a wide range of blocks in that position.

State matchers are defined in the mappings part of the multiblock definition.

Common Attributes​

All state matchers need to have the following attributes:

type (State Matcher Type, mandatory)​

A ResourceLocation identifying the type of state matcher to use.
Example: modonomicon:block

Attribute Types​

Besides standard JSON types, state matchers support the following attributes:

Block (String)​

A ResourceLocation for a block, in the format modid:block.
Example: minecraft:stone

BlockState (String)​

A BlockState string as used in the Minecraft setblock command.
Example: minecraft:chest[facing=east].

The block state properties can be omitted, in which case the default BlockState will be used.
Example: minecraft:chest.

See https://minecraft.fandom.com/wiki/Commands/setblock for more information

Tag (String)​

A Tag string that is based on the BlockState string as used in the setblock command, but prefixed with #.
Example: #forge:chests[facing=east]

The block state properties can be omitted, in which case the block state properties will be ignored when matching.
Example: #forge:chests.