Minecraft Mods

Structure Generation Tool and API

  • 14,750 views, 2 today
  • 909 downloads, 0 today
coolAlias avatar coolAlias
Level 70 : Legendary Modder
Structure Generation API / Mod

This is a tool I created for those of you who don't want to use schematics, for whatever reason, to generate structures in your world. It allows you to design and generate custom structures as well as rotate and offset your custom structures as they are generated in the world. Additionally, there are methods that allow you to set custom tile entity data, spawn entities or whatever else you can imagine.

Be sure to check out the screenshots below!

Download the API source or the pre-packaged mod distributable on github.

Tutorial Part 1: Your First Structure

Tutorial Part 2: Using Custom Hooks

  • Linked Structure Generator let's you generate multiple structures at a time with specified location and rotation

  • Add custom structures to the world during world generation

  • Generate custom structures in the world with the click of a button

  • Auto-rotation of structures ensures it will always face the player, if desired

  • Default offset will place the structure so it never spawns on top of the player

  • Ability to manually change a structure's rotation or offset before spawning

  • Full metadata block rotation compatibility

  • Compatibility with custom blocks; just use addCustomBlockRotation to define its rotation type

  • Set any block as a 'buffer' so your structure spawns more naturally in the environment

  • Custom 'hooks' allow you to easily manipulate tile entity data or perform other tasks

  • Place blocks where they can't otherwise be placed, such as trapdoors on glass or torches in air
  • Preview mode let's you see where the structure will generate

  • Easily add new items capable of generating structures by extending ItemStructureSpawnerBase, working seamlessly with the ready-made key bindings, packet handling and preview highlighting mode
Custom 'Hooks'

There are a number of pre-written methods to allow easy manipulation of your structure, from adding loot to decorating as you see fit. These methods can be accessed by using an out-of-bounds block id to trigger the 'hook' method 'onCustomBlockAdded'. For the full instructions, see StructureArrays.java.
  • Add items to any tile entity inventory with a single method

  • Spawn entities without fear of spawning in a wall

  • Add hanging entities such as item frames or paintings

  • Set items in placed item frames

  • Set art for paintings

  • Add text to signs, with color example

  • Place any kind of mob head
Possible Future Features
  • Reading structures from a file to avoid compile-time size limitations (big maybe)

  • Possiblity to require materials needed for structure (currently used in my RedstoneHelper mod)
Known Bugs
  • Large entities such as horses have problems spawning in confined spaces
Demo Mod Included
NOW SMP Compatible!

A ready-to-go mod that will help familiarize you with the capabilities and functionality of the Structure Generation Tool. There is currently no recipe for the item that spawns structures, so try it in Creative.

Several structures are included and can be easily toggled between in-game:
  • "Hut" - A highly modified village hut. Enter at your own risk.

  • "Blacksmith" - Vanilla blacksmith shop. Thanks to Microjunk for this one!

  • "Viking Shop" - A cool viking-style shop, but riddled with holes from disuse. Credit again to Microjunk.

  • "Redstone Dungeon" - Can you find the treasure and live to tell about it?

  • "Watermill" - An awesomely impressive water/windmill, courtesy of Microjunk.

  • "Redstone Portcullis" - A design by PearSquirrel, coded by me
These are the default controls:
  • Sneak to highlight area in which structure will generate

  • 'Arrow Keys' - up: moves structure away from player; down: moves structure towards/behind player; left / right of course move the structure left / right

  • 'O' - changes structure's default orientation by 90 degrees. This will have the effect of changing which side spawns facing the player.

  • 'I' - toggles between increment and decrement y offset

  • 'Y' - increments or decrements y value to offset spawn location

  • 'U' - reset x/y/z offsets to 0

  • 'V' - toggles between generate / remove structure - when removing, be sure to click the EXACT position you clicked when spawning it (easier to do with highlighting enabled)

  • ' [ ' / ' ] ' - Previous / Next structure in the list

  • Right click - spawn / remove structure at tile location clicked
Controls can be customized from the config file that is generated the first time you load this mod.

Or use coolAliasStructureWorldGenDemo.zip to try out randomly generated structures dotting your landscape! Initial world loading times will be longer than normal.

Requires Forge. Written for and tested with Minecraft version 1.6.4 and Forge build 916.

  • Download the pre-compiled and zipped mod file and place it in your minecraft/mods folder. You're good to go!

  • Alternatively, follow the directions below to add the 'StructureGenMod' files to your project, giving you access to a secondary API for easily creating new Items capable of spawning structures with all the pre-made functionality.
  • Download the 'StructureGenAPI'

  • Place the entire folder either in your project or as a required project on your project's build path

  • Build your own structures / structure arrays by following the guidelines in the Instructions

  • If you are using custom hooks, either edit the included StructureGenerator.java file or create your own class that extends StructureGeneratorBase to handle your custom hooks

  • Use your StructureGenerator class to generate your structures from whatever location you choose, such as a block or item, or create a class that implements IWorldGenerator (such as the included WorldStructureGenerator) to generate structures during world generation

World Gen
The algorithms I use to place structures are currently not very sophisticated. You will get structures generating on top of or inside of each other at times, especially if you generate lots of them. They may also generate on village rooftops. I just included it to show that the API is not limited to onItemRightClick or onBlockActivated style methods, but is in fact much more flexible.

Array Size
If you are using static arrays rather than reading in from a file, there is a maximum byte limit of static initializers, meaning the structure array size cannot exceed 65535 bytes. What this means for you is that a single horizontal layer of your structure cannot exceed roughly 3400 blocks in area, so about a 68x50 rectangular base, judging by my tests so far.

You would then build your structure by adding layers to the generator list. See StructureArrays.java for complete details on how to go about this.

If your structure is very large (more than 3 or so maxed static arrays), you will probably need to store them in separate files or you will get a compile time error.

Structure Generation Tool

Copyright © <2013>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

Additional Credits
Microjunk, for coming up with the idea for this mod, helping me test it, providing great feedback and for using this tool in his mod. Be sure you check out his Builder Mod!

MineMaarten, for his open source MineChess mod which helped me create the preview mode.
Progress100% complete
Game VersionMinecraft 1.6.4

1 Update Logs

1.6.4 v1.1.0 : by coolAlias 02/17/2014 4:58:27 amFeb 17th, 2014

Fixed key bindings so they can be changed in game

Create an account or sign in to comment.

03/03/2014 4:06 pm
Level 1 : New Explorer
Firegrace avatar
You might want to post screenshots without the texture pack. It's a bit hard to see what exactly is being done without familiarity with the pack. Otherwise, it seems good. Gonna give it a try.
03/03/2014 9:38 pm
Level 70 : Legendary Modder
coolAlias avatar
Good call. When I have some time, I'll be sure to swap them out.
02/18/2014 6:24 pm
Level 3 : Apprentice Network
Slick Craftians
Slick Craftians avatar
If you want free advertising in the form of a youtube video, ask here: http://www.planetminecraft.com/forums/want-youtuber-advertising-your-server-mod-t363922.html
02/17/2014 2:36 pm
Level 38 : Artisan Nerd
HalloBerlinTV avatar
Can you spawn villages with it?
02/17/2014 9:48 pm
Level 70 : Legendary Modder
coolAlias avatar
You can create your own villages with it, but it doesn't spawn a vanilla village, no.
02/18/2014 1:22 am
Level 38 : Artisan Nerd
HalloBerlinTV avatar
OK thank you
02/17/2014 2:34 pm
Level 44 : Master Dragonborn
Avenged1994 avatar
Planet Minecraft


© 2010 - 2023