Replace Block

The Replace Block node checks the block at a target location, and if it matches a specific material, replaces it with a new block type. You can also configure optional orientations (such as facing direction, shape, or half) on the replaced block.

Configuration

• Location:
  • At Player: Targets the block at the triggering player's feet.
  • At Coordinates: Targets a block at specific coordinates.
• Coordinate: (Required when Location is Coordinates) A unified location field. It supports editing X, Y, and Z coordinates and the World name in Manual mode (with World in its own dedicated row). Alternatively, toggle to Compact mode to paste or type a single-line location string in the (x,y,z),world format (e.g. (100,64,-250),world or a variable like %player.location%). Both modes support placeholder insertions using the Braces button.
• Old Material (to match): (Optional) The block type to check against. If empty, the block at the coordinates will be replaced regardless of its current material. Supports placeholders.
• New Material (to set): (Required) The block type to replace with (e.g. OAK_STAIRS, GOLD_BLOCK). Supports placeholders.
• Orientation/Facing (Optional): Specifies facing direction (NORTH, EAST, SOUTH, WEST, UP, DOWN) for directional blocks (like stairs, furnaces, chests).
• Bisected Half (Optional): Specifies block half (TOP, BOTTOM) for bisected blocks (like stairs, trapdoors, slabs).
• Stairs Shape (Optional): Specifies shape (STRAIGHT, INNER_LEFT, INNER_RIGHT, OUTER_LEFT, OUTER_RIGHT) specifically for stairs.

---

Examples

1. Match and Swap Blocks

Replaces a DIRT block at coordinates (100,64,100),world with GRASS_BLOCK. If the block at the coordinates is NOT DIRT (e.g. stone or air), the action does nothing.

• Location: At Coordinates
• Coordinate: X=100, Y=64, Z=100 (World = world) or single-line (100,64,100),world
• Old Material (to match): DIRT
• New Material (to set): GRASS_BLOCK

2. General Swap

Swaps whatever block is at coordinates (100,64,100),world with STONE (since Old Material is left empty).

• Location: At Coordinates
• Coordinate: X=100, Y=64, Z=100 (World = world) or single-line (100,64,100),world
• Old Material (to match): (Keep empty)
• New Material (to set): STONE