Underlay

Unlock New Decoration Possibilities in Minecraft

The Underlay mod introduces a revolutionary approach to decorating your game space. Now you can place various blocks under any objects where there's free space - chests, beds, signs, torches, and many other elements!

Ease of Use

The system is intuitive: simply right-click on a block face with the desired item in hand to place it underneath. For example, under an upside-down stair. Want to change the design? Right-clicking with another block instantly replaces the current one, while left-clicking completely removes it. And all this is available not only in creative mode but also in survival mode!

What Can You Place?

By default, the mod supports a wide range of blocks for underlayment:

• Various types of carpets
• Trapdoors
• Buttons
• Rails
• Slabs
• Pressure plates

But this is just the beginning! The system is flexible and allows expanding the list of supported blocks.

Customization and Functionality Expansion

For Developers

The mod offers a full API for integration with other modifications. You can easily add support for your own blocks through code or using datapack tags. Just add Underlay as a dependency via JitPack or Modrinth maven, import com.dooji.underlay.UnderlayApi and register the desired blocks with the registerOverlayBlock function. Alternatively, add the underlay:overlay tag to blocks that should support this functionality.

For Players via Datapacks

Even regular players can expand the list of available blocks using datapacks. For version 1.20.1 create the file data/underlay/tags/blocks/overlay.json, and for 1.21+ - data/underlay/tags/block/overlay.json. Inside, specify the blocks you want to add:

{
"replace": false,
"values": [
  "minecraft:short_grass",
  "minecraft:oak_planks",
  "mymod:shiny_block"
]
}

If you need to exclude certain blocks from the supported list, create an exceptions file: for 1.20.1 - data/underlay/tags/blocks/exclude.json, for 1.21+ - data/underlay/tags/block/exclude.json:

{
"replace": false,
"values": [
  "minecraft:oak_button",
  "minecraft:rail"
]
}

Technically, the mod works by creating special "overlays" - visual copies of blocks that allow occupying the same space as main objects without conflicts.