Structure Generation Tool and API

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.

DEMO MOD

• 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.
  

API

• 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
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
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/>.

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.