Tutorials/World Generation

From Minecraft Forge
Jump to: navigation, search

Warning Icon.png

This page or segment has been marked Incomplete because of missing information. Please help improve this article if you can.

How-To Icon.png

This is a How-To guide or Tutorial detailing a practice or process for Minecraft Forge or related software.

Generic Mod

Havvy Generic Mod Banner Final.png

October 9, 2014 Added metadata support in localising tutorial --SkylordJoel

March 27, 2014 Updated Basic Items to 1.7.x --Jwosty

February 13, 2014 1.7 update happen and I fix up some of the stuff so far:

But it has one part not working yet


July 5, 2013

1.6.1 came out so I have fixed up some of the basic tutorials to go with it.

Ones that are updated include:

-- Mew

March 13, 2013

1.5 came out, so I fixed the methods to account for this (mostly the Icons/Textures tutorial).


December 13th, 2012

Alright, Forge made their installation process really simple and also made proper packages, removing the common/src distinction. I rewrote most of Basic Modding to account for this update. Overall though, this simplifies the explanations, but imports changed in all tutorials. Next up, I need to finish the world gen tutorial.

With the Basic Modding tutorial being mostly rewritten, if anything is confusing about it now, please tell me ASAP!

December 3rd, 2012

I finally finished the tutorial on Plants I started a month ago. I also fixed a minor compilation bug in Packet Handling. I reorganized the Generic Ore section by adding a Dropping Ore section. I'm starting to use a General Knowledge template where the background is grey. The knowledge in those boxes are general facts that are not specific to whatever thing we are implementing. I updated the Textures and Icons section to say that the image can be any scalar of 16x16 pixels where 256x256 will have each icon be 16x16 in size.


Do not take the contents of this tutorial as truth until it is finished. Parts of this tutorial are speculation that has not yet been checked!
  • To understand how Minecraft generates the world.
  • To generate in the main world and in the Nether.
  • To generate ores
  • To generate structures.


World Generation Basics

Minecraft generates the world one chunk at a time. A chunk is 16 by 16 blocks in the horizontal plane and encompasses the entire vertical plane.

First the generator creates the landscape. Then it adds in caves. Then it adds in ores. Then it adds in the other blocks. And somewhere in the process bigger structures like villages get created.


Each mod that adds world generation does so via implementing the IWorldGenerator interface. This interface has one method, generate.

public void IWorldGenerator.generate(Random random, int chunkX, int chunkZ, World world, IChunkProvider chunkGenerator, IChunkProvider chunkProvider);

This method is called during the generation of every chunk.