Block Families

What are Block Families?

Block families are a way to add random mixes of blocks to dungeons, similar to the way vanilla "dungeons" mix normal and mossy cobblestone. They group related blocks they should that will then be select from randomly for each block placed while building with the family. Of course, related can mean whatever you want, really this just groups blocks that can be used.

How to Make Block Families

Block families are stored in json files (yes, I actually used a standard format for once), and simply list all the blocks in the family. For example, here is the code from mixedcobble.json, which imitates the the mix of cobblestones types found in vanilla dungeons:

{ "name": "mixed_cobble", "blocks": [ "minecraft:cobblestone", "minecraft:mossy_cobblestone" ] }

The name field tells the name used to reference the block family in Themes; this would be called $mixed_cobble to use it in a theme, where it would added to a block list as though it were a single block. The block names are the resource locations used by Minecraft, and can be blocks from mods (simple replace "minecraft" with the mod ID). Sub-blocks (alternate block states) can be reference through metadata by placing the metadata number in parenthesis after the resource location, just like in theme block lists. For example:

{ "name": "mixed_bricks_3", "blocks": [ "minecraft:stonebrick", "minecraft:stonebrick(1)", "minecraft:stonebrick(2)" ] }