Structure Gel API

You can find detailed information on how to develop and use this API by Minecraft version.

Latest Documentation

• 1.16+

Older Documentation

• 1.15.2
• 1.14.4

The Building Tool is a new creative mode only item used to perform various large scale block alterations.

• It can be found in the Structure Items creative mode tab.
• Right click the Building Tool in the air to open the GUI. Once open, you can select what mode you want to use, undo, redo, select your position, and more.

GUI

The GUI contains various buttons to modify the Building Tool’s settings, as well as some convienent tools.

• Pressing, enter, e, escape, or clicking anywhere on the screen that isn’t a button will close the GUI.
• Hovering over any item on the GUI will display a tooltip on the right side to explain what it does and how to use it.
• Using the radial menu, you can select which mode you want to use.
• Some modes support positions. If they do, a button will appear on the top left to select a position based on your current location. This is mainly useful when right clicking a block isn’t possible or is highly inconvenient.
• The Undo and Redo buttons on the left exist to do exactly what they say. They attempt to undo or redo the last action you performed with the Building Tool. Up to 32 actions are saved and can be undone.
• Some modes have additional settings, these settings will appear below the undo and redo buttons.
• The button in the middle is used to select what block you want to use. When you click it, a text box will open for you to type a block state. This can be done in game as well, but some blocks like water are more than difficult to click on.

Controls

• Middle Click: Selects the current block state you’re looking at (also can be done in the GUI).
• Left Click: This is the general key for “do the thing” depending on what mode you’re in.
• Right Click Air: Opens the GUI.
• Right Click Block: Some modes use this to set positions, but ones that don’t also allow this to “do the thing” as well.
• Shift + Right Click: Clears the currently selected positions.

Modes

Building Tool Modes are different operations that the Building Tool can perform.

• Extend: Detects a pattern based on the side of the block you click, and attempts to place blocks in front of that to continue that pattern. If you’re familiar with the old Builder’s Wands mod, it’s essentially the same idea.

• Flood: Fills all air blocks within the y level slice that you click, until it hits a border, then continues to fill going downward. This is useful for filling a lake with water for example.
• Fill: Very similar to the vanilla fill command. Select two corners and then left click to fill the area between with the currently selected block. Has options for replacing specific blocks and only placing a frame or hollow box.
• Line: Places a line of blocks between the selected positions using the currently selected block.
• Clone: Copies the selected region and pastes it where you click. Allows for rotating, mirroring, and cutting instead of copying.

• Move: Moves the selected region in the direction that you punch.
• Clear: Removes all blocks within the selected positions.
• Shape: Places a shape where you click. The shape and what blocks will be replaced can be changed though the mode’s properties in the GUI.

Mode Properties

Some modes support additional settings to modify their behavior. Some examples include:

• Integrity: Determines how many blocks will actually place.
• Replace: Determines what the mode will replace when placing blocks. All replaces everything, Air replaces only air, and Clicked replaces the block you clicked on.
• Rotation and Mirror: Rotates or mirrors the cloned region. Allows for selecting a random value as well.

Red Gel

Red gel uses the default spreading mechanic, spreading along the cardinal directions, only replacing air.

Blue Gel

Blue gel functions similarly to red, except it won’t spread into locations where the sky can be seen.

Green Gel

Green gel spreads the same as red gel, with the addition of also spreading diagonally. This allows it to get through corners created by vines or other complex builds. Be careful not to let it leak outside of your build.

Cyan Gel

Cyan gel acts as a combination of green and blue gel, by both spreading diagonally and avoiding the sky.

Orange Gel

Orange gel behaves the same as red gel, but the distance it spreads is determined by how many you’re holding when you place it, making it handy for builds in open areas.

Yellow Gel

Yellow gel will only spread along the plane that you’re facing when you place it, making it great for sealing off walls, windows, or other holes that the gel would otherwise go through.

---

Removing Gels

Gel can be removed by using gunpowder on it. Doing this will trigger a chain reaction, removing all connected gels of the same type.

Examples

Here’s an example of how it could be used in a build. If this structure were loaded into the game, the gel inside would be replaced with air, while the air outside would not be placed.