Skip to content

Block Masks

Amp63 edited this page Mar 31, 2026 · 1 revision

Block masks are actually expressions composed of Mask Elements and Operators.

List of Mask Elements

  • Block Percentage - (percentage%)<block name/id>(:block meta)
    • Matches a block and metadata with a probability depending on the percentage
    • Ex: stone, 50%dirt, 10%wool:5
  • Block Tag - <#tag name>
    • Matches all blocks that have a given tag
    • Ex: #fences_connect, #mineable_by_pickaxe
  • Dye Color - <c.color>
    • Matches all blocks that are painted a specific color
    • Ex: c.red, c.white, c.yellow
  • Block Type - <t.block type>
    • Matches all blocks that fit into a specific category
    • Ex:
      • t.stair - Matches any stair block
      • t.stone - Matches any stone-like block (e.g. stone, basalt, granite)

List of Operators

  • | (OR) - Match if the left element matches OR the right element matches
  • & (AND) - Match if both the left element matches AND the right element matches
  • ! (NOT) - Invert the result of the next element

Examples

  • stone|cobblestone - Matches stone or cobblestone blocks
  • t.stair&#mineable_by_axe - Matches stairs that can be mined by an axe
  • c.red|c.orange|c.yellow - Matches red, orange, or yellow blocks

Clone this wiki locally