Structure Gel API Wiki

Structure Gel API (mod id structure_gel) is a library and framework for Minecraft world generation. Its purpose is to give other mods a ready-made toolkit for building and placing their own structures and dimensions, so mod authors do not have to reinvent that code from scratch.

What it provides:

• A structure and jigsaw building system for assembling large structures out of many pieces.
• A set of special structure-gel marker blocks used while designing and generating structures (they help control how a structure carves, fills, and blends into the world, and are cleaned up during generation).
• A portal framework used to build custom dimension portals.
• Shared worldgen and registration helpers that dependent mods reuse.

Structure Gel API has no player-facing content of its own - it adds no real gameplay blocks, items, mobs, or mechanics you build with directly, and it does nothing visible in-game on its own. You only ever install it because another mod lists it as a required dependency.

Install Structure Gel API whenever a mod you use lists it as a dependency. If it is missing, those mods will fail to load and the game will report a missing-dependency error for the mod id structure_gel.

• Blue Skies is built directly on Structure Gel API - its dimension portals and its many generated structures and dungeons use the library's portal framework and structure system. Blue Skies will not run without it.
• Other structure- and dimension-heavy mods from the same ecosystem also depend on it.

Because it is a shared dependency, the rule of thumb is simple: add Structure Gel API when a mod tells you to, and leave it out otherwise. The mod that requires it provides the actual structures, dimensions, and content.

Structure Gel API is meant to be consumed by other mods as a dependency (mod id structure_gel). Declare it in your mod metadata so the game enforces load order.

What it provides for developers:

• Structure / jigsaw system - helpers for registering and placing structures built from multiple template pieces, with control over how they generate.
• Structure-gel blocks - marker blocks (such as build, clear, and axis gel) placed inside structure templates to guide carving, clearing, and boundary handling at generation time; they are removed as the structure finishes generating.
• Dynamic spawner / data helpers - utilities for structure-driven mob spawning and shared data handling.
• Portal framework - a base for creating custom dimension portals and their ignition/teleport logic.

Consult the upstream Structure Gel source and its use inside Blue Skies for the current API surface and version coordinates.

What does Structure Gel API do on its own? Nothing visible - it is a library. It only matters when another mod depends on it.

A mod says it needs "structure_gel" / Structure Gel API - what do I do? Add Structure Gel API to your mods folder alongside that mod, then launch again.

I get a missing-dependency error for structure_gel. A mod needs Structure Gel API but it is not installed (or the version is wrong). Install a matching Structure Gel build so the mod can load.

Do I need it if no mod asks for it? No. It has no content, so there is no reason to install it unless a mod requires it.

Is it safe to add or remove? It adds nothing to your world by itself, so it is safe to add or remove as your mod list requires - as long as no installed mod still depends on it.