Customgen

release 7 for 1.8

Description

Adds (nearly procedurally generated) dungeons, structures and other features to terrain generation. Generation features are stored as resource packs and may easily be replaced, created and shared with others. Customgen is based on the following things:

Gens

Short for generation feature, this is the base for a feature. A gen has a set of data, describing where and how it may generate. Currently it has a name, a resourcepack name, a level, a set of allowed biome types and a set of segments. A gens level will decide on what y level it will generate, the following values are available:

• underground: starts generating underground at y=4, y=20 or y=36
• surface: starts generating 3 blocks below the surface
• sea floor: works similar to surface but generates at the bottom of a sea, lake or river instead of at the surface of the water

For a gen to generate in a biome, one of the biomes types has to match one of the biome types in the set of allowed biome types. An empty set means that all biome types are allowed. Last but not least we have the segments, this is where the actual content is stored.

Segments

Segments consists of a 16x16x16 cube of blocks with metadata and tile entities, this is what gets placed in the world when a gen generates. Segments have an interface number on each side, this describes what other segments that it may be fit to generate next to. A segment can be marked as a starting segment, when a gen generates into the world it will start with one its starting segments. Once the starting segment has been generated segments that have interfaces matching the interfaces of the starting segment will also generate and then segments with interfaces matching the interfaces of those segments, and so on until there are no interfaces left to fit new segments onto (there's currently a limit on 100 segments to avoid generating infinite loops).

Blocks & Items

Customgen adds a couple of blocks and items that are used in creating gens.

 Book of Custom Generation

Used to create gens and segments or to generate gens, segments and templates.

 Empty Block

When the blocks in a segment are generated empty blocks will not be placed but instead leave the block previously generated by the vanilla (or another mods) terrain generation. Using these instead of stone lets a gen fit better into the existing terrain.

 Interface Block

Placing these on the side of a segment will add to its interface number on that side. Right click to increase its value. Multiple interface blocks may be placed on the same side.

 Loot placeholder

A Loot placeholder inside an inventory will be replaced with dungeon loot when it is generated, this should add more randomness and replayability to a gen.

Download & Installation

Customgen needs minecraft forge to run, download the installer from here and run it. There should now be a folder called "mods" in your minecraft directory, place the customgen .jar file in that folder.

Installing content

Gens that you've created yourself should be ready to generate, just run around and explore and they should pop up. If you've downloaded gens created by someone else, place them in the resourcepacks folder and restart your world. If you're running a server you may have to create the resourcepacks folder first. You can use the Book of Custom Generation to check if the gens were properly added.

Creating content

A short tutorial on how to create a gen.

Mod compatability

It should work mostly fine with other mods. Using blocks, items and tile entities from other mods will work and if some of the mods are missing it will simply skip those blocks, items or tile entities. I've noticed some problems when generating tile entities from other mods, multiblocks seem to be sketchy sometimes.

Contribute

I would prefer if you could post bug reports and feature requests over on the github page, it's easier to manage that way. The source is on github, feel free to submit pull requests aswell.

Gens

Underground structures

A set of underground structures. Makes use of, but does not require, buildcraft and tinkers constructs.

Caves

Caves in different variations. Makes clever use of interfaces to generate in different lengths.

Seapack (1.8)

A pack of features that generates at sea, arr!

Example

An example gen with interfaces, tile entities and content from other mods