Structure Gel API

Released: May 30th, 2020

License

All Rights Reserved with major exceptions

Information

  • View on CurseForge
  • View Changelogs
  • View the Source Code
  • Submit an Issue

  • Download

    Click on CurseForge to view all files.


    Tags

    API


    Structure Gel is an API mod designed to make creating structures easier on the developers, specifically ones using the jigsaw system. All code is open source and documented. Some of its features include:

    đź“š Read the Structure Gel API Documentation Here

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

    For an open source working example of this api, check out Dungeons Plus

    🍡 Structure Gel Block

    This block is a creative tool to fill the insides of structures easily. The gel is replaced with air when your structure generates while all air is ignored when being placed. This ensures that your structures won’t have natural terrain where it shouldn’t be. The gel block behaves similarly to structure voids in that you can walk through it, while actually being visible.

    When placing gel while sneaking, you can trigger the spreading mechanic. Each gel spreads differently, and you can read how they work by hovering over the item.

    Red Gel

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

    Red Gel

    Blue Gel

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

    Blue Gel

    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.

    Green Gel

    Cyan Gel

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

    Cyan Gel

    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.

    Orange Gel

    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.

    Yellow Gel


    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.

    Removing Gel

    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.

    house_example

    The code for this block is designed in a way such that you can easily extend it and hook into its behavior with methods in blocks.IStructureGel, should you need behavior not already implemented.

    This is a core mod that modifies a few internal classes. If you get a crash with this mod that only occurs when mixed with another mod, this may be the cause. Please test before reporting.