Wuppy29

Website no longer used!

2013-10-29T11:12:00.003-07:00

This website is no longer being updated. Instead go here.

Mods and Modding for Minecraft update

2013-10-22T06:45:00.002-07:00

I have just updated Mods and Modding for Minecraft. The biggest reason for the update is that the api version I was using for the mod will be removed in a few days. If you are using the app make sure you update as soon as possible or it won't work for you.

Film Finder app

2013-10-16T06:02:00.002-07:00

A short time ago I posted about 2 projects which were taking up most of my time. One of the 2 is finally ready for release.
Film finder is a Dutch android app about movies.

With this app you can find which movies are on TV today and tomorrow on every big TV station in Holland and other countries nearby as well as movie tips selected especially for you which you may enjoy based on what you like.

The most important features of the app are:

- A list of movies that are on TV today and tomorrow
- Movie tips with

The most popular movie of today and tomorrow
The movies on TV which you are likely to enjoy
More movie tips from bol.com

The biggest part of the movies in this app is Dutch. If the movie will be on TV soon you will be able to see where and when. With a short look at this app you can find out what the movie is about, how popular it is, who made it, who plays in it and many other things. Film Finder is an app with every bit of information you need about movies. It will find exactly the movies you will enjoy watching.

In summary Film Finder is an app with every movie you might enjoy.

Features coming soon:

A top 100 movies
Improved visuals of the app
More user friendly with for example useful buttons
More options
Preorder movies

This app is made in cooperation with Filmtotaal.nl and bol.com

You can download the app over here: https://play.google.com/store/apps/details?id=com.wuppy.filmfinder&hl=en

The lack of new tutorials and other content.

2013-10-12T04:21:00.003-07:00

As most of you will see when you visit this website is the lack of new tutorials and other content recently. This post is to quickly tell you why and how long it will go on like this.

The last couple of weeks I have been really busy. There are 2 very important programming projects with a hard deadline I have to make. Both are very important for my future so they go before this website. Right now both of those projects are close to the deadline, but after that I will still have a lot to do. One of the projects is a pretty big app for Android. The app will be released next Friday and will contain a list with movies on TV in Holland, Germany, Great Britain, Belgium and France. It will also contain a list of movies selected from the users preferences. However, all of this will be in dutch so it won't be interesting for most of the people on here.

After I release the app there will still be a lot to do on the app which I want to do very soon. Once it is done or maybe when I'm still working on it, I will be making a website both for the app, but also for my mods and possibly new tutorials. Besides that app, another project and the website I have plans for at least 2 more Android apps and I would also like to port my existing apps, also Mods and Modding!, to iOS and windows phone if I have the money to do that. I will also have to learn a couple of new programming languages soon and there is a game I wanted to make for years now.

However, I would really like to get some new tutorials out and I'm hoping to have some time here and there in about a week to get some new ones out.

One thing that I can tell you right now is that there will be an update to Mods and Modding fixing a crash, changing a few small things and adding some new tutorials so at least there is that to look out for.

About 1.6.4

2013-09-25T06:36:00.002-07:00

All of my mods and modding tutorials are 1.6.4 ready. There are close to no changes in the code.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Dimensions Part 4: Teleporter

2013-09-08T00:57:00.000-07:00

This will be the last tutorial in the basic dimension tutorial series. After this will be a lot of customization tutorials for your dimension though. In this tutorial I will show you how to create the Teleporter file. To make this work properly we will also have to add two more methods to the Block file. This is the file I will be starting with.

package tutorial;

import net.minecraft.block.BlockPortal;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.entity.Entity;

import net.minecraft.entity.player.EntityPlayerMP;

import net.minecraft.server.MinecraftServer;

import net.minecraft.src.ModLoader;

import net.minecraft.world.World;

public class BlockPortalTutorial extends BlockPortal

{

public BlockPortalTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabBlock);

}

public void onEntityCollidedWithBlock(World par1World, int par2, int par3, int par4, Entity par5Entity)

{

if ((par5Entity.ridingEntity == null) && (par5Entity.riddenByEntity == null) && ((par5Entity instanceof EntityPlayerMP)))

{

EntityPlayerMP player = (EntityPlayerMP) par5Entity;

ModLoader.getMinecraftServerInstance();

MinecraftServer mServer = MinecraftServer.getServer();

if (player.timeUntilPortal > 0)

{

player.timeUntilPortal = 10;

}

else if (player.dimension != Tutorial.dimensionId)

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, Tutorial.dimensionId, new TeleporterTutorial(mServer.worldServerForDimension(Tutorial.dimensionId)));

}

else

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, 0, new TeleporterTutorial(mServer.worldServerForDimension(1)));

}

Right now you will have an error under the TeleporterTutorial file. To fix this hover your mouse over it and click create class. You will get a file that looks like this.

package tutorial;

import net.minecraft.world.Teleporter;

public class TeleporterTutorial extends Teleporter {

}

The next thing you have to do is open the Teleporter file and just copy over all the code into the TeleporterTutorial file. Then make sure it extends Teleporter, rename type, change package declaration at the top and use Ctrl, Shift, O to import all the files it needs.
When you have done all of that you will have a file that looks like this.

package tutorial;

import java.util.ArrayList;

import java.util.Iterator;

import java.util.List;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.entity.Entity;

import net.minecraft.util.Direction;

import net.minecraft.util.LongHashMap;

import net.minecraft.util.MathHelper;

import net.minecraft.world.ChunkCoordIntPair;

import net.minecraft.world.PortalPosition;

import net.minecraft.world.Teleporter;

import net.minecraft.world.WorldServer;

public class TeleporterTutorial extends Teleporter

{

private final WorldServer worldServerInstance;

/** A private Random() function in Teleporter */

private final Random random;

/** Stores successful portal placement locations for rapid lookup. */

private final LongHashMap destinationCoordinateCache = new LongHashMap();

/**

* A list of valid keys for the destinationCoordainteCache. These are based on the X & Z of the players initial

* location.

private final List destinationCoordinateKeys = new ArrayList();

public TeleporterTutorial(WorldServer par1WorldServer)

{

this.worldServerInstance = par1WorldServer;

this.random = new Random(par1WorldServer.getSeed());

}

/**

* Place an entity in a nearby portal, creating one if necessary.

public void placeInPortal(Entity par1Entity, double par2, double par4, double par6, float par8)

{

if (this.worldServerInstance.provider.dimensionId != 1)

{

if (!this.placeInExistingPortal(par1Entity, par2, par4, par6, par8))

{

this.makePortal(par1Entity);

this.placeInExistingPortal(par1Entity, par2, par4, par6, par8);

}

else

{

int i = MathHelper.floor_double(par1Entity.posX);

int j = MathHelper.floor_double(par1Entity.posY) - 1;

int k = MathHelper.floor_double(par1Entity.posZ);

byte b0 = 1;

byte b1 = 0;

for (int l = -2; l <= 2; ++l)

{

for (int i1 = -2; i1 <= 2; ++i1)

{

for (int j1 = -1; j1 < 3; ++j1)

{

int k1 = i + i1 * b0 + l * b1;

int l1 = j + j1;

int i2 = k + i1 * b1 - l * b0;

boolean flag = j1 < 0;

this.worldServerInstance.setBlock(k1, l1, i2, flag ? Block.obsidian.blockID : 0);

}

par1Entity.setLocationAndAngles((double)i, (double)j, (double)k, par1Entity.rotationYaw, 0.0F);

par1Entity.motionX = par1Entity.motionY = par1Entity.motionZ = 0.0D;

}

/**

* Place an entity in a nearby portal which already exists.

public boolean placeInExistingPortal(Entity par1Entity, double par2, double par4, double par6, float par8)

{

short short1 = 128;

double d3 = -1.0D;

int i = 0;

int j = 0;

int k = 0;

int l = MathHelper.floor_double(par1Entity.posX);

int i1 = MathHelper.floor_double(par1Entity.posZ);

long j1 = ChunkCoordIntPair.chunkXZ2Int(l, i1);

boolean flag = true;

double d4;

int k1;

if (this.destinationCoordinateCache.containsItem(j1))

{

PortalPosition portalposition = (PortalPosition)this.destinationCoordinateCache.getValueByKey(j1);

d3 = 0.0D;

i = portalposition.posX;

j = portalposition.posY;

k = portalposition.posZ;

portalposition.lastUpdateTime = this.worldServerInstance.getTotalWorldTime();

flag = false;

}

else

{

for (k1 = l - short1; k1 <= l + short1; ++k1)

{

double d5 = (double)k1 + 0.5D - par1Entity.posX;

for (int l1 = i1 - short1; l1 <= i1 + short1; ++l1)

{

double d6 = (double)l1 + 0.5D - par1Entity.posZ;

for (int i2 = this.worldServerInstance.getActualHeight() - 1; i2 >= 0; --i2)

{

if (this.worldServerInstance.getBlockId(k1, i2, l1) == Block.portal.blockID)

{

while (this.worldServerInstance.getBlockId(k1, i2 - 1, l1) == Block.portal.blockID)

{

--i2;

}

d4 = (double)i2 + 0.5D - par1Entity.posY;

double d7 = d5 * d5 + d4 * d4 + d6 * d6;

if (d3 < 0.0D || d7 < d3)

{

d3 = d7;

i = k1;

j = i2;

k = l1;

}

if (d3 >= 0.0D)

{

if (flag)

{

this.destinationCoordinateCache.add(j1, new PortalPosition(this, i, j, k, this.worldServerInstance.getTotalWorldTime()));

this.destinationCoordinateKeys.add(Long.valueOf(j1));

}

double d8 = (double)i + 0.5D;

double d9 = (double)j + 0.5D;

d4 = (double)k + 0.5D;

int j2 = -1;

if (this.worldServerInstance.getBlockId(i - 1, j, k) == Block.portal.blockID)

{

j2 = 2;

}

if (this.worldServerInstance.getBlockId(i + 1, j, k) == Block.portal.blockID)

{

j2 = 0;

}

if (this.worldServerInstance.getBlockId(i, j, k - 1) == Block.portal.blockID)

{

j2 = 3;

}

if (this.worldServerInstance.getBlockId(i, j, k + 1) == Block.portal.blockID)

{

j2 = 1;

}

int k2 = par1Entity.getTeleportDirection();

if (j2 > -1)

{

int l2 = Direction.rotateLeft[j2];

int i3 = Direction.offsetX[j2];

int j3 = Direction.offsetZ[j2];

int k3 = Direction.offsetX[l2];

int l3 = Direction.offsetZ[l2];

boolean flag1 = !this.worldServerInstance.isAirBlock(i + i3 + k3, j, k + j3 + l3) || !this.worldServerInstance.isAirBlock(i + i3 + k3, j + 1, k + j3 + l3);

boolean flag2 = !this.worldServerInstance.isAirBlock(i + i3, j, k + j3) || !this.worldServerInstance.isAirBlock(i + i3, j + 1, k + j3);

if (flag1 && flag2)

{

j2 = Direction.rotateOpposite[j2];

l2 = Direction.rotateOpposite[l2];

i3 = Direction.offsetX[j2];

j3 = Direction.offsetZ[j2];

k3 = Direction.offsetX[l2];

l3 = Direction.offsetZ[l2];

k1 = i - k3;

d8 -= (double)k3;

int i4 = k - l3;

d4 -= (double)l3;

flag1 = !this.worldServerInstance.isAirBlock(k1 + i3 + k3, j, i4 + j3 + l3) || !this.worldServerInstance.isAirBlock(k1 + i3 + k3, j + 1, i4 + j3 + l3);

flag2 = !this.worldServerInstance.isAirBlock(k1 + i3, j, i4 + j3) || !this.worldServerInstance.isAirBlock(k1 + i3, j + 1, i4 + j3);

}

float f1 = 0.5F;

float f2 = 0.5F;

if (!flag1 && flag2)

{

f1 = 1.0F;

}

else if (flag1 && !flag2)

{

f1 = 0.0F;

}

else if (flag1 && flag2)

{

f2 = 0.0F;

}

d8 += (double)((float)k3 * f1 + f2 * (float)i3);

d4 += (double)((float)l3 * f1 + f2 * (float)j3);

float f3 = 0.0F;

float f4 = 0.0F;

float f5 = 0.0F;

float f6 = 0.0F;

if (j2 == k2)

{

f3 = 1.0F;

f4 = 1.0F;

}

else if (j2 == Direction.rotateOpposite[k2])

{

f3 = -1.0F;

f4 = -1.0F;

}

else if (j2 == Direction.rotateRight[k2])

{

f5 = 1.0F;

f6 = -1.0F;

}

else

{

f5 = -1.0F;

f6 = 1.0F;

}

double d10 = par1Entity.motionX;

double d11 = par1Entity.motionZ;

par1Entity.motionX = d10 * (double)f3 + d11 * (double)f6;

par1Entity.motionZ = d10 * (double)f5 + d11 * (double)f4;

par1Entity.rotationYaw = par8 - (float)(k2 * 90) + (float)(j2 * 90);

}

else

{

par1Entity.motionX = par1Entity.motionY = par1Entity.motionZ = 0.0D;

}

par1Entity.setLocationAndAngles(d8, d9, d4, par1Entity.rotationYaw, par1Entity.rotationPitch);

return true;

}

else

{

return false;

}

public boolean makePortal(Entity par1Entity)

{

byte b0 = 16;

double d0 = -1.0D;

int i = MathHelper.floor_double(par1Entity.posX);

int j = MathHelper.floor_double(par1Entity.posY);

int k = MathHelper.floor_double(par1Entity.posZ);

int l = i;

int i1 = j;

int j1 = k;

int k1 = 0;

int l1 = this.random.nextInt(4);

int i2;

double d1;

double d2;

int j2;

int k2;

int l2;

int i3;

int j3;

int k3;

int l3;

int i4;

int j4;

int k4;

double d3;

double d4;

for (i2 = i - b0; i2 <= i + b0; ++i2)

{

d1 = (double)i2 + 0.5D - par1Entity.posX;

for (j2 = k - b0; j2 <= k + b0; ++j2)

{

d2 = (double)j2 + 0.5D - par1Entity.posZ;

label274:

for (k2 = this.worldServerInstance.getActualHeight() - 1; k2 >= 0; --k2)

{

if (this.worldServerInstance.isAirBlock(i2, k2, j2))

{

while (k2 > 0 && this.worldServerInstance.isAirBlock(i2, k2 - 1, j2))

{

--k2;

}

for (i3 = l1; i3 < l1 + 4; ++i3)

{

l2 = i3 % 2;

k3 = 1 - l2;

if (i3 % 4 >= 2)

{

l2 = -l2;

k3 = -k3;

}

for (j3 = 0; j3 < 3; ++j3)

{

for (i4 = 0; i4 < 4; ++i4)

{

for (l3 = -1; l3 < 4; ++l3)

{

k4 = i2 + (i4 - 1) * l2 + j3 * k3;

j4 = k2 + l3;

int l4 = j2 + (i4 - 1) * k3 - j3 * l2;

if (l3 < 0 && !this.worldServerInstance.getBlockMaterial(k4, j4, l4).isSolid() || l3 >= 0 && !this.worldServerInstance.isAirBlock(k4, j4, l4))

{

continue label274;

}

d4 = (double)k2 + 0.5D - par1Entity.posY;

d3 = d1 * d1 + d4 * d4 + d2 * d2;

if (d0 < 0.0D || d3 < d0)

{

d0 = d3;

l = i2;

i1 = k2;

j1 = j2;

k1 = i3 % 4;

}

if (d0 < 0.0D)

{

for (i2 = i - b0; i2 <= i + b0; ++i2)

{

d1 = (double)i2 + 0.5D - par1Entity.posX;

for (j2 = k - b0; j2 <= k + b0; ++j2)

{

d2 = (double)j2 + 0.5D - par1Entity.posZ;

label222:

for (k2 = this.worldServerInstance.getActualHeight() - 1; k2 >= 0; --k2)

{

if (this.worldServerInstance.isAirBlock(i2, k2, j2))

{

while (k2 > 0 && this.worldServerInstance.isAirBlock(i2, k2 - 1, j2))

{

--k2;

}

for (i3 = l1; i3 < l1 + 2; ++i3)

{

l2 = i3 % 2;

k3 = 1 - l2;

for (j3 = 0; j3 < 4; ++j3)

{

for (i4 = -1; i4 < 4; ++i4)

{

l3 = i2 + (j3 - 1) * l2;

k4 = k2 + i4;

j4 = j2 + (j3 - 1) * k3;

if (i4 < 0 && !this.worldServerInstance.getBlockMaterial(l3, k4, j4).isSolid() || i4 >= 0 && !this.worldServerInstance.isAirBlock(l3, k4, j4))

{

continue label222;

}

d4 = (double)k2 + 0.5D - par1Entity.posY;

d3 = d1 * d1 + d4 * d4 + d2 * d2;

if (d0 < 0.0D || d3 < d0)

{

d0 = d3;

l = i2;

i1 = k2;

j1 = j2;

k1 = i3 % 2;

}

int i5 = l;

int j5 = i1;

j2 = j1;

int k5 = k1 % 2;

int l5 = 1 - k5;

if (k1 % 4 >= 2)

{

k5 = -k5;

l5 = -l5;

}

boolean flag;

if (d0 < 0.0D)

{

if (i1 < 70)

{

i1 = 70;

}

if (i1 > this.worldServerInstance.getActualHeight() - 10)

{

i1 = this.worldServerInstance.getActualHeight() - 10;

}

j5 = i1;

for (k2 = -1; k2 <= 1; ++k2)

{

for (i3 = 1; i3 < 3; ++i3)

{

for (l2 = -1; l2 < 3; ++l2)

{

k3 = i5 + (i3 - 1) * k5 + k2 * l5;

j3 = j5 + l2;

i4 = j2 + (i3 - 1) * l5 - k2 * k5;

flag = l2 < 0;

this.worldServerInstance.setBlock(k3, j3, i4, flag ? Block.obsidian.blockID : 0);

}

for (k2 = 0; k2 < 4; ++k2)

{

for (i3 = 0; i3 < 4; ++i3)

{

for (l2 = -1; l2 < 4; ++l2)

{

k3 = i5 + (i3 - 1) * k5;

j3 = j5 + l2;

i4 = j2 + (i3 - 1) * l5;

flag = i3 == 0 || i3 == 3 || l2 == -1 || l2 == 3;

this.worldServerInstance.setBlock(k3, j3, i4, flag ? Block.obsidian.blockID : Block.portal.blockID, 0, 2);

}

for (i3 = 0; i3 < 4; ++i3)

{

for (l2 = -1; l2 < 4; ++l2)

{

k3 = i5 + (i3 - 1) * k5;

j3 = j5 + l2;

i4 = j2 + (i3 - 1) * l5;

this.worldServerInstance.notifyBlocksOfNeighborChange(k3, j3, i4, this.worldServerInstance.getBlockId(k3, j3, i4));

}

return true;

}

/**

* called periodically to remove out-of-date portal locations from the cache list. Argument par1 is a

* WorldServer.getTotalWorldTime() value.

public void removeStalePortalLocations(long par1)

{

if (par1 % 100L == 0L)

{

Iterator iterator = this.destinationCoordinateKeys.iterator();

long j = par1 - 600L;

while (iterator.hasNext())

{

Long olong = (Long)iterator.next();

PortalPosition portalposition = (PortalPosition)this.destinationCoordinateCache.getValueByKey(olong.longValue());

if (portalposition == null || portalposition.lastUpdateTime < j)

{

iterator.remove();

this.destinationCoordinateCache.remove(olong.longValue());

}

You will now have an error under the constructor. To fix this add a line of code to the top that looks like this.

super(par1WorldServer);

Now the Teleporter file will work, but not with your portal or portal structure block (obsidian for the end portal). To fix this you should use Ctrl, F to find and replace all the Block.portal into your custom block. In the case of this tutorial it will have to be replaced with Tutorial.portalTutorialBlock. The other thing you have to search for is Block.obsidian. change this into the block you want the structure to be made out off. For this tutorial I will change it into sandStone.
After doing this your Teleporter file should work with your portal and structure block. Another thing you will have to do is go into the portal block file and add 2 methods. They are tryToCreatePortal and onNeighborBlockChange. Copy them from the BlockPortal file. The only things you will have to change in them is Block.portal into Tutorial.portalTutorialBlock and Block.obsidian into whatever your structure block is. This is to make sure that the portal blocks don't disappear when the portal is placed in the new dimension. The code for the whole Block file should look something like this with the 2 new methods.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.BlockPortal;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.entity.Entity;

import net.minecraft.entity.player.EntityPlayerMP;

import net.minecraft.server.MinecraftServer;

import net.minecraft.src.ModLoader;

import net.minecraft.world.World;

public class BlockPortalTutorial extends BlockPortal

{

public BlockPortalTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabBlock);

}

public void onEntityCollidedWithBlock(World par1World, int par2, int par3, int par4, Entity par5Entity)

{

if ((par5Entity.ridingEntity == null) && (par5Entity.riddenByEntity == null) && ((par5Entity instanceof EntityPlayerMP)))

{

EntityPlayerMP player = (EntityPlayerMP) par5Entity;

ModLoader.getMinecraftServerInstance();

MinecraftServer mServer = MinecraftServer.getServer();

if (player.timeUntilPortal > 0)

{

player.timeUntilPortal = 10;

}

else if (player.dimension != Tutorial.dimensionId)

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, Tutorial.dimensionId, new TeleporterTutorial(mServer.worldServerForDimension(Tutorial.dimensionId)));

}

else

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, 0, new TeleporterTutorial(mServer.worldServerForDimension(1)));

}

public boolean tryToCreatePortal(World par1World, int par2, int par3, int par4)

{

byte b0 = 0;

byte b1 = 0;

if (par1World.getBlockId(par2 - 1, par3, par4) == Block.sandStone.blockID || par1World.getBlockId(par2 + 1, par3, par4) == Block.sandStone.blockID)

{

b0 = 1;

}

if (par1World.getBlockId(par2, par3, par4 - 1) == Block.sandStone.blockID || par1World.getBlockId(par2, par3, par4 + 1) == Block.sandStone.blockID)

{

b1 = 1;

}

if (b0 == b1)

{

return false;

}

else

{

if (par1World.isAirBlock(par2 - b0, par3, par4 - b1))

{

par2 -= b0;

par4 -= b1;

}

int l;

int i1;

for (l = -1; l <= 2; ++l)

{

for (i1 = -1; i1 <= 3; ++i1)

{

boolean flag = l == -1 || l == 2 || i1 == -1 || i1 == 3;

if (l != -1 && l != 2 || i1 != -1 && i1 != 3)

{

int j1 = par1World.getBlockId(par2 + b0 * l, par3 + i1, par4 + b1 * l);

boolean isAirBlock = par1World.isAirBlock(par2 + b0 * l, par3 + i1, par4 + b1 * l);

if (flag)

{

if (j1 != Block.sandStone.blockID)

{

return false;

}

else if (!isAirBlock && j1 != Block.fire.blockID)

{

return false;

}

for (l = 0; l < 2; ++l)

{

for (i1 = 0; i1 < 3; ++i1)

{

par1World.setBlock(par2 + b0 * l, par3 + i1, par4 + b1 * l, Tutorial.portalTutorialBlock.blockID, 0, 2);

}

return true;

}

public void onNeighborBlockChange(World par1World, int par2, int par3, int par4, int par5)

{

byte b0 = 0;

byte b1 = 1;

if (par1World.getBlockId(par2 - 1, par3, par4) == this.blockID || par1World.getBlockId(par2 + 1, par3, par4) == this.blockID)

{

b0 = 1;

b1 = 0;

}

int i1;

for (i1 = par3; par1World.getBlockId(par2, i1 - 1, par4) == this.blockID; --i1)

{

;

}

if (par1World.getBlockId(par2, i1 - 1, par4) != Block.sandStone.blockID)

{

par1World.setBlockToAir(par2, par3, par4);

}

else

{

int j1;

for (j1 = 1; j1 < 4 && par1World.getBlockId(par2, i1 + j1, par4) == this.blockID; ++j1)

{

;

}

if (j1 == 3 && par1World.getBlockId(par2, i1 + j1, par4) == Block.sandStone.blockID)

{

boolean flag = par1World.getBlockId(par2 - 1, par3, par4) == this.blockID || par1World.getBlockId(par2 + 1, par3, par4) == this.blockID;

boolean flag1 = par1World.getBlockId(par2, par3, par4 - 1) == this.blockID || par1World.getBlockId(par2, par3, par4 + 1) == this.blockID;

if (flag && flag1)

{

par1World.setBlockToAir(par2, par3, par4);

}

else

{

if ((par1World.getBlockId(par2 + b0, par3, par4 + b1) != Block.sandStone.blockID || par1World.getBlockId(par2 - b0, par3, par4 - b1) != this.blockID) && (par1World.getBlockId(par2 - b0, par3, par4 - b1) != Block.sandStone.blockID || par1World.getBlockId(par2 + b0, par3, par4 + b1) != this.blockID))

{

par1World.setBlockToAir(par2, par3, par4);

}

else

{

par1World.setBlockToAir(par2, par3, par4);

}

Now when you place this portal block somewhere in the world the player will teleport to the custom dimension. One thing that you should remember is to make sure that the player moves through the portal block with it's head. For some reason when you only walk into it with your feet you will spawn in the ground.

In the next tutorials there will be customization for the dimension. Customization will contain caves, ravines, trees, mobs and most importantly, ways to get your portal to work. Right now the only way to get them is from the creative menu which is not a good way to do it. I will show you how to generate them and how to place them with custom items in a later tutorial, but for now you have a working dimension for you to experiment in.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Dimensions Part 3: Portal Block

2013-09-07T05:48:00.001-07:00

In the last two tutorials I showed you how to register a dimension and how to create the code to generate it. However, there is no way to get in there just yet. That is what we are going to do in this tutorial. Create a portal block which will make you get into the dimension.
Some of this code will be done in the Tutorial file which looks like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraftforge.common.DimensionManager;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Tutorial Mod", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

public static int dimensionId = 8;

EventManager eventmanager = new EventManager();

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 0), "Tutorial Item");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 1), "Second Tutorial Item");

GameRegistry.registerWorldGenerator(eventmanager);

TutorialCrafting.loadRecipes();

DimensionManager.registerProviderType(Tutorial.dimensionId, WorldProviderTutorial.class, false);

DimensionManager.registerDimension(Tutorial.dimensionId, Tutorial.dimensionId);

}

For a portal block you will have to start with the basic block registry. The code for that should look something like this.

public static Block portalTutorialBlock;
portalTutorialBlock = new BlockPortalTutorial(501).setUnlocalizedName("portalTutorialBlock");
GameRegistry.registerBlock(portalTutorialBlock, modid + (portalTutorialBlock.getUnlocalizedName().substring(5)));
LanguageRegistry.addName(portalTutorialBlock, "Portal Tutorial Block");

You should recognize all of this code from the basic block tutorial.
The whole file should now look like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraftforge.common.DimensionManager;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Tutorial Mod", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Block portalTutorialBlock;

public static Item tutorialItem;

public static int dimensionId = 8;

EventManager eventmanager = new EventManager();

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

portalTutorialBlock = new BlockPortalTutorial(501).setUnlocalizedName("portalTutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

GameRegistry.registerBlock(portalTutorialBlock, modid + (portalTutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

LanguageRegistry.addName(portalTutorialBlock, "Portal Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 0), "Tutorial Item");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 1), "Second Tutorial Item");

GameRegistry.registerWorldGenerator(eventmanager);

TutorialCrafting.loadRecipes();

DimensionManager.registerProviderType(Tutorial.dimensionId, WorldProviderTutorial.class, false);

DimensionManager.registerDimension(Tutorial.dimensionId, Tutorial.dimensionId);

}

The next thing we have to do is create the BlockPortalTutorial file. Hover your mouse over the BlockPortalTutorial and click create class which will create a class for you that should look like this.

package tutorial;

public class BlockPortalTutorial {

}

The next thing you will have to do is make it extend BlockPortal. When you do this you will first get an error under that which you can fix by importing. After that you will get an error under the class name. To fix that you will have to add the unimplemented methods.
After cleaning up the code a bit and adding it to the blocks creative tab it should look like this.

package tutorial;

import net.minecraft.block.BlockPortal;
import net.minecraft.creativetab.CreativeTabs;

public class BlockPortalTutorial extends BlockPortal

{

public BlockPortalTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabBlock);

}

Because of the way Java works, the BlockPortalTutorial file now has all the methods exactly the same as BlockPortal. This means that it currently also works exactly the same which is good. However, there are some changes we will have to make.
In this tutorial I will change only the things necessary for a working portal, but there will be customization of this block as well including other ways to get this portal (then getting it from the creative menu).
For the most simple version of a custom portal block there is only 1 method we will have to change. That method is the onEntityCollidedWithBlock method which handles the teleportation of the player.

public void onEntityCollidedWithBlock(World par1World, int par2, int par3, int par4, Entity par5Entity)

{

if ((par5Entity.ridingEntity == null) && (par5Entity.riddenByEntity == null) && ((par5Entity instanceof EntityPlayerMP)))

{

EntityPlayerMP player = (EntityPlayerMP) par5Entity;

ModLoader.getMinecraftServerInstance();

MinecraftServer mServer = MinecraftServer.getServer();

if (player.timeUntilPortal > 0)

{

player.timeUntilPortal = 10;

}

else if (player.dimension != Tutorial.dimensionId)

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, Tutorial.dimensionId, new TeleporterTutorial(mServer.worldServerForDimension(Tutorial.dimensionId)));

}

else

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, 0, new TeleporterTutorial(mServer.worldServerForDimension(1)));

}

This code looks really complicated, but it is actually quite simple. First it checks if the entity colliding with the portal is a player. Anything that isn't a player won't be allowed to move through the portal.
It will then check for the dimension and teleport it accordingly. If the entity is in the custom dimension it will put him in the overworld and if it's in anything but the custom dimension it will be moved there. You will also notice a timeUntilPortal variable used quite frequently in the code. This is a variable in EntityPlayer which makes sure that the player doesn't constantly teleport back and forth.
You will now have an error under the TeleporterTutorial file. This file will handle the actual teleportation for the player. I will show how to make this file in the next tutorial.
The whole block file should now look like this.

package tutorial;

import net.minecraft.block.BlockPortal;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.entity.Entity;

import net.minecraft.entity.player.EntityPlayerMP;

import net.minecraft.server.MinecraftServer;

import net.minecraft.src.ModLoader;

import net.minecraft.world.World;

public class BlockPortalTutorial extends BlockPortal

{

public BlockPortalTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabBlock);

}

public void onEntityCollidedWithBlock(World par1World, int par2, int par3, int par4, Entity par5Entity)

{

if ((par5Entity.ridingEntity == null) && (par5Entity.riddenByEntity == null) && ((par5Entity instanceof EntityPlayerMP)))

{

EntityPlayerMP player = (EntityPlayerMP) par5Entity;

ModLoader.getMinecraftServerInstance();

MinecraftServer mServer = MinecraftServer.getServer();

if (player.timeUntilPortal > 0)

{

player.timeUntilPortal = 10;

}

else if (player.dimension != Tutorial.dimensionId)

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, Tutorial.dimensionId, new TeleporterTutorial(mServer.worldServerForDimension(Tutorial.dimensionId)));

}

else

{

player.timeUntilPortal = 10;

player.mcServer.getConfigurationManager().transferPlayerToDimension(player, 0, new TeleporterTutorial(mServer.worldServerForDimension(1)));

}

In the next tutorial I will show you how to create the Teleporter file and you will have your own very basic dimension working.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Dimensions Part 2: ChunkProvider

2013-08-21T05:31:00.002-07:00

In this tutorial series I will show you how to add a dimension to Minecraft. At first this will be the most basic possible dimension, but after that there will be some customization. In this tutorial I will show you how to add a basic ChunkProvider to the dimension. In the last tutorial we ended up with this code.

package tutorial;

import net.minecraft.world.WorldProvider;

import net.minecraft.world.biome.BiomeGenBase;

import net.minecraft.world.biome.WorldChunkManagerHell;

import net.minecraft.world.chunk.IChunkProvider;

public class WorldProviderTutorial extends WorldProvider

{

public void registerWorldChunkManager()

{

this.worldChunkMgr = new WorldChunkManagerHell(BiomeGenBase.desertHills, 0.8F, 0.1F);

this.dimensionId = Tutorial.dimensionId;

}

public IChunkProvider createChunkGenerator()

{

return new ChunkProviderTutorial(worldObj, worldObj.getSeed(), true);

}

@Override

public String getDimensionName()

{

return "Tutorial";

}

Right now you will have an error under ChunkProviderTutorial, because we haven't created that file just yet. Let's do this right now by hovering your mouse over it and clicking create class. When you do this you will get a file that looks like this.

package tutorial;

import java.util.List;

import net.minecraft.entity.EnumCreatureType;

import net.minecraft.util.IProgressUpdate;

import net.minecraft.world.ChunkPosition;

import net.minecraft.world.World;

import net.minecraft.world.chunk.Chunk;

import net.minecraft.world.chunk.IChunkProvider;

public class ChunkProviderTutorial implements IChunkProvider

{

@Override

public boolean chunkExists(int i, int j)

{

// TODO Auto-generated method stub

return false;

}

@Override

public Chunk provideChunk(int i, int j)

{

// TODO Auto-generated method stub

return null;

}

@Override

public Chunk loadChunk(int i, int j)

{

// TODO Auto-generated method stub

return null;

}

@Override

public void populate(IChunkProvider ichunkprovider, int i, int j)

{

// TODO Auto-generated method stub

}

@Override

public boolean saveChunks(boolean flag, IProgressUpdate iprogressupdate)

{

// TODO Auto-generated method stub

return false;

}

@Override

public boolean unloadQueuedChunks()

{

// TODO Auto-generated method stub

return false;

}

@Override

public boolean canSave()

{

// TODO Auto-generated method stub

return false;

}

@Override

public String makeString()

{

// TODO Auto-generated method stub

return null;

}

@Override

public List getPossibleCreatures(EnumCreatureType enumcreaturetype, int i, int j, int k)

{

// TODO Auto-generated method stub

return null;

}

@Override

public ChunkPosition findClosestStructure(World world, String s, int i, int j, int k)

{

// TODO Auto-generated method stub

return null;

}

@Override

public int getLoadedChunkCount()

{

// TODO Auto-generated method stub

return 0;

}

@Override

public void recreateStructures(int i, int j)

{

// TODO Auto-generated method stub

}

@Override

public void func_104112_b()

{

// TODO Auto-generated method stub

}

You could go and fill in all of these methods, but that would take weeks. The easiest thing to do is just copy over the code from ChunkProviderGenerate and edit that later. When you copy over the code there are a few things you have to do. First of all go to the top where there will be an error under the package line. Fix this by hovering over it and clicking "change package declaration to 'your package name'". Then go to the public class line and fix the error under ChunkProviderGenerate by clicking "rename type to 'your file name'". Finally use Ctrl, Shift, O to import all the required files and all the errors should be gone.
The file should now look something like this.

package tutorial;

import static net.minecraftforge.event.terraingen.InitMapGenEvent.EventType.CAVE;

import static net.minecraftforge.event.terraingen.InitMapGenEvent.EventType.MINESHAFT;

import static net.minecraftforge.event.terraingen.InitMapGenEvent.EventType.RAVINE;

import static net.minecraftforge.event.terraingen.InitMapGenEvent.EventType.SCATTERED_FEATURE;

import static net.minecraftforge.event.terraingen.InitMapGenEvent.EventType.STRONGHOLD;

import static net.minecraftforge.event.terraingen.InitMapGenEvent.EventType.VILLAGE;

import static net.minecraftforge.event.terraingen.PopulateChunkEvent.Populate.EventType.DUNGEON;

import static net.minecraftforge.event.terraingen.PopulateChunkEvent.Populate.EventType.ICE;

import static net.minecraftforge.event.terraingen.PopulateChunkEvent.Populate.EventType.LAKE;

import static net.minecraftforge.event.terraingen.PopulateChunkEvent.Populate.EventType.LAVA;

import java.util.List;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.block.BlockSand;

import net.minecraft.entity.EnumCreatureType;

import net.minecraft.util.IProgressUpdate;

import net.minecraft.util.MathHelper;

import net.minecraft.world.ChunkPosition;

import net.minecraft.world.SpawnerAnimals;

import net.minecraft.world.World;

import net.minecraft.world.biome.BiomeGenBase;

import net.minecraft.world.chunk.Chunk;

import net.minecraft.world.chunk.IChunkProvider;

import net.minecraft.world.gen.MapGenBase;

import net.minecraft.world.gen.MapGenCaves;

import net.minecraft.world.gen.MapGenRavine;

import net.minecraft.world.gen.NoiseGeneratorOctaves;

import net.minecraft.world.gen.feature.MapGenScatteredFeature;

import net.minecraft.world.gen.feature.WorldGenDungeons;

import net.minecraft.world.gen.feature.WorldGenLakes;

import net.minecraft.world.gen.structure.MapGenMineshaft;

import net.minecraft.world.gen.structure.MapGenStronghold;

import net.minecraft.world.gen.structure.MapGenVillage;

import net.minecraftforge.common.MinecraftForge;

import net.minecraftforge.event.Event.Result;

import net.minecraftforge.event.terraingen.ChunkProviderEvent;

import net.minecraftforge.event.terraingen.PopulateChunkEvent;

import net.minecraftforge.event.terraingen.TerrainGen;

public class ChunkProviderTutorial implements IChunkProvider

{

/** RNG. */

private Random rand;

/** A NoiseGeneratorOctaves used in generating terrain */

private NoiseGeneratorOctaves noiseGen1;

/** A NoiseGeneratorOctaves used in generating terrain */

private NoiseGeneratorOctaves noiseGen2;

/** A NoiseGeneratorOctaves used in generating terrain */

private NoiseGeneratorOctaves noiseGen3;

/** A NoiseGeneratorOctaves used in generating terrain */

private NoiseGeneratorOctaves noiseGen4;

/** A NoiseGeneratorOctaves used in generating terrain */

public NoiseGeneratorOctaves noiseGen5;

/** A NoiseGeneratorOctaves used in generating terrain */

public NoiseGeneratorOctaves noiseGen6;

public NoiseGeneratorOctaves mobSpawnerNoise;

/** Reference to the World object. */

private World worldObj;

/** are map structures going to be generated (e.g. strongholds) */

private final boolean mapFeaturesEnabled;

/** Holds the overall noise array used in chunk generation */

private double[] noiseArray;

private double[] stoneNoise = new double[256];

private MapGenBase caveGenerator = new MapGenCaves();

/** Holds Stronghold Generator */

private MapGenStronghold strongholdGenerator = new MapGenStronghold();

/** Holds Village Generator */

private MapGenVillage villageGenerator = new MapGenVillage();

/** Holds Mineshaft Generator */

private MapGenMineshaft mineshaftGenerator = new MapGenMineshaft();

private MapGenScatteredFeature scatteredFeatureGenerator = new MapGenScatteredFeature();

/** Holds ravine generator */

private MapGenBase ravineGenerator = new MapGenRavine();

/** The biomes that are used to generate the chunk */

private BiomeGenBase[] biomesForGeneration;

/** A double array that hold terrain noise from noiseGen3 */

double[] noise3;

/** A double array that hold terrain noise */

double[] noise1;

/** A double array that hold terrain noise from noiseGen2 */

double[] noise2;

/** A double array that hold terrain noise from noiseGen5 */

double[] noise5;

/** A double array that holds terrain noise from noiseGen6 */

double[] noise6;

/**

* Used to store the 5x5 parabolic field that is used during terrain generation.

float[] parabolicField;

int[][] field_73219_j = new int[32][32];

{

caveGenerator = TerrainGen.getModdedMapGen(caveGenerator, CAVE);

strongholdGenerator = (MapGenStronghold) TerrainGen.getModdedMapGen(strongholdGenerator, STRONGHOLD);

villageGenerator = (MapGenVillage) TerrainGen.getModdedMapGen(villageGenerator, VILLAGE);

mineshaftGenerator = (MapGenMineshaft) TerrainGen.getModdedMapGen(mineshaftGenerator, MINESHAFT);

scatteredFeatureGenerator = (MapGenScatteredFeature) TerrainGen.getModdedMapGen(scatteredFeatureGenerator, SCATTERED_FEATURE);

ravineGenerator = TerrainGen.getModdedMapGen(ravineGenerator, RAVINE);

}

public ChunkProviderTutorial(World par1World, long par2, boolean par4)

{

this.worldObj = par1World;

this.mapFeaturesEnabled = par4;

this.rand = new Random(par2);

this.noiseGen1 = new NoiseGeneratorOctaves(this.rand, 16);

this.noiseGen2 = new NoiseGeneratorOctaves(this.rand, 16);

this.noiseGen3 = new NoiseGeneratorOctaves(this.rand, 8);

this.noiseGen4 = new NoiseGeneratorOctaves(this.rand, 4);

this.noiseGen5 = new NoiseGeneratorOctaves(this.rand, 10);

this.noiseGen6 = new NoiseGeneratorOctaves(this.rand, 16);

this.mobSpawnerNoise = new NoiseGeneratorOctaves(this.rand, 8);

NoiseGeneratorOctaves[] noiseGens = {noiseGen1, noiseGen2, noiseGen3, noiseGen4, noiseGen5, noiseGen6, mobSpawnerNoise};

noiseGens = TerrainGen.getModdedNoiseGenerators(par1World, this.rand, noiseGens);

this.noiseGen1 = noiseGens[0];

this.noiseGen2 = noiseGens[1];

this.noiseGen3 = noiseGens[2];

this.noiseGen4 = noiseGens[3];

this.noiseGen5 = noiseGens[4];

this.noiseGen6 = noiseGens[5];

this.mobSpawnerNoise = noiseGens[6];

}

/**

* Generates the shape of the terrain for the chunk though its all stone though the water is frozen if the

* temperature is low enough

public void generateTerrain(int par1, int par2, byte[] par3ArrayOfByte)

{

byte b0 = 4;

byte b1 = 16;

byte b2 = 63;

int k = b0 + 1;

byte b3 = 17;

int l = b0 + 1;

this.biomesForGeneration = this.worldObj.getWorldChunkManager().getBiomesForGeneration(this.biomesForGeneration, par1 * 4 - 2, par2 * 4 - 2, k + 5, l + 5);

this.noiseArray = this.initializeNoiseField(this.noiseArray, par1 * b0, 0, par2 * b0, k, b3, l);

for (int i1 = 0; i1 < b0; ++i1)

{

for (int j1 = 0; j1 < b0; ++j1)

{

for (int k1 = 0; k1 < b1; ++k1)

{

double d0 = 0.125D;

double d1 = this.noiseArray[((i1 + 0) * l + j1 + 0) * b3 + k1 + 0];

double d2 = this.noiseArray[((i1 + 0) * l + j1 + 1) * b3 + k1 + 0];

double d3 = this.noiseArray[((i1 + 1) * l + j1 + 0) * b3 + k1 + 0];

double d4 = this.noiseArray[((i1 + 1) * l + j1 + 1) * b3 + k1 + 0];

double d5 = (this.noiseArray[((i1 + 0) * l + j1 + 0) * b3 + k1 + 1] - d1) * d0;

double d6 = (this.noiseArray[((i1 + 0) * l + j1 + 1) * b3 + k1 + 1] - d2) * d0;

double d7 = (this.noiseArray[((i1 + 1) * l + j1 + 0) * b3 + k1 + 1] - d3) * d0;

double d8 = (this.noiseArray[((i1 + 1) * l + j1 + 1) * b3 + k1 + 1] - d4) * d0;

for (int l1 = 0; l1 < 8; ++l1)

{

double d9 = 0.25D;

double d10 = d1;

double d11 = d2;

double d12 = (d3 - d1) * d9;

double d13 = (d4 - d2) * d9;

for (int i2 = 0; i2 < 4; ++i2)

{

int j2 = i2 + i1 * 4 << 11 | 0 + j1 * 4 << 7 | k1 * 8 + l1;

short short1 = 128;

j2 -= short1;

double d14 = 0.25D;

double d15 = (d11 - d10) * d14;

double d16 = d10 - d15;

for (int k2 = 0; k2 < 4; ++k2)

{

if ((d16 += d15) > 0.0D)

{

par3ArrayOfByte[j2 += short1] = (byte)Block.stone.blockID;

}

else if (k1 * 8 + l1 < b2)

{

par3ArrayOfByte[j2 += short1] = (byte)Block.waterStill.blockID;

}

else

{

par3ArrayOfByte[j2 += short1] = 0;

}

d10 += d12;

d11 += d13;

}

d1 += d5;

d2 += d6;

d3 += d7;

d4 += d8;

}

/**

* Replaces the stone that was placed in with blocks that match the biome

public void replaceBlocksForBiome(int par1, int par2, byte[] par3ArrayOfByte, BiomeGenBase[] par4ArrayOfBiomeGenBase)

{

ChunkProviderEvent.ReplaceBiomeBlocks event = new ChunkProviderEvent.ReplaceBiomeBlocks(this, par1, par2, par3ArrayOfByte, par4ArrayOfBiomeGenBase);

MinecraftForge.EVENT_BUS.post(event);

if (event.getResult() == Result.DENY) return;

byte b0 = 63;

double d0 = 0.03125D;

this.stoneNoise = this.noiseGen4.generateNoiseOctaves(this.stoneNoise, par1 * 16, par2 * 16, 0, 16, 16, 1, d0 * 2.0D, d0 * 2.0D, d0 * 2.0D);

for (int k = 0; k < 16; ++k)

{

for (int l = 0; l < 16; ++l)

{

BiomeGenBase biomegenbase = par4ArrayOfBiomeGenBase[l + k * 16];

float f = biomegenbase.getFloatTemperature();

int i1 = (int)(this.stoneNoise[k + l * 16] / 3.0D + 3.0D + this.rand.nextDouble() * 0.25D);

int j1 = -1;

byte b1 = biomegenbase.topBlock;

byte b2 = biomegenbase.fillerBlock;

for (int k1 = 127; k1 >= 0; --k1)

{

int l1 = (l * 16 + k) * 128 + k1;

if (k1 <= 0 + this.rand.nextInt(5))

{

par3ArrayOfByte[l1] = (byte)Block.bedrock.blockID;

}

else

{

byte b3 = par3ArrayOfByte[l1];

if (b3 == 0)

{

j1 = -1;

}

else if (b3 == Block.stone.blockID)

{

if (j1 == -1)

{

if (i1 <= 0)

{

b1 = 0;

b2 = (byte)Block.stone.blockID;

}

else if (k1 >= b0 - 4 && k1 <= b0 + 1)

{

b1 = biomegenbase.topBlock;

b2 = biomegenbase.fillerBlock;

}

if (k1 < b0 && b1 == 0)

{

if (f < 0.15F)

{

b1 = (byte)Block.ice.blockID;

}

else

{

b1 = (byte)Block.waterStill.blockID;

}

j1 = i1;

if (k1 >= b0 - 1)

{

par3ArrayOfByte[l1] = b1;

}

else

{

par3ArrayOfByte[l1] = b2;

}

else if (j1 > 0)

{

--j1;

par3ArrayOfByte[l1] = b2;

if (j1 == 0 && b2 == Block.sand.blockID)

{

j1 = this.rand.nextInt(4);

b2 = (byte)Block.sandStone.blockID;

}

/**

* loads or generates the chunk at the chunk location specified

public Chunk loadChunk(int par1, int par2)

{

return this.provideChunk(par1, par2);

}

/**

* Will return back a chunk, if it doesn't exist and its not a MP client it will generates all the blocks for the

* specified chunk from the map seed and chunk seed

public Chunk provideChunk(int par1, int par2)

{

this.rand.setSeed((long)par1 * 341873128712L + (long)par2 * 132897987541L);

byte[] abyte = new byte[32768];

this.generateTerrain(par1, par2, abyte);

this.biomesForGeneration = this.worldObj.getWorldChunkManager().loadBlockGeneratorData(this.biomesForGeneration, par1 * 16, par2 * 16, 16, 16);

this.replaceBlocksForBiome(par1, par2, abyte, this.biomesForGeneration);

this.caveGenerator.generate(this, this.worldObj, par1, par2, abyte);

this.ravineGenerator.generate(this, this.worldObj, par1, par2, abyte);

if (this.mapFeaturesEnabled)

{

this.mineshaftGenerator.generate(this, this.worldObj, par1, par2, abyte);

this.villageGenerator.generate(this, this.worldObj, par1, par2, abyte);

this.strongholdGenerator.generate(this, this.worldObj, par1, par2, abyte);

this.scatteredFeatureGenerator.generate(this, this.worldObj, par1, par2, abyte);

}

Chunk chunk = new Chunk(this.worldObj, abyte, par1, par2);

byte[] abyte1 = chunk.getBiomeArray();

for (int k = 0; k < abyte1.length; ++k)

{

abyte1[k] = (byte)this.biomesForGeneration[k].biomeID;

}

chunk.generateSkylightMap();

return chunk;

}

/**

* generates a subset of the level's terrain data. Takes 7 arguments: the [empty] noise array, the position, and the

* size.

private double[] initializeNoiseField(double[] par1ArrayOfDouble, int par2, int par3, int par4, int par5, int par6, int par7)

{

ChunkProviderEvent.InitNoiseField event = new ChunkProviderEvent.InitNoiseField(this, par1ArrayOfDouble, par2, par3, par4, par5, par6, par7);

MinecraftForge.EVENT_BUS.post(event);

if (event.getResult() == Result.DENY) return event.noisefield;

if (par1ArrayOfDouble == null)

{

par1ArrayOfDouble = new double[par5 * par6 * par7];

}

if (this.parabolicField == null)

{

this.parabolicField = new float[25];

for (int k1 = -2; k1 <= 2; ++k1)

{

for (int l1 = -2; l1 <= 2; ++l1)

{

float f = 10.0F / MathHelper.sqrt_float((float)(k1 * k1 + l1 * l1) + 0.2F);

this.parabolicField[k1 + 2 + (l1 + 2) * 5] = f;

}

double d0 = 684.412D;

double d1 = 684.412D;

this.noise5 = this.noiseGen5.generateNoiseOctaves(this.noise5, par2, par4, par5, par7, 1.121D, 1.121D, 0.5D);

this.noise6 = this.noiseGen6.generateNoiseOctaves(this.noise6, par2, par4, par5, par7, 200.0D, 200.0D, 0.5D);

this.noise3 = this.noiseGen3.generateNoiseOctaves(this.noise3, par2, par3, par4, par5, par6, par7, d0 / 80.0D, d1 / 160.0D, d0 / 80.0D);

this.noise1 = this.noiseGen1.generateNoiseOctaves(this.noise1, par2, par3, par4, par5, par6, par7, d0, d1, d0);

this.noise2 = this.noiseGen2.generateNoiseOctaves(this.noise2, par2, par3, par4, par5, par6, par7, d0, d1, d0);

boolean flag = false;

boolean flag1 = false;

int i2 = 0;

int j2 = 0;

for (int k2 = 0; k2 < par5; ++k2)

{

for (int l2 = 0; l2 < par7; ++l2)

{

float f1 = 0.0F;

float f2 = 0.0F;

float f3 = 0.0F;

byte b0 = 2;

BiomeGenBase biomegenbase = this.biomesForGeneration[k2 + 2 + (l2 + 2) * (par5 + 5)];

for (int i3 = -b0; i3 <= b0; ++i3)

{

for (int j3 = -b0; j3 <= b0; ++j3)

{

BiomeGenBase biomegenbase1 = this.biomesForGeneration[k2 + i3 + 2 + (l2 + j3 + 2) * (par5 + 5)];

float f4 = this.parabolicField[i3 + 2 + (j3 + 2) * 5] / (biomegenbase1.minHeight + 2.0F);

if (biomegenbase1.minHeight > biomegenbase.minHeight)

{

f4 /= 2.0F;

}

f1 += biomegenbase1.maxHeight * f4;

f2 += biomegenbase1.minHeight * f4;

f3 += f4;

}

f1 /= f3;

f2 /= f3;

f1 = f1 * 0.9F + 0.1F;

f2 = (f2 * 4.0F - 1.0F) / 8.0F;

double d2 = this.noise6[j2] / 8000.0D;

if (d2 < 0.0D)

{

d2 = -d2 * 0.3D;

}

d2 = d2 * 3.0D - 2.0D;

if (d2 < 0.0D)

{

d2 /= 2.0D;

if (d2 < -1.0D)

{

d2 = -1.0D;

}

d2 /= 1.4D;

d2 /= 2.0D;

}

else

{

if (d2 > 1.0D)

{

d2 = 1.0D;

}

d2 /= 8.0D;

}

++j2;

for (int k3 = 0; k3 < par6; ++k3)

{

double d3 = (double)f2;

double d4 = (double)f1;

d3 += d2 * 0.2D;

d3 = d3 * (double)par6 / 16.0D;

double d5 = (double)par6 / 2.0D + d3 * 4.0D;

double d6 = 0.0D;

double d7 = ((double)k3 - d5) * 12.0D * 128.0D / 128.0D / d4;

if (d7 < 0.0D)

{

d7 *= 4.0D;

}

double d8 = this.noise1[i2] / 512.0D;

double d9 = this.noise2[i2] / 512.0D;

double d10 = (this.noise3[i2] / 10.0D + 1.0D) / 2.0D;

if (d10 < 0.0D)

{

d6 = d8;

}

else if (d10 > 1.0D)

{

d6 = d9;

}

else

{

d6 = d8 + (d9 - d8) * d10;

}

d6 -= d7;

if (k3 > par6 - 4)

{

double d11 = (double)((float)(k3 - (par6 - 4)) / 3.0F);

d6 = d6 * (1.0D - d11) + -10.0D * d11;

}

par1ArrayOfDouble[i2] = d6;

++i2;

}

return par1ArrayOfDouble;

}

/**

* Checks to see if a chunk exists at x, y

public boolean chunkExists(int par1, int par2)

{

return true;

}

/**

* Populates chunk with ores etc etc

public void populate(IChunkProvider par1IChunkProvider, int par2, int par3)

{

BlockSand.fallInstantly = true;

int k = par2 * 16;

int l = par3 * 16;

BiomeGenBase biomegenbase = this.worldObj.getBiomeGenForCoords(k + 16, l + 16);

this.rand.setSeed(this.worldObj.getSeed());

long i1 = this.rand.nextLong() / 2L * 2L + 1L;

long j1 = this.rand.nextLong() / 2L * 2L + 1L;

this.rand.setSeed((long)par2 * i1 + (long)par3 * j1 ^ this.worldObj.getSeed());

boolean flag = false;

MinecraftForge.EVENT_BUS.post(new PopulateChunkEvent.Pre(par1IChunkProvider, worldObj, rand, par2, par3, flag));

if (this.mapFeaturesEnabled)

{

this.mineshaftGenerator.generateStructuresInChunk(this.worldObj, this.rand, par2, par3);

flag = this.villageGenerator.generateStructuresInChunk(this.worldObj, this.rand, par2, par3);

this.strongholdGenerator.generateStructuresInChunk(this.worldObj, this.rand, par2, par3);

this.scatteredFeatureGenerator.generateStructuresInChunk(this.worldObj, this.rand, par2, par3);

}

int k1;

int l1;

int i2;

if (biomegenbase != BiomeGenBase.desert && biomegenbase != BiomeGenBase.desertHills && !flag && this.rand.nextInt(4) == 0

&& TerrainGen.populate(par1IChunkProvider, worldObj, rand, par2, par3, flag, LAKE))

{

k1 = k + this.rand.nextInt(16) + 8;

l1 = this.rand.nextInt(128);

i2 = l + this.rand.nextInt(16) + 8;

(new WorldGenLakes(Block.waterStill.blockID)).generate(this.worldObj, this.rand, k1, l1, i2);

}

if (TerrainGen.populate(par1IChunkProvider, worldObj, rand, par2, par3, flag, LAVA) &&

!flag && this.rand.nextInt(8) == 0)

{

k1 = k + this.rand.nextInt(16) + 8;

l1 = this.rand.nextInt(this.rand.nextInt(120) + 8);

i2 = l + this.rand.nextInt(16) + 8;

if (l1 < 63 || this.rand.nextInt(10) == 0)

{

(new WorldGenLakes(Block.lavaStill.blockID)).generate(this.worldObj, this.rand, k1, l1, i2);

}

boolean doGen = TerrainGen.populate(par1IChunkProvider, worldObj, rand, par2, par3, flag, DUNGEON);

for (k1 = 0; doGen && k1 < 8; ++k1)

{

l1 = k + this.rand.nextInt(16) + 8;

i2 = this.rand.nextInt(128);

int j2 = l + this.rand.nextInt(16) + 8;

(new WorldGenDungeons()).generate(this.worldObj, this.rand, l1, i2, j2);

}

biomegenbase.decorate(this.worldObj, this.rand, k, l);

SpawnerAnimals.performWorldGenSpawning(this.worldObj, biomegenbase, k + 8, l + 8, 16, 16, this.rand);

k += 8;

l += 8;

doGen = TerrainGen.populate(par1IChunkProvider, worldObj, rand, par2, par3, flag, ICE);

for (k1 = 0; doGen && k1 < 16; ++k1)

{

for (l1 = 0; l1 < 16; ++l1)

{

i2 = this.worldObj.getPrecipitationHeight(k + k1, l + l1);

if (this.worldObj.isBlockFreezable(k1 + k, i2 - 1, l1 + l))

{

this.worldObj.setBlock(k1 + k, i2 - 1, l1 + l, Block.ice.blockID, 0, 2);

}

if (this.worldObj.canSnowAt(k1 + k, i2, l1 + l))

{

this.worldObj.setBlock(k1 + k, i2, l1 + l, Block.snow.blockID, 0, 2);

}

MinecraftForge.EVENT_BUS.post(new PopulateChunkEvent.Post(par1IChunkProvider, worldObj, rand, par2, par3, flag));

BlockSand.fallInstantly = false;

}

/**

* Two modes of operation: if passed true, save all Chunks in one go. If passed false, save up to two chunks.

* Return true if all chunks have been saved.

public boolean saveChunks(boolean par1, IProgressUpdate par2IProgressUpdate)

{

return true;

}

public void func_104112_b() {}

/**

* Unloads chunks that are marked to be unloaded. This is not guaranteed to unload every such chunk.

public boolean unloadQueuedChunks()

{

return false;

}

/**

* Returns if the IChunkProvider supports saving.

public boolean canSave()

{

return true;

}

/**

* Converts the instance data to a readable string.

public String makeString()

{

return "RandomLevelSource";

}

/**

* Returns a list of creatures of the specified type that can spawn at the given location.

public List getPossibleCreatures(EnumCreatureType par1EnumCreatureType, int par2, int par3, int par4)

{

BiomeGenBase biomegenbase = this.worldObj.getBiomeGenForCoords(par2, par4);

return biomegenbase == null ? null : (biomegenbase == BiomeGenBase.swampland && par1EnumCreatureType == EnumCreatureType.monster && this.scatteredFeatureGenerator.hasStructureAt(par2, par3, par4) ? this.scatteredFeatureGenerator.getScatteredFeatureSpawnList() : biomegenbase.getSpawnableList(par1EnumCreatureType));

}

/**

* Returns the location of the closest structure of the specified type. If not found returns null.

public ChunkPosition findClosestStructure(World par1World, String par2Str, int par3, int par4, int par5)

{

return "Stronghold".equals(par2Str) && this.strongholdGenerator != null ? this.strongholdGenerator.getNearestInstance(par1World, par3, par4, par5) : null;

}

public int getLoadedChunkCount()

{

return 0;

}

public void recreateStructures(int par1, int par2)

{

if (this.mapFeaturesEnabled)

{

this.mineshaftGenerator.generate(this, this.worldObj, par1, par2, (byte[])null);

this.villageGenerator.generate(this, this.worldObj, par1, par2, (byte[])null);

this.strongholdGenerator.generate(this, this.worldObj, par1, par2, (byte[])null);

this.scatteredFeatureGenerator.generate(this, this.worldObj, par1, par2, (byte[])null);

}

From now on I will never put the whole ChunkProvider file in these posts, because it is way too big. Instead I will show you the changed pieces of code.
I won't be explaining all of this code, because that would not really help a lot of people and it would take weeks to do so. However, in the customization tutorials I will show you what you may want to change in this file. In short the ChunkProvider pretty much generates or calls to generate all of the blocks. In here you can find code for caves, ravines, stone, biome blocks, dungeons, lakes etc. etc. It also does several other things like make the Ender eye work and the spawning of mobs.
These are all the files you need to create a proper dimension. However, you have no way to get there yet. In the next tutorials I will show you how to create a portal block and portal structure to get into the new dimension. After that will be loads of customization.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Dimensions Part 1: Registry and WorldProvider

2013-08-17T10:49:00.001-07:00

In this tutorial series I will show you how to add a custom dimension to Minecraft. At first this will be the most basic possible dimension, but after that there will be some customization.
The first part of the code is done in the main mod file. This is the file I will start with.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.enchantment.Enchantment;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraft.item.crafting.FurnaceRecipes;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Tutorial Mod", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

EventManager eventmanager = new EventManager();

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 0), "Tutorial Item");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 1), "Second Tutorial Item");

GameRegistry.registerWorldGenerator(eventmanager);

TutorialCrafting.loadRecipes();

}

The first thing you will have to do is make a dimension id variable. You need to make this a variable, because you will be using this number quite a few times.

public static int dimensionId = 8;

You should keep this number pretty low, but you can't use 0, 1 or -1.
The next thing you need to do is add 2 lines to the load method.

DimensionManager.registerProviderType(Tutorial.dimensionId, WorldProviderTutorial.class, false);

DimensionManager.registerDimension(Tutorial.dimensionId, Tutorial.dimensionId);

The first line is to register the world provider. The first parameter is the id of the dimension. The second is the world provider and the last is a boolean whether or not the dimension should be loaded at all times. I suggest keeping this false at all times to keep the load time of the world low. The WorldProvider will be a file for the dimenson which will do several things. It will give the biome of the dimension, but it will also contain quite a few important options for the dimension.
The second line is simply twice the dimension id to register the dimension.
Now the mod file should look like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraftforge.common.DimensionManager;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Tutorial Mod", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

public static int dimensionId = 8;

EventManager eventmanager = new EventManager();

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 0), "Tutorial Item");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 1), "Second Tutorial Item");

GameRegistry.registerWorldGenerator(eventmanager);

TutorialCrafting.loadRecipes();

DimensionManager.registerProviderType(Tutorial.dimensionId, WorldProviderTutorial.class, false);

DimensionManager.registerDimension(Tutorial.dimensionId, Tutorial.dimensionId);

}

Right now you will have an error under WorldProviderTutorial. To fix that hover your mouse over it and click create class. Then make that file extend WorldProvider, import and add unimplemented methods. You should get a file that looks like this.

package tutorial;

import net.minecraft.world.WorldProvider;

public class WorldProviderTutorial extends WorldProvider

{

@Override

public String getDimensionName()

{

return null;

}

Now change the method from returning null into returning a String with whatever the name of your dimension should be. For me it will be called "Tutorial".
There are a couple of methods you have to add to get a working dimension. First of all you will need the registerWorldChunkManager method which should look like this.

public void registerWorldChunkManager()

{

this.worldChunkMgr = new WorldChunkManagerHell(BiomeGenBase.desertHills, 0.8F, 0.1F);

this.dimensionId = Tutorial.dimensionId;

}

The first line sets several things for the dimension. The WorldChunkManager takes care of which biomes generate where and it also manages rain and temperature (snow or rain). The first parameter is the biome the whole dimension will have. The second parameter is the temperature and the last is how often it will rain. 0.1F being very little and 1.0F being very often.
The second line you will just have to copy over again to make sure that the dimension works properly.

There is one more method you will need to get the dimension to work. This is the createChunkGenerator method. It should look like this.

public IChunkProvider createChunkGenerator()

{

return new ChunkProviderTutorial(worldObj, worldObj.getSeed(), true);

}

The ChunkProvider is one of the most important files in all of the dimension code. It's also very big so we won't cover that in this tutorial. In there will be the code for the generation of stone, bedrock and lakes, but it will also be the place where you can find the code for caves, ravines, dungeons and many other things. The line has to be exactly the same for you as in this tutorial except for of course the name of the file.

The whole WorldProvider file should now look like this.

package tutorial;

import net.minecraft.world.WorldProvider;

import net.minecraft.world.biome.BiomeGenBase;

import net.minecraft.world.biome.WorldChunkManagerHell;

import net.minecraft.world.chunk.IChunkProvider;

public class WorldProviderTutorial extends WorldProvider

{

public void registerWorldChunkManager()

{

this.worldChunkMgr = new WorldChunkManagerHell(BiomeGenBase.desertHills, 0.8F, 0.1F);

this.dimensionId = Tutorial.dimensionId;

}

public IChunkProvider createChunkGenerator()

{

return new ChunkProviderTutorial(worldObj, worldObj.getSeed(), true);

}

@Override

public String getDimensionName()

{

return "Tutorial";

}

There are many more methods that you may want to add to this file, but for now we will keep it to the basics. Once we have a working dimension I will show you how to add all kinds of customization to it.

Right now you will have an error under ChunkProviderTutorial. We will fix that in the next tutorial by creating that file.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Metadata Items

2013-08-17T04:51:00.000-07:00

In this tutorial I'm going to show you how to create metadata Items. For this you will have to make some small changes to the mod file and you will have to change a lot in the Item file. These are the files I will start with.
ItemTutorial

package tutorial;

public class ItemTutorial extends ItemGeneralTutorial

{

public ItemTutorial(int id)

{

super(id);

}

Mod file

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.Init;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

EventManager eventmanager = new EventManager();

@Init

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

GameRegistry.registerWorldGenerator(eventmanager);

TutorialCrafting.addRecipes();

}

Before you read this tutorial I suggest reading through the Block tutorial. There will be some references to that tutorial in here.
For metadata blocks you needed an ItemBlock. For Item metadata you don't need one since there is already an Item file. There are some small differences, but in short for Item metadata you need the code from the Block and ItemBlock file all in the Item file.
In the current Item file we extend the ItemGeneralTutorial which can be used for basic Items. Since this is not a basic item you should change ItemGeneralTutorial into Item and copy the code from the General file in the ItemTutorial file. We are going to make quite some changes to the code. This is what the file should look like now.

package tutorial;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.Item;

public class ItemTutorial extends Item

{

public ItemTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabMaterials);

}

public void registerIcons(IconRegister par1IconRegister)

{

this.itemIcon = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)));

}

Like the Block file you will need an Icon array to load all the images. We can just copy that part of the code from the Block file. The new code should look like this.

@SideOnly(Side.CLIENT)

private Icon[] icons;

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

icons = new Icon[2];

for(int i = 0; i < icons.length; i++)

{

icons[i] = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)) + i);

}

If you don't know what this code means you should read the Block Metadata tutorial. The code is explained in there.
Again like the Block file you need to make sure that the Items get different textures depending on the metadata. Since Items don't have sides the code for this is quite a bit easier. It should look like this for every Item if you follow the tutorial exactly.

public Icon getIconFromDamage(int par1)

{

return icons[par1];

}

This method has one parameter which is the damage of the item. The thing it wants returned is the Icon. Because we have an Icon array that has the same numbers for metadata as for the Icon we can simply return icons[par1] for every single metadata and that is the same in every metadata Item that is made like this.
There is one more thing that can be copied from the Block file. That is the getSubBlocks method. The only difference is, of course, that you have to change the name into getSubItems. The method should look like this.

@SideOnly(Side.CLIENT)

public void getSubItems(int par1, CreativeTabs par2CreativeTabs, List par3List)

{

for (int x = 0; x < 2; x++)

{

par3List.add(new ItemStack(this, 1, x));

}

This code is exactly the same as in the Block tutorial, if you don't understand it, read that tutorial.
Now there are just 2 things left to do. The first is to make sure that the Item names are different for each metadata and then to make sure that the names in game are also different. The first thing is done by creating a String array that contains a special name for every metadata.
When you have made that array you will have to add the getUnlocalizedName method to the ItemTutorial file and add this code in there.

public static final String[] names = new String[] {"first", "second"};

public String getUnlocalizedName(ItemStack par1ItemStack)

{

int i = MathHelper.clamp_int(par1ItemStack.getItemDamage(), 0, 15);

return super.getUnlocalizedName() + "." + names[i];

}

The code in this method is also the same for every single metadata Item.
There is one more important line of code you will have to add to the constructor. That code is the following.

this.setHasSubtypes(true);

The Item file should now look like this.

package tutorial;

import java.util.List;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraft.util.Icon;

import net.minecraft.util.MathHelper;

import cpw.mods.fml.relauncher.Side;

import cpw.mods.fml.relauncher.SideOnly;

public class ItemTutorial extends Item

{

public ItemTutorial(int id)

{

super(id);
this.setHasSubtypes(true);

this.setCreativeTab(CreativeTabs.tabMaterials);

}

@SideOnly(Side.CLIENT)

private Icon[] icons;

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

icons = new Icon[2];

for(int i = 0; i < icons.length; i++)

{

icons[i] = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)) + i);

}

public static final String[] names = new String[] {"first", "second"};

public String getUnlocalizedName(ItemStack par1ItemStack)

{

int i = MathHelper.clamp_int(par1ItemStack.getItemDamage(), 0, 15);

return super.getUnlocalizedName() + "." + names[i];

}

public Icon getIconFromDamage(int par1)

{

return icons[par1];

}

@SideOnly(Side.CLIENT)

public void getSubItems(int par1, CreativeTabs par2CreativeTabs, List par3List)

{

for (int x = 0; x < 2; x++)

{

par3List.add(new ItemStack(this, 1, x));

}

The last step for metadata Items is to use LanguageRegistry to add different in-game news for the Item. The code for that should look like this.

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 0), "Tutorial Item");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 1), "Second Tutorial Item");

The whole Mod file should now look like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.Init;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

EventManager eventmanager = new EventManager();

@Init

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 0), "Tutorial Item");

LanguageRegistry.addName(new ItemStack(tutorialItem, 1, 1), "Second Tutorial Item");

GameRegistry.registerWorldGenerator(eventmanager);

TutorialCrafting.addRecipes();

}

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Nether, End and Metadata Ore Generation

2013-08-17T04:42:00.001-07:00

In this tutorial I'm going to show you how to add ore generation to the nether. If you haven't already read through the tutorial for overworld generation. I'm not going over the basics again in this tutorial. For this tutorial all you will have to do is create a new file and edit the EventManager file. This is the file I will start with.

package tutorial;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.world.World;

import net.minecraft.world.chunk.IChunkProvider;

import net.minecraft.world.gen.feature.WorldGenMinable;

import cpw.mods.fml.common.IWorldGenerator;

public class EventManager implements IWorldGenerator

{

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

{

switch(world.provider.dimensionId)

{

case -1: generateNether(world, random, chunkX * 16, chunkZ * 16);

case 0: generateSurface(world, random, chunkX * 16, chunkZ * 16);

case 1: generateEnd(world, random, chunkX * 16, chunkZ * 16);

}

private void generateEnd(World world, Random random, int x, int z)

{

}

private void generateSurface(World world, Random random, int x, int z)

{

this.addOreSpawn(Tutorial.tutorialBlock, world, random, x, z, 16, 16, 4 + random.nextInt(3), 5, 15, 50);

}

private void generateNether(World world, Random random, int x, int z)

{

}

/**

* Adds an Ore Spawn to Minecraft. Simply register all Ores to spawn with this method in your Generation method in your IWorldGeneration extending Class

* @param The Block to spawn

* @param The World to spawn in

* @param A Random object for retrieving random positions within the world to spawn the Block

* @param An int for passing the X-Coordinate for the Generation method

* @param An int for passing the Z-Coordinate for the Generation method

* @param An int for setting the maximum X-Coordinate values for spawning on the X-Axis on a Per-Chunk basis

* @param An int for setting the maximum Z-Coordinate values for spawning on the Z-Axis on a Per-Chunk basis

* @param An int for setting the maximum size of a vein

* @param An int for the Number of chances available for the Block to spawn per-chunk

* @param An int for the minimum Y-Coordinate height at which this block may spawn

* @param An int for the maximum Y-Coordinate height at which this block may spawn

**/

public void addOreSpawn(Block block, World world, Random random, int blockXPos, int blockZPos, int maxX, int maxZ, int maxVeinSize, int chancesToSpawn, int minY, int maxY)

{

int maxPossY = minY + (maxY - 1);

assert maxY > minY: "The maximum Y must be greater than the Minimum Y";

assert maxX > 0 && maxX <= 16: "addOreSpawn: The Maximum X must be greater than 0 and less than 16";

assert minY > 0: "addOreSpawn: The Minimum Y must be greater than 0";

assert maxY < 256 && maxY > 0: "addOreSpawn: The Maximum Y must be less than 256 but greater than 0";

assert maxZ > 0 && maxZ <= 16: "addOreSpawn: The Maximum Z must be greater than 0 and less than 16";

int diffBtwnMinMaxY = maxY - minY;

for(int x = 0; x < chancesToSpawn; x++)

{

int posX = blockXPos + random.nextInt(maxX);

int posY = minY + random.nextInt(diffBtwnMinMaxY);

int posZ = blockZPos + random.nextInt(maxZ);

(new WorldGenMinable(block.blockID, maxVeinSize)).generate(world, random, posX, posY, posZ);

}

For overworld ore generation we have been using WorldGenMinable. However, that only works when you are generating in stone. This time you have to generate in nether rack so we will have to use a custom WorldGen file. I use a template file for this. That file looks like this.

package tutorial;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.util.MathHelper;

import net.minecraft.world.World;

import net.minecraft.world.gen.feature.WorldGenerator;

public class WorldGenNetherMinable extends WorldGenerator

{

/** The block ID of the ore to be placed using this generator. */

private int minableBlockId;

/** The number of blocks to generate. */

private int numberOfBlocks;

public WorldGenNetherMinable(int par1, int par2)

{

minableBlockId = par1;

numberOfBlocks = par2;

}

public boolean generate(World par1World, Random par2Random, int par3, int par4, int par5)

{

float f = par2Random.nextFloat() * (float)Math.PI;

double d = (float)(par3 + 8) + (MathHelper.sin(f) * (float)numberOfBlocks) / 8F;

double d1 = (float)(par3 + 8) - (MathHelper.sin(f) * (float)numberOfBlocks) / 8F;

double d2 = (float)(par5 + 8) + (MathHelper.cos(f) * (float)numberOfBlocks) / 8F;

double d3 = (float)(par5 + 8) - (MathHelper.cos(f) * (float)numberOfBlocks) / 8F;

double d4 = (par4 + par2Random.nextInt(3)) - 2;

double d5 = (par4 + par2Random.nextInt(3)) - 2;

for (int i = 0; i <= numberOfBlocks; i++)

{

double d6 = d + ((d1 - d) * (double)i) / (double)numberOfBlocks;

double d7 = d4 + ((d5 - d4) * (double)i) / (double)numberOfBlocks;

double d8 = d2 + ((d3 - d2) * (double)i) / (double)numberOfBlocks;

double d9 = (par2Random.nextDouble() * (double)numberOfBlocks) / 16D;

double d10 = (double)(MathHelper.sin(((float)i * (float)Math.PI) / (float)numberOfBlocks) + 1.0F) * d9 + 1.0D;

double d11 = (double)(MathHelper.sin(((float)i * (float)Math.PI) / (float)numberOfBlocks) + 1.0F) * d9 + 1.0D;

int j = MathHelper.floor_double(d6 - d10 / 2D);

int k = MathHelper.floor_double(d7 - d11 / 2D);

int l = MathHelper.floor_double(d8 - d10 / 2D);

int i1 = MathHelper.floor_double(d6 + d10 / 2D);

int j1 = MathHelper.floor_double(d7 + d11 / 2D);

int k1 = MathHelper.floor_double(d8 + d10 / 2D);

for (int l1 = j; l1 <= i1; l1++)

{

double d12 = (((double)l1 + 0.5D) - d6) / (d10 / 2D);

if (d12 * d12 >= 1.0D)

{

continue;

}

for (int i2 = k; i2 <= j1; i2++)

{

double d13 = (((double)i2 + 0.5D) - d7) / (d11 / 2D);

if (d12 * d12 + d13 * d13 >= 1.0D)

{

continue;

}

for (int j2 = l; j2 <= k1; j2++)

{

double d14 = (((double)j2 + 0.5D) - d8) / (d10 / 2D);

if (d12 * d12 + d13 * d13 + d14 * d14 < 1.0D && par1World.getBlockId(l1, i2, j2) == Block.netherrack.blockID)

{

par1World.setBlock(l1, i2, j2, minableBlockId);

}

return true;

}

Now to use this file you will have to add some code to the generateNether method. That code should look like this.

int Xcoord = x + random.nextInt(16);

int Ycoord = 10 + random.nextInt(128);

int Zcoord = z + random.nextInt(16);

(new WorldGenNetherMinable(Tutorial.tutorialBlock.blockID, 15)).generate(world, random, Xcoord, Ycoord, Zcoord);

This code does exactly the same as the addOreSpawn method. The only difference is that it uses WorldGenNetherMinable instead of WorldGenMinable. You can choose this code style for your overworld ores as well, but I prefer the method, because it can get really messy when you have several blocks.
The whole file should now look like this.

package tutorial;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.world.World;

import net.minecraft.world.chunk.IChunkProvider;

import net.minecraft.world.gen.feature.WorldGenMinable;

import cpw.mods.fml.common.IWorldGenerator;

public class EventManager implements IWorldGenerator

{

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

{

switch(world.provider.dimensionId)

{

case -1: generateNether(world, random, chunkX * 16, chunkZ * 16);

case 0: generateSurface(world, random, chunkX * 16, chunkZ * 16);

case 1: generateEnd(world, random, chunkX * 16, chunkZ * 16);

}

private void generateEnd(World world, Random random, int x, int z)

{

}

private void generateSurface(World world, Random random, int x, int z)

{

this.addOreSpawn(Tutorial.tutorialBlock, world, random, x, z, 16, 16, 4 + random.nextInt(3), 5, 15, 50);

}

private void generateNether(World world, Random random, int x, int z)

{

int Xcoord = x + random.nextInt(16);

int Ycoord = 10 + random.nextInt(128);

int Zcoord = z + random.nextInt(16);

(new WorldGenNetherMinable(Tutorial.tutorialBlock.blockID, 15)).generate(world, random, Xcoord, Ycoord, Zcoord);

}

/**

* Adds an Ore Spawn to Minecraft. Simply register all Ores to spawn with this method in your Generation method in your IWorldGeneration extending Class

* @param The Block to spawn

* @param The World to spawn in

* @param A Random object for retrieving random positions within the world to spawn the Block

* @param An int for passing the X-Coordinate for the Generation method

* @param An int for passing the Z-Coordinate for the Generation method

* @param An int for setting the maximum X-Coordinate values for spawning on the X-Axis on a Per-Chunk basis

* @param An int for setting the maximum Z-Coordinate values for spawning on the Z-Axis on a Per-Chunk basis

* @param An int for setting the maximum size of a vein

* @param An int for the Number of chances available for the Block to spawn per-chunk

* @param An int for the minimum Y-Coordinate height at which this block may spawn

* @param An int for the maximum Y-Coordinate height at which this block may spawn

**/

{

int maxPossY = minY + (maxY - 1);

assert maxY > minY: "The maximum Y must be greater than the Minimum Y";

assert maxX > 0 && maxX <= 16: "addOreSpawn: The Maximum X must be greater than 0 and less than 16";

assert minY > 0: "addOreSpawn: The Minimum Y must be greater than 0";

assert maxY < 256 && maxY > 0: "addOreSpawn: The Maximum Y must be less than 256 but greater than 0";

assert maxZ > 0 && maxZ <= 16: "addOreSpawn: The Maximum Z must be greater than 0 and less than 16";

int diffBtwnMinMaxY = maxY - minY;

for(int x = 0; x < chancesToSpawn; x++)

{

int posX = blockXPos + random.nextInt(maxX);

int posY = minY + random.nextInt(diffBtwnMinMaxY);

int posZ = blockZPos + random.nextInt(maxZ);

(new WorldGenMinable(block.blockID, maxVeinSize)).generate(world, random, posX, posY, posZ);

}

However, the nether ore for the tutorial block has metadata. That is why we have to make a little change to the WorldGenNetherMinable. The thing you need to do is add a new parameter to the constructor which is metadata. The constructor and variables above should then look like this.

/** The block ID of the ore to be placed using this generator. */

private int minableBlockId;

private int metadata;

/** The number of blocks to generate. */

private int numberOfBlocks;

public WorldGenNetherMinable(int par1, int par2, int par3)

{

minableBlockId = par1;

metadata = par2;

numberOfBlocks = par3;

}

Now we need to make sure that the metadata variable is used when placing the block. That is done by changing the par1World.setBlock line. That line has to look like this now.

par1World.setBlock(l1, i2, j2, minableBlockId, metadata, 2);

There are 2 new parameters in here. The first one being the metadata and the second being 2. You don't really have to understand the 2. It's just how the setBlock method works when you don't set a metadata or this value like you do here.
The whole file should now look like this.

package tutorial;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.util.MathHelper;

import net.minecraft.world.World;

import net.minecraft.world.gen.feature.WorldGenerator;

public class WorldGenNetherMinable extends WorldGenerator

{

/** The block ID of the ore to be placed using this generator. */

private int minableBlockId;

private int metadata;

/** The number of blocks to generate. */

private int numberOfBlocks;

public WorldGenNetherMinable(int par1, int par2, int par3)

{

minableBlockId = par1;

metadata = par2;

numberOfBlocks = par3;

}

public boolean generate(World par1World, Random par2Random, int par3, int par4, int par5)

{

float f = par2Random.nextFloat() * (float)Math.PI;

double d = (float)(par3 + 8) + (MathHelper.sin(f) * (float)numberOfBlocks) / 8F;

double d1 = (float)(par3 + 8) - (MathHelper.sin(f) * (float)numberOfBlocks) / 8F;

double d2 = (float)(par5 + 8) + (MathHelper.cos(f) * (float)numberOfBlocks) / 8F;

double d3 = (float)(par5 + 8) - (MathHelper.cos(f) * (float)numberOfBlocks) / 8F;

double d4 = (par4 + par2Random.nextInt(3)) - 2;

double d5 = (par4 + par2Random.nextInt(3)) - 2;

for (int i = 0; i <= numberOfBlocks; i++)

{

double d6 = d + ((d1 - d) * (double)i) / (double)numberOfBlocks;

double d7 = d4 + ((d5 - d4) * (double)i) / (double)numberOfBlocks;

double d8 = d2 + ((d3 - d2) * (double)i) / (double)numberOfBlocks;

double d9 = (par2Random.nextDouble() * (double)numberOfBlocks) / 16D;

double d10 = (double)(MathHelper.sin(((float)i * (float)Math.PI) / (float)numberOfBlocks) + 1.0F) * d9 + 1.0D;

double d11 = (double)(MathHelper.sin(((float)i * (float)Math.PI) / (float)numberOfBlocks) + 1.0F) * d9 + 1.0D;

int j = MathHelper.floor_double(d6 - d10 / 2D);

int k = MathHelper.floor_double(d7 - d11 / 2D);

int l = MathHelper.floor_double(d8 - d10 / 2D);

int i1 = MathHelper.floor_double(d6 + d10 / 2D);

int j1 = MathHelper.floor_double(d7 + d11 / 2D);

int k1 = MathHelper.floor_double(d8 + d10 / 2D);

for (int l1 = j; l1 <= i1; l1++)

{

double d12 = (((double)l1 + 0.5D) - d6) / (d10 / 2D);

if (d12 * d12 >= 1.0D)

{

continue;

}

for (int i2 = k; i2 <= j1; i2++)

{

double d13 = (((double)i2 + 0.5D) - d7) / (d11 / 2D);

if (d12 * d12 + d13 * d13 >= 1.0D)

{

continue;

}

for (int j2 = l; j2 <= k1; j2++)

{

double d14 = (((double)j2 + 0.5D) - d8) / (d10 / 2D);

if (d12 * d12 + d13 * d13 + d14 * d14 < 1.0D && par1World.getBlockId(l1, i2, j2) == Block.netherrack.blockID)

{

par1World.setBlock(l1, i2, j2, minableBlockId, metadata, 2);

}

return true;

}

Now you will get an error under the code in generateNether. To fix that add the metadata value in between the 2 already existing variables. That method should then look like this when you use a metadata of 1.

private void generateNether(World world, Random random, int x, int z)

{

int Xcoord = x + random.nextInt(16);

int Ycoord = 10 + random.nextInt(128);

int Zcoord = z + random.nextInt(16);

(new WorldGenNetherMinable(Tutorial.tutorialBlock.blockID, 1, 15)).generate(world, random, Xcoord, Ycoord, Zcoord);

}

Making your ores generate in the end is very much the same as in the nether. You just change netherrack into endstone and make sure you call the generation code for the end dimension and not for any other ones.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Overworld Ore Generation

2013-08-14T09:38:00.000-07:00

In this tutorial I'm going to show you how to add custom ore generation to the overworld. Some of the code for that is done in the mod file. This is the file I will start with.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.Init;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@Init

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

TutorialCrafting.addRecipes();

}

There are a couple of ways to add your ore to generation. In this tutorial I'm going to show the way I prefer it, but there are always other ways you can do it.
In my opinion the best way to do it is with an EventManager. A lot of things in Forge are done with events. If you want to see different kinds of events you should take a look at net.minecraftforge.event. In later tutorials I will show you how to use these events. Another way certain events are done is through interfaces. Those also contain methods that get run when the event happens. One of those events are for ore generation. However, most forge mods will contain more than just a single type of Event. That is why we won't be creating a different file for every single Event, but for all of them in one.

To do this you should create a file that will handle all the events. For the tutorial I'm going to call it EventManager. Then make an object of it in the mod file. You should register that object as a World Generator using this code.

GameRegistry.registerWorldGenerator(eventmanager);

And now the whole mod file should look like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.Init;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

EventManager eventmanager = new EventManager();

@Init

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

GameRegistry.registerWorldGenerator(eventmanager);

TutorialCrafting.addRecipes();

}

If you haven't created the EventManager file just yet you will get an error under registerWorldManager. If you did you will also get an error under there. To fix the error you will have to make the EventManager implement IWorldGenerator. Make sure you implement and not extend or it will give you errors. When you do that you need to import the file. After that you will get an error under EventManager which you can fix by adding the unimplemented methods. Then the file should look like this.

package tutorial;

import java.util.Random;

import net.minecraft.world.World;

import net.minecraft.world.chunk.IChunkProvider;

import cpw.mods.fml.common.IWorldGenerator;

public class EventManager implements IWorldGenerator

{

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

{

}

Almost every mod will have multiple ores to generate. There are quite a few lines of code you need to write so that is why we will make a method that will write all the code for you. The only thing you need to do is paste it in the file and call it with the block and locations you want it to generate. This is the method you can use for that.

/**

* Adds an Ore Spawn to Minecraft. Simply register all Ores to spawn with this method in your Generation method in your IWorldGeneration extending Class

* @param The Block to spawn

* @param The World to spawn in

* @param A Random object for retrieving random positions within the world to spawn the Block

* @param An int for passing the X-Coordinate for the Generation method

* @param An int for passing the Z-Coordinate for the Generation method

* @param An int for setting the maximum X-Coordinate values for spawning on the X-Axis on a Per-Chunk basis

* @param An int for setting the maximum Z-Coordinate values for spawning on the Z-Axis on a Per-Chunk basis

* @param An int for setting the maximum size of a vein

* @param An int for the Number of chances available for the Block to spawn per-chunk

* @param An int for the minimum Y-Coordinate height at which this block may spawn

* @param An int for the maximum Y-Coordinate height at which this block may spawn

**/

{

int maxPossY = minY + (maxY - 1);

assert maxY > minY: "The maximum Y must be greater than the Minimum Y";

assert maxX > 0 && maxX <= 16: "addOreSpawn: The Maximum X must be greater than 0 and less than 16";

assert minY > 0: "addOreSpawn: The Minimum Y must be greater than 0";

assert maxY < 256 && maxY > 0: "addOreSpawn: The Maximum Y must be less than 256 but greater than 0";

assert maxZ > 0 && maxZ <= 16: "addOreSpawn: The Maximum Z must be greater than 0 and less than 16";

int diffBtwnMinMaxY = maxY - minY;

for(int x = 0; x < chancesToSpawn; x++)

{

int posX = blockXPos + random.nextInt(maxX);

int posY = minY + random.nextInt(diffBtwnMinMaxY);

int posZ = blockZPos + random.nextInt(maxZ);

(new WorldGenMinable(block.blockID, maxVeinSize)).generate(world, random, posX, posY, posZ);

}

This method takes a lot of parameters and they are all explained in the comment above it. This method will use the vanilla WorldGenMinable and then use all of the variables you put in to generate the ore.
Now that we have a way to generate the ores there is one more thing we have to do before we can actually use it. When you are generating ores you usually only want it to generate in a single dimension. To make sure it only goes in one dimension you will have to add a switch and 3 methods to the file. One for each dimension. Once that is done the file should look like this.

package tutorial;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.world.World;

import net.minecraft.world.chunk.IChunkProvider;

import net.minecraft.world.gen.feature.WorldGenMinable;

import cpw.mods.fml.common.IWorldGenerator;

public class EventManager implements IWorldGenerator

{

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

{

switch(world.provider.dimensionId)

{

case -1: generateNether(world, random, chunkX * 16, chunkZ * 16);

case 0: generateSurface(world, random, chunkX * 16, chunkZ * 16);

case 1: generateEnd(world, random, chunkX * 16, chunkZ * 16);

}

private void generateEnd(World world, Random random, int x, int z)

{

}

private void generateSurface(World world, Random random, int x, int z)

{

}

private void generateNether(World world, Random random, int x, int z)

{

}

/**

* Adds an Ore Spawn to Minecraft. Simply register all Ores to spawn with this method in your Generation method in your IWorldGeneration extending Class

* @param The Block to spawn

* @param The World to spawn in

* @param A Random object for retrieving random positions within the world to spawn the Block

* @param An int for passing the X-Coordinate for the Generation method

* @param An int for passing the Z-Coordinate for the Generation method

* @param An int for setting the maximum X-Coordinate values for spawning on the X-Axis on a Per-Chunk basis

* @param An int for setting the maximum Z-Coordinate values for spawning on the Z-Axis on a Per-Chunk basis

* @param An int for setting the maximum size of a vein

* @param An int for the Number of chances available for the Block to spawn per-chunk

* @param An int for the minimum Y-Coordinate height at which this block may spawn

* @param An int for the maximum Y-Coordinate height at which this block may spawn

**/

{

int maxPossY = minY + (maxY - 1);

assert maxY > minY: "The maximum Y must be greater than the Minimum Y";

assert maxX > 0 && maxX <= 16: "addOreSpawn: The Maximum X must be greater than 0 and less than 16";

assert minY > 0: "addOreSpawn: The Minimum Y must be greater than 0";

assert maxY < 256 && maxY > 0: "addOreSpawn: The Maximum Y must be less than 256 but greater than 0";

assert maxZ > 0 && maxZ <= 16: "addOreSpawn: The Maximum Z must be greater than 0 and less than 16";

int diffBtwnMinMaxY = maxY - minY;

for(int x = 0; x < chancesToSpawn; x++)

{

int posX = blockXPos + random.nextInt(maxX);

int posY = minY + random.nextInt(diffBtwnMinMaxY);

int posZ = blockZPos + random.nextInt(maxZ);

(new WorldGenMinable(block.blockID, maxVeinSize)).generate(world, random, posX, posY, posZ);

}

So we now have a method to generate the ores and a separate method for each dimension to make sure it generate the ores in the right dimension. Of course if you don't want to generate ores in a certain dimension you can simply remove that part of the switch and remove the method.
Now we will have to call addOreSpawn in generateSurface which has to be done like this.

private void generateSurface(World world, Random random, int x, int z)

{

this.addOreSpawn(Tutorial.tutorialBlock, world, random, x, z, 16, 16, 4 + random.nextInt(3), 5, 15, 50);

}

A big part of the parameters in here have to be exactly the same. world, random, x and z can't be changed.
The first parameter is the block that will be generated.
The 2 16's make sure that the blocks can spawn in the whole chunk. If you want blocks to only generate in the first 5 blocks of a chunk for some reason you can change one of those variables.
The 8th variable is the size of the vein and the one after that is how many of the veins will be made in a single chunk. The last 2 variables are the lowest and the highest height those veins will appear.

The whole file should now look something like this.

package tutorial;

import java.util.Random;

import net.minecraft.block.Block;

import net.minecraft.world.World;

import net.minecraft.world.chunk.IChunkProvider;

import net.minecraft.world.gen.feature.WorldGenMinable;

import cpw.mods.fml.common.IWorldGenerator;

public class EventManager implements IWorldGenerator

{

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

{

switch(world.provider.dimensionId)

{

case -1: generateNether(world, random, chunkX * 16, chunkZ * 16);

case 0: generateSurface(world, random, chunkX * 16, chunkZ * 16);

case 1: generateEnd(world, random, chunkX * 16, chunkZ * 16);

}

private void generateEnd(World world, Random random, int x, int z)

{

}

private void generateSurface(World world, Random random, int x, int z)

{

this.addOreSpawn(Tutorial.tutorialBlock, world, random, x, z, 16, 16, 4 + random.nextInt(3), 5, 15, 50);

}

private void generateNether(World world, Random random, int x, int z)

{

}

/**

* Adds an Ore Spawn to Minecraft. Simply register all Ores to spawn with this method in your Generation method in your IWorldGeneration extending Class

* @param The Block to spawn

* @param The World to spawn in

* @param A Random object for retrieving random positions within the world to spawn the Block

* @param An int for passing the X-Coordinate for the Generation method

* @param An int for passing the Z-Coordinate for the Generation method

* @param An int for setting the maximum X-Coordinate values for spawning on the X-Axis on a Per-Chunk basis

* @param An int for setting the maximum Z-Coordinate values for spawning on the Z-Axis on a Per-Chunk basis

* @param An int for setting the maximum size of a vein

* @param An int for the Number of chances available for the Block to spawn per-chunk

* @param An int for the minimum Y-Coordinate height at which this block may spawn

* @param An int for the maximum Y-Coordinate height at which this block may spawn

**/

{

int maxPossY = minY + (maxY - 1);

assert maxY > minY: "The maximum Y must be greater than the Minimum Y";

assert maxX > 0 && maxX <= 16: "addOreSpawn: The Maximum X must be greater than 0 and less than 16";

assert minY > 0: "addOreSpawn: The Minimum Y must be greater than 0";

assert maxY < 256 && maxY > 0: "addOreSpawn: The Maximum Y must be less than 256 but greater than 0";

assert maxZ > 0 && maxZ <= 16: "addOreSpawn: The Maximum Z must be greater than 0 and less than 16";

int diffBtwnMinMaxY = maxY - minY;

for(int x = 0; x < chancesToSpawn; x++)

{

int posX = blockXPos + random.nextInt(maxX);

int posY = minY + random.nextInt(diffBtwnMinMaxY);

int posZ = blockZPos + random.nextInt(maxZ);

(new WorldGenMinable(block.blockID, maxVeinSize)).generate(world, random, posX, posY, posZ);

}

In the next tutorial I will show you how to add Ore generation to the nether.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Releasing a mod

2013-08-14T09:30:00.000-07:00

In this tutorial I'm going to show you how to release a mod. This is pretty hard to explain in text so you should watch this video.

This is a step by step guide if you for some reason can't watch the video.
1. Save all the files in Eclipse if it is open.
2. Go to your mcp folder.
3. Run recompile.bat or .sh
4. Run reobfuscate_srg
5. Go to the reobf folder in MCP
6. Make a zip of your mod folder which should be inside of the minecraft folder.
7. Add the textures from assets/yourmodname_yourname (so make sure there is a assets folder in the .zip) if you have any textures.
8. Add mcmod.info if you have one.
9. You are ready to go. Paste the .zip in the mods folder of a Minecraft with forge and it should work.

An example of a released mod with texture, code and mcmod.info here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Sided Textures

2013-08-14T04:39:00.001-07:00

In this tutorial I'm going to show you how to make a block that has different textures for the different sides of the block. For this tutorial I'm going to change one of the metadata's in the tutorial block to have a different texture, but it's pretty much the same for every Block. All the code for this is done in the Block file. This is the BlockTutorialBlock file I will start with.

package tutorial;

import java.util.List;

import net.minecraft.block.material.Material;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.ItemStack;

import net.minecraft.util.Icon;

import cpw.mods.fml.relauncher.Side;

import cpw.mods.fml.relauncher.SideOnly;

public class BlockTutorialBlock extends BlockGeneralTutorial

{

public BlockTutorialBlock(int id, Material par2Material)

{

super(id, par2Material);

}

@SideOnly(Side.CLIENT)

private Icon[] icons;

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

icons = new Icon[2];

for(int i = 0; i < icons.length; i++)

{

icons[i] = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)) + i);

}

@SideOnly(Side.CLIENT)

public Icon getIcon(int par1, int par2)

{

return icons[par2];

}

@SideOnly(Side.CLIENT)

public void getSubBlocks(int par1, CreativeTabs par2CreativeTabs, List par3List)

{

for(int i = 0; i < 2; i++)

{

par3List.add(new ItemStack(par1, 1, i));

}

Adding sided textures to a Block is really easy. First of you will need the Icon[] and change the registerIcons method a bit so that it registers for each index in the array, but we already have that for this block. The only thing we will have to change is the size of the Icon[]. For this tutorial I will go with 1 texture for the top, another for the bottom and a last one for the sides. The metadata I'm going to change is number 1.
So we now need 4 textures. 3 for metadata 1 and the other one for metadata 0. The names for the extra 2 textures are the same as the 2 we had already. It will be tutorialBlock2.png and tutorialBlock3.png.
Now we have 4 textures registering, but we are still using just the 2. To make sure that metadata 1 uses a different texture for each side we will have to change the getIcon method. First of you might want to change it into this.

@SideOnly(Side.CLIENT)

public Icon getIcon(int par1, int par2)

{

switch(par2)

{

case 0:

return icons[0];

case 1:

{

return icons[1];

}

default:

{

System.out.println("Invalid metadata for " + this.getUnlocalizedName());

return icons[0];

}

This does exactly the same as earlier, except for invalid metadata's. It used to crash with an invalid metadata which is not that bad, because you can't get the bad metadata. However, this is slightly better. It will print out to the console that there is a bad block and then run the code anyway.
Next up is to change case 1 to have different textures for each side. GetIcon has 2 parameters. The second one is the metadata and the first one is the side. icons[1] will be the bottom
Each side of a block in Minecraft has a number. The bottom is 0, the top is 1 and the other sides go from 2-5.
So when we want a different texture for the top, bottom and all the sides together it has to look something like this.

@SideOnly(Side.CLIENT)

public Icon getIcon(int par1, int par2)

{

switch(par2)

{

case 0:

return icons[0];

case 1:

{

switch(par1)

{

case 0:

return icons[1];

case 1:

return icons[2];

default:

return icons[3];

}

default:

{

System.out.println("Invalid metadata for " + this.getUnlocalizedName());

return icons[0];

}

The way this method works is that it will first look at the metadata. If it is 0 it will just return icons[0] for each side. When it is 1 it will take a look at the sides. If it is the bottom (case 0) it will return icons[1] and the top will get icons[2]. In the case that the side requesting the texture isn't the top or the bottom it will go to default which is icons[3]. If for some reason the metadata is invalid it will print that to the console and return icons[0] to prevent a crash.
The whole file should now look like this.

package tutorial;

import java.util.List;

import net.minecraft.block.material.Material;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.ItemStack;

import net.minecraft.util.Icon;

import cpw.mods.fml.relauncher.Side;

import cpw.mods.fml.relauncher.SideOnly;

public class BlockTutorialBlock extends BlockGeneralTutorial

{

public BlockTutorialBlock(int id, Material par2Material)

{

super(id, par2Material);

}

@SideOnly(Side.CLIENT)

private Icon[] icons;

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

icons = new Icon[4];

for(int i = 0; i < icons.length; i++)

{

icons[i] = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)) + i);

}

@SideOnly(Side.CLIENT)

public Icon getIcon(int par1, int par2)

{

switch(par2)

{

case 0:

return icons[0];

case 1:

{

switch(par1)

{

case 0:

return icons[1];

case 1:

return icons[2];

default:

return icons[3];

}

default:

{

System.out.println("Invalid metadata for " + this.getUnlocalizedName());

return icons[0];

}

@SideOnly(Side.CLIENT)

public void getSubBlocks(int par1, CreativeTabs par2CreativeTabs, List par3List)

{

for(int i = 0; i < 2; i++)

{

par3List.add(new ItemStack(par1, 1, i));

}

The only difference between doing this for a metadata block and a non metadata block is that you don't have the metadata (par2) switch first. You can simply use just the par1 switch. The code for Icon registry and the icon[] is the same.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Metadata Blocks

2013-08-13T04:43:00.001-07:00

In this tutorial I'm going to show you how to add metadata to a block. This can be useful when you have a lot of blocks that are mostly the same, like ores, and you don't want your mod to take up too many ids. To change a normal block into a metadata Block you will have to change the mod file, block file and also add a new file that handles the metadata for the Block. This is the mod file I will start with.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.Init;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@Init

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + tutorialBlock.getUnlocalizedName2());

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

TutorialCrafting.addRecipes();

}

And this is the Block file.

package tutorial;

import net.minecraft.block.material.Material;

public class BlockTutorialBlock extends BlockGeneralTutorial

{

public BlockTutorialBlock(int id, Material par2Material)

{

super(id, par2Material);

}

So when you are going to add metadata to your Block there are some things you have to take care of. First of you will need to make different names for your blocks. Then you also need to get different textures for both, make them both show up in the menus and make sure the right metadata gets placed when you use the block.
We will start with different names for the metadatas. It's very simple to do this. You have to replace the LanguageRegistry line with something like this.

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

The code is pretty much the same, but instead of using the Block or Item you use an ItemStack. Then in the ItemStack you use the Block or Item you want with a stack size of 1 and then the metadata of the Block or Item. Even though you only set the name for a stack size of one it will work for every size.

Next up we are going to make sure that the block has different textures for each metadata.
To make different textures for metadata blocks you will have to add quite some new code. Normally you used the blockIcon variable in Block, but you can't now since there are multiple Icons for the Block. To fix that you will have to make an Icon array. Also make sure that it is Client side only.
Since you now need multiple Icons you will also have to register multiple ones. That is why you will have to make the Icon[] the size of the amount of metadata blocks you are going to have. Then you need to make a for loop that cycles through the size of the Icon[] and registers the Icon. The code should look something like this.

@SideOnly(Side.CLIENT)

private Icon[] icons;

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

icons = new Icon[2];

for(int i = 0; i < icons.length; i++)

{

icons[i] = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)) + i);

}

So first you create a Client only icons variable. Then in the normal registerIcons method you set the Icons array to the amount of metadata blocks you will have. After that a simple for loop with int i that keeps going untill it is larger than the icon length. Then you set the icon at position i of the Icon array to the registered Icon. Most of the register code is the same except for that you have to add the i add the end. You need to do that to make sure you can use multiple images. The image for metadata 0 should be called: "unlocalizedname0" then metadata 1 should be "unlocalizedname1" etc.
Right now you have to set the right icon for the metadata. Do that with this method.

@SideOnly(Side.CLIENT)

public Icon getIcon(int par1, int par2)

{

return icons[par2];

}

Now it will return the icon in the Icon arrray at the metadata value. This means that when you have a block of metadata 0 it will return the Icon at icons[0] which should be "unlocalizedname0" for one it is the same, but with number 1 instead of 0.
If you were to start the game right now you will still only see 1 Block in the creative inventory. To fix this problem you will have to add this method to the Block file.

@SideOnly(Side.CLIENT)

public void getSubBlocks(int par1, CreativeTabs par2CreativeTabs, List par3List)

{

for (int var4 = 0; var4 < 2; ++var4)

{

par3List.add(new ItemStack(par1, 1, var4));

}

This method will add an ItemStack with the Block id, size 1 and metadata of var4 to the Creative tab list. Since var4 can be 0 and 1 it will add both of those metadatas to the Creative tab.
There is one last method you will have to add to the Block file to make sure that the metadata dropped is the metadata the block has. The method you need for that looks like this.

public int damageDropped(int par1)

{

return par1;

}

This simply gets the metadata of the block that is being dropped and will drop that metadata.
The Block file should now look like this.

package tutorial;

import java.util.List;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.ItemStack;

import net.minecraft.util.Icon;

import cpw.mods.fml.relauncher.Side;

import cpw.mods.fml.relauncher.SideOnly;

public class BlockTutorialBlock extends Block

{

public BlockTutorialBlock(int id, Material material)

{

super(id, material);

this.setCreativeTab(CreativeTabs.tabBlock);

}

public int damageDropped(int par1)

{

return par1;

}

@SideOnly(Side.CLIENT)

private Icon[] icons;

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

icons = new Icon[4];

for(int i = 0; i < icons.length; i++)

{

icons[i] = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)) + i);

}

@SideOnly(Side.CLIENT)

public Icon getIcon(int par1, int par2)

{

switch(par2)

{

case 0:

return icons[0];

case 1:

{

switch(par1)

{

case 0:

return icons[1];

case 1:

return icons[2];

default:

return icons[3];

}

default:

{

System.out.println("Invalid metadata for " + this.getUnlocalizedName());

return icons[0];

}

@SideOnly(Side.CLIENT)

public void getSubBlocks(int par1, CreativeTabs par2CreativeTabs, List par3List)

{

for(int i = 0; i < 2; i++)

{

par3List.add(new ItemStack(par1, 1, i));

}

So right now you may think you have taken care of everything. However, there is still one very big problem. When you place metadata 1 of the Block it will actually still use metadata 0. To fix that you will have to make a small change to the mod file and add a new file. The method you have to change is the registerBlock method. Once changed it should look like this.

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

As you can see there is one new parameter in this method. It is the ItemTutorialBlock.class. The mod file should now look something like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.Init;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@Init

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, ItemTutorialBlock.class, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 0), "Tutorial Block");

LanguageRegistry.addName(new ItemStack(tutorialBlock, 1, 1), "Nether Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorialItem");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

TutorialCrafting.addRecipes();

}

When you add this to your code you will get an error under that, because you haven't made the file yet. To do that hover your mouse over it and create the class. Now make sure the file extends ItemBlock.
The file should look something like this.

package tutorial;

import net.minecraft.item.ItemBlock;

public class ItemTutorialBlock extends ItemBlock

{

}

When you have this you will get an error under ItemTutorialBlock which tells you to add a constructor.
Let Eclipse make the constructor by hovering over it and selecting the add constructor option. Now in there you will have to add one line after the super(par1); which is setHasSubtypes(true); This will make sure that it can have multiple metadata values.
As you may know Minecraft will start screwing up when there are 2 Items or Blocks with the same Unlocalized name. That is why you should add a method like this to the Item file.

public String getUnlocalizedName(ItemStack itemstack)

{

String name = "";

switch(itemstack.getItemDamage())

{

case 0:

{

name = "world";

break;

}

case 1:

{

name = "nether";

break;

}

default: name = "broken";

}

return getUnlocalizedName() + "." + name;

}

If the metadata is 0 it will add world behind the unlocalized name. For metadata it is nether. If for some reason the metadata is above 1 it will just add broken making sure it doesn't crash.
So now you have taken care of pretty much everything for your metadata Block. There is just one last method you will have to add which has to be exactly the same as this one.

public int getMetadata(int par1)

{

return par1;

}

The whole ItemTutorialBlock file should now look like this.

package tutorial;

import net.minecraft.item.ItemBlock;

import net.minecraft.item.ItemStack;

public class ItemTutorialBlock extends ItemBlock

{

public ItemTutorialBlock(int par1)

{

super(par1);

setHasSubtypes(true);

}

public String getUnlocalizedName(ItemStack itemstack)

{

String name = "";

switch(itemstack.getItemDamage())

{

case 0:

{

name = "world";

break;

}

case 1:

{

name = "nether";

break;

}

default: name = "broken";

}

return getUnlocalizedName() + "." + name;

}

public int getMetadata(int par1)

{

return par1;

}

Now you have a fully working metadata Block in your mod. In the next tutorial I will show you sided textures.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Custom Item Texture

2013-08-12T05:03:00.001-07:00

In this tutorial I will show you how to add custom textures to your item. All of the code for this tutorial is done in the Item file. This is the file I will start with.

package tutorial;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.Item;

public class ItemTutorial extends Item

{

public ItemTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabMaterials);

}

The first thing you will have to do before you can add the texture to the item is to actually make the texture and make sure it is saved correctly etc.
To do this you will have to make a 16x16 sprite for the Item. I'm not going into detail about this, because I'm no artist. However, I use GIMP to make the textures I use.
The next part is saving the file. I know much more about that, so this is what you will have to do. For an item you need to make sure that the name for the file is: unlocalizedname.png
Then there is also the part where you need to make sure that it is in the right folder. In the newest versions of Forge for 1.6 Forge will load the images for you. You don't have to add any code for that like you used to in earlier versions. However, because this is automated you also have to follow a couple of rules for the folder structure where you will have to save the images. This structure goes like this.
mods/[modid]/textures/items/Image.png
Make sure that everything is also lower case or you will get errors.
If you follow these rules you should be able to assign a texture to your item quite easily.

Now to get those textures to load in MCP you will have to open the forge folder where you have mcp installed in. Then enter the mcp folder and then the jars folder in there. When you are there you should be able to find the Minecraft.jar. In here you will have to paste the complete folder structure.
When you have done that your textures will be loaded in for you by Forge. The next part is to actually use them in your item. To do this you will have to add this one simple method.

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

this.itemIcon = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)));

}

The only thing you have to change in here is Tutorial into whatever your mod file name is. Then your textures should load just fine in the game.
The whole file should now look like this.

package tutorial;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.Item;

public class ItemTutorial extends Item

{

public ItemTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabMaterials);

}

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

this.itemIcon = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)));

}

This method simply sets the iconIndex, which is the Icon used to render the item, to an Image located in the folder structure you made earlier. par1IconRegister.registerIcon is the method that loads this image.
In the next Item tutorials there will be more customization for the items.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Custom Block Texture

2013-08-11T10:06:00.002-07:00

In this tutorial I will show you how to add custom textures to your block. All of the code for this tutorial is done in the Block file. This is the file I will start with.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.creativetab.CreativeTabs;

public class BlockTutorialBlock extends Block

{

public BlockTutorialBlock(int id, Material par2Material)

{

super(id, par2Material);

this.setCreativeTab(CreativeTabs.tabBlock);

}

The first thing you will have to do before you can add the texture to the block is to actually make the texture and make sure it is saved correctly etc.
To do this you will have to make a 16x16 sprite for the Block. I'm not going into detail about this, because I'm not an artist. However, I use GIMP to make the textures I use.
The next part is saving the file. I know much more about that, so this is what you will have to do. For a block you need to make sure that the name for the file is your unlocalized block name.png.
Then there is also the part where you need to make sure that it is in the right folder. In the newest versions of Forge for 1.6 Forge will load the images for you. You don't have to add any code for that like you used to in earlier versions. However, because this is automated you also have to follow a couple of rules for the folder structure where you will have to save the images. This structure goes like this.
assets/[modid]/textures/blocks/Image.png
Make sure that everything is also lower case or you will get errors.
If you follow these rules you should be able to assign a texture to your block quite easily.

Now to get those textures to load in MCP you will have to get to forge/mcp/src/minecraft and paste the assets folder in there. When you are there you should be able to find the Minecraft.jar. In here you will have to paste the complete folder structure.
When you have done that your textures will be loaded in for you by Forge. The next part is to actually use them in your blocks. To do this you will have to add this one simple method.

@SideOnly(Side.CLIENT)
public void registerIcons(IconRegister par1IconRegister)

{

this.blockIcon = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)));

}

The only thing you have to change in here is Tutorial into whatever your mod file name is. Then your textures should load just fine in the game.
The whole file should now look like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.client.renderer.texture.IconRegister;

import net.minecraft.creativetab.CreativeTabs;

public class BlockTutorialBlock extends Block

{

public BlockTutorialBlock(int id, Material par2Material)

{

super(id, par2Material);

this.setCreativeTab(CreativeTabs.tabBlock);

}

@SideOnly(Side.CLIENT)

public void registerIcons(IconRegister par1IconRegister)

{

this.blockIcon = par1IconRegister.registerIcon(Tutorial.modid + ":" + (this.getUnlocalizedName().substring(5)));

}

This method simply sets the blockIcon which is the Icon used to render the block to an Image located in the folder structure you made earlier. par1IconRegister.registerIcon is the method that loads this image.
In the next Block tutorials there will be more customization for the blocks.

You can download the source code and the assets folder over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Recipes

2013-08-09T05:55:00.000-07:00

In this tutorial I'm going to show you how to add custom recipes to your mod. All of the code for this tutorial is done in the mod file. This is the file I will start with.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorial");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

}

There are 3 types of Recipes in Minecraft. Number one is a Shapeless Recipe, used to craft for example bonemeal from bones. The second is a Shaped or normal Recipe. Those are used to craft things like pickaxes etc. The last type of recipe is a smelting recipe.
The first Recipe I will show you is a Shapeless Recipe. This is the code used for one.

GameRegistry.addShapelessRecipe(new ItemStack(tutorialBlock), new Object[]{

new ItemStack(Item.diamond), new ItemStack(Block.stone), new ItemStack(Item.dyePowder, 1, 15)

});

This code goes into your load method. It looks pretty complicated, but it is actually pretty easy.
addShapelessRecipes is a method inside of GameRegistry. It takes 2 parameters. Number 1 is the returned Item or Block from the recipe. The second parameter is an Object array to get the shape of the recipe.
ItemStack() has 3 parameters. The first parameter is the item or block used. The second parameter is the stack size and the last one is the metadata of the Item or Block. This is the same for every single ItemStack everywhere in the coming code.
Make sure you don't forget the comma's in between the ItemStacks.
The things you add in the Object array are the things used for the recipe. It now uses a diamond a stone block and bonemeal to create one tutorialBlock. You can put the 3 items in any shape or form in the crafting table. If you don't want that, but you want it to have a set shape you need a (Shaped)Recipe.
The code for a shaped recipe is quite a bit the same. It looks like this.

GameRegistry.addRecipe(new ItemStack(tutorialBlock), new Object[]{

"XZX",

"CXC",

'X', Item.ingotGold, 'C', Block.stone, 'Z', new ItemStack(Item.dyePowder, 1, 15)

});

Instead of addShapelessRecipe you use addRecipe. The other difference is in the Object array.
The thing in here is that you have "XZX, "CXC". This is the shape of the recipe used. The 3 letters are a code for an item, block or Itemstack. The letters are set to something below. X is a golden ingot, C is stone and Z is bonemeal. Right now this recipe uses 2 lines of the crafting table and you can use the top 2, but also the bottom 2 rows in the table to craft the recipe. You don't have to add anything for that. If you want to use a 3x3 recipe instead of a 3x2 you just add one more "CCC" below the "CXC". Make sure you don't forget the comma's. Those are important in the recipes. There is always one after every crafting table line, every letter and item, block or itemstack.

A lot of mods want or are already using enchantments in their crafting code. This is how you do that.

ItemStack enchanted = new ItemStack(Item.pickaxeStone);

enchanted.addEnchantment(Enchantment.sharpness, 2);

GameRegistry.addShapelessRecipe(enchanted, new Object[]{

new ItemStack(Item.pickaxeStone), new ItemStack(Item.flint), new ItemStack(tutorialBlock)

});

What you do here is create an ItemStack variable with any name. In this case enchanted. Then you set this variable to an ItemStack like you would normally. Then you use enchanted.addEnchantment() to add the enchantment to the item. The first parameter is the enchantment type. The second is the level of it.
Now you can simply use this variable like any other ItemStack in the crafting recipe as shown in the code above.

The last type of recipe is a smelting recipe. This is the code you need for that.

FurnaceRecipes.smelting().addSmelting(Item.beefCooked.itemID, 0, new ItemStack(tutorialItem), 0.1F);

FurnaceRecipes is the file that contains all the recipes that you can use in Minecraft for the Furnace. .smelting() is a method that returns an instance of that file. With that you can acces non-static methods in there. addSmelting is one of those methods. It takes 4 parameters.
The first paramter is an item or block id which will be the input thing. You can change an Item into a number by adding itemID behind it. Same for a Block. Simply add .blockID.
The second parameter is the metadata for the input item.
The third parameter is an ItemStack which you can use like any other ItemStack which means it can have metadata, size, enchantments etc.
The last parameter is the Xp value you get from smelting. 0.1F is what you get from cobblestone. 1F is for diamond ore.
Now the mod file should look something like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.enchantment.Enchantment;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraft.item.crafting.FurnaceRecipes;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorial");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

GameRegistry.addShapelessRecipe(new ItemStack(tutorialBlock), new Object[]{

new ItemStack(Item.diamond), new ItemStack(Block.stone), new ItemStack(Item.dyePowder, 1, 15)

});

GameRegistry.addRecipe(new ItemStack(tutorialBlock), new Object[]{

"XZX",

"CXC",

'X', Item.ingotGold, 'C', Block.stone, 'Z', new ItemStack(Item.dyePowder, 1, 15)

});

ItemStack enchanted = new ItemStack(Item.pickaxeStone);

enchanted.addEnchantment(Enchantment.sharpness, 2);

GameRegistry.addShapelessRecipe(enchanted, new Object[]{

new ItemStack(Item.pickaxeStone), new ItemStack(Item.flint), new ItemStack(tutorialBlock)

});

FurnaceRecipes.smelting().addSmelting(Item.beefCooked.itemID, 0, new ItemStack(tutorialItem), 0.1F);

}

Obviously this gets very big very fast. That is why most mods are using a serparate file to add the Recipes. To add that to your own mod you need something like this in the load method.

TutorialCrafting.addRecipes();

TutorialCrafting is the file that will contain the recipes for me, but it can have any name. addRecipes() is the method that will actually have the code that registers the Recipe, but also this can have any name you want.
Now you have an error under TutorialCrafting. To fix it hover your mouse over it and create the class. Then you will get an error under addRecipes. To fix that one you need to hover your mouse over there and select add method.
Then you have to copy over all the recipes you have in the mod file and paste them in that method. When you do that you will get errors under every Item and Block you use from your own mod. To fix that you will have to add your mod file name before it. For me it's tutorial. The TutorialCrafting file should look something like this now.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.enchantment.Enchantment;

import net.minecraft.item.Item;

import net.minecraft.item.ItemStack;

import net.minecraft.item.crafting.FurnaceRecipes;

import cpw.mods.fml.common.registry.GameRegistry;

public class TutorialCrafting

{

public static void addRecipes()

{

GameRegistry.addShapelessRecipe(new ItemStack(Tutorial.tutorialBlock), new Object[]{

new ItemStack(Item.diamond), new ItemStack(Block.stone), new ItemStack(Item.dyePowder, 1, 15)

});

GameRegistry.addRecipe(new ItemStack(Tutorial.tutorialBlock), new Object[]{

"XZX",

"CXC",

'X', Item.ingotGold, 'C', Block.stone, 'Z', new ItemStack(Item.dyePowder, 1, 15)

});

ItemStack enchanted = new ItemStack(Item.pickaxeStone);

enchanted.addEnchantment(Enchantment.sharpness, 2);

GameRegistry.addShapelessRecipe(enchanted, new Object[]{

new ItemStack(Item.pickaxeStone), new ItemStack(Item.flint), new ItemStack(Tutorial.tutorialBlock)

});

FurnaceRecipes.smelting().addSmelting(Item.beefCooked.itemID, 0, new ItemStack(Tutorial.tutorialItem), 0.1F);

}

And now the mod file looks like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + (tutorialBlock.getUnlocalizedName().substring(5)));

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorial");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

TutorialCrafting.addRecipes();

}

This makes it look a lot better and easier to read. You can do the same technique for registering blocks, items etc. in other files, but I don't feel like that is required in most of the smaller to medium sized mods.

You can download the source code over here.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Basic Item Part 2

2013-08-09T05:09:00.000-07:00

In this tutorial I will show you how to create the Item file for your basic Item. I will start in the mod file. This is the file I will start with.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + tutorialBlock.getUnlocalizedName2());

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorial");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

}

To create your Item file simply hover your mouse over the ItemTutorial and click Create Class. When you do that you will get a file just like this one.

package tutorial;

public class ItemTutorial {

}

The first thing you need to do in here is make it extend Item. Do that by adding extends Item behind the class name. You will get an error under Item which can be fixed by importing the file.
Once you have imported it you will get an error under your file name. To fix that one you will have to hover your mouse over the filename and select add Constructor. You will now have a file that looks like this.

package tutorial;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.Item;

public class ItemTutorial extends Item

{

public ItemTutorial(int id)

{

super(id);

}

Now simply remove the comment change par1 into id for clarity and your basic Item is done.
One thing I suggest to add is a creative tab location. To do that you will have to add this one line of code to the constructor.

this.setCreativeTab(CreativeTabs.tabMaterials);

The thing inside of the brackets is the tab it will be shown on.
To do this you will also have to import CreativeTabs.

Now the file should look like this.

package tutorial;

import net.minecraft.creativetab.CreativeTabs;

import net.minecraft.item.Item;

public class ItemTutorial extends Item

{

public ItemTutorial(int id)

{

super(id);

this.setCreativeTab(CreativeTabs.tabMaterials);

}

You can download the source code over here.

In the next tutorials I will show you how to set a custom Image for the Item. There will also be special uses and other features for items.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Basic Item Part 1

2013-08-09T04:56:00.000-07:00

In this tutorial I will show you how to add a basic Item to Minecraft. In the first tutorial I will explain all the code you need in the mod file. The second tutorial will be about the Item file.
This is the mod file I will start with.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + tutorialBlock.getUnlocalizedName2());

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

}

The first line of code you will have to add to your mod file looks like this.

public static Item tutorialItem;

This line has to be added below the CommonProxy line and above the @Init line. When you add it you will get an error under Item. To fix that Press Ctrl, Shift, O and select the net.minecraft.item.Item import, or you can add this line of code to the file yourself above the @Mod line.

import net.minecraft.item.Item;

Now inside of the load method you have to add a line like this one.

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorial");

The first thing you put in this line is the item variable name you created earlier. What you set it equal to is the file where you will put a lot of information for the item. Inside of the brackets behind ItemTutorial is the Id for the item. I suggest keeping this somewhere above 4096.
.setUnlocalizedName("tutorial") simply sets a name for the item. It isn't really used in the code, but you have to get a different one for every item or you will get strange errors. I suggest keeping it the same as the variable name.

There is one last line of code that you have to add to the mod file. It should be similar to the one below.

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

This line of code will simply make sure that your tutorialItem will get the name Tutorial Item inside of the game. The first parameter is always the item and the second one the name in game.
You will also have to import LanguageRegistry just like you did earlier.
The whole file should now look something like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.item.Item;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

public static Item tutorialItem;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + tutorialBlock.getUnlocalizedName2());

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

tutorialItem = new ItemTutorial(5000).setUnlocalizedName("tutorial");

LanguageRegistry.addName(tutorialItem, "Tutorial Item");

}

Right now you will have an error under ItemTutorial. We will fix that in the next tutorial.
The tutorial source code will be available at the last part of the basic item tutorials.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Basic Block Part 2

2013-08-09T00:12:00.000-07:00

In this tutorial I will show you how to make the Block file that you will need to add a basic Block to minecraft. This is the code in the mod file from the last tutorial.

package tutorial;

import net.minecraft.block.Block;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + tutorialBlock.getUnlocalizedName2());

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

}

In this tutorial all you don't have to do anything in the mod file. Just click on the package of this mod or hover your mouse over the BlockTutorialBlock error and create a class with that name.
When you create the file it will probably look like this.

package tutorial;

public class BlockTutorialBlock {

}

The first thing that you will have to do is make BlockTutorialBlock extend Block. Do this by adding this to the file.

package tutorial;

import net.minecraft.block.Block;

public class BlockTutorialBlock extends Block

{

}

When you do this you will get an error under BlockTutorialBlock. To fix this you will have to add this method.

public BlockTutorialBlock(int id, Material par2Material)

{

super(id, par2Material);

}

You need to make sure that the method is public FileName and that it contains 1 integer and 1 Material inside of the brackets. You can change the names of those 2 variables into anything you want, but the names they have right now are their functions.
The line inside of the method with super tells the Block file what the id of the block is. It also tells Block which kind of material it is made out of. In this case the material is rock. Making it minable by certain items, but not with others. Material can also add some other interesting properties like making it impossible to be moved by a piston, but that doesn't count for cloth. To find out all the materials go to the Material file.

Another line that you might want to add is on which creative tab in the creative menu it should be shown. To do this you have to add this line inside of the method.

this.setCreativeTab(CreativeTabs.tabBlock);

CreativeTabs is the file that contains all the tabs from the creative inventory and tabBlock is the one you start out in when you open up the inventory on creative mode.

The whole file should now look like this.

package tutorial;

import net.minecraft.block.Block;

import net.minecraft.block.material.Material;

import net.minecraft.creativetab.CreativeTabs;

public class BlockTutorialBlock extends Block

{

public BlockTutorialBlock(int id, Material par2Material)

{

super(id, par2Material);

this.setCreativeTab(CreativeTabs.tabBlock);

}

You can download the source code over here.
In the next tutorials I will show you how to add some special settings to a block like being able to walk through it etc.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Basic Block Part 1

2013-08-08T10:32:00.002-07:00

In this tutorial I will show you how to add your first basic block to Minecraft. A part of this code is done in the mod file. This is the file I will start with.

package tutorial;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

@Eventhandler

public void load(FMLInitializationEvent event)

{

}

The first line you have to add for a block is this.

public static Block tutorialBlock;

You will also have to import net.minecraft.src.Block. Do this by pressing Ctrl, Shift, O or by hovering your mouse over the error under block and clicking the import net.minecraft.src.Block fix option.
This line has to be placed inside of the class so past the bracket below Tutorial. It also has te be above the @Init.
This line will add a Block variable called tutorialBlock to the mod file. It is public and static so that means that any class can acces it by using Tutorial.tutorialBlock. Right now tutorialBlock is set to nothing so that is what you will have to add next.

To set tutorialBlock to something you have to add this line.

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

This line has to be inside of the load method.
What this does is it sets tutorialBlock to BlockTutorialBlock which is a new file that we are going to create in the next part of this tutorial. The number inside the brackets is the id of the block.
The second parameter is the Material for the block. You can see other materials by going to the Material file. Materials set some important settings for your block like which tools are required etc.
.setUnlocalizedName() sets the name of the block. It is smart to keep the name exactly the same as the block variable name. It will not crash if you don't, but it might give you some strange errors if you don't.
Right know you will have an error under BlockTutorialBlock. This is because you are calling a file that isn't there. We will be creating this file in the next part of this tutorial.
You might be thinking why I didn't just do both of those things on one line. This is because you can have configurable block id's when you write it this way. Configurable block id's will also be in a later tutorial.

There are 2 more lines that you will have to add. The first is to let Forge know that tutorialBlock is a Block. To do that you have to add this inside of the load method.

GameRegistry.registerBlock(tutorialBlock, modid + tutorialBlock.getUnlocalizedName().substring(5));

The first parameter in this method is the Block you are registering. The second parameter in here is an unique String for your block. The easiest thing to do is use the modid variable in combination with the unlocalized name for the block. you need to use getUnlocalizedName().substring(5) because minecraft adds 5 characters in front of the block name which you don't want.
The last line you have to add is this.

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

This line adds the name behind the comma and inside of the quotation marks to the variable before the comma. This name will be displayed when you hover your mouse over the block in your inventory.

The whole file should now look like this.

package tutorial;

import net.minecraft.block.Block;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

import cpw.mods.fml.common.registry.GameRegistry;

import cpw.mods.fml.common.registry.LanguageRegistry;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

public static Block tutorialBlock;

@EventHandler

public void load(FMLInitializationEvent event)

{

tutorialBlock = new BlockTutorialBlock(500, Material.rock).setUnlocalizedName("tutorialBlock");

GameRegistry.registerBlock(tutorialBlock, modid + tutorialBlock.getUnlocalizedName().substring(5));

LanguageRegistry.addName(tutorialBlock, "Tutorial Block");

}

This is everything you have to add to your mod file to make a good block. In the next tutorial I will show you how to create the block file.

The tutorial source code will be available at the last part of the basic block tutorials.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Basic File

2013-08-08T10:10:00.001-07:00

In this tutorial I will show you how to create your very first basic file that you will need before you can add anything to the game.
The first thing that you will have to do is create a new package inside of the src folder in eclipse. Do this by right clicking on the src folder and clicking new Package. When you click that a window will pop up that asks you for the package name. The name could be anything, but it is smart to give it a name like this one:
tutorial
So just the name of your mod.
Now select the package and right click again. This time click new Class. Again a window will pop up telling you that you need to give it a name. The file you are going to create right now is the mod file. It will contain the most important information about your mod. It will contain recipes, blocks, items and much more. I suggest giving this file the name of your mod.
When you create the file it should look something like this.

package tutorial;

public class Tutorial {

}

The first thing you will have to add must be placed above the public class Tutorial line. It should be something like this.

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

The first thing inside of the quotation marks is the mod id of your mod. This has to be unique for every single mod or it will crash. Right now you will have an error under modid. That is because you are trying to acces a variable you haven't made just yet. We will do that in just a second.
The second thing inside of the brackets is the mod name. This will show up inside of the Minecraft client.
The third and last thing is the version number. This one will as well show up inside of the Minecraft client.
You will probably get some errors right now under @Mod. To fix this press Ctrl, Shift, O. It should add this line to your file just below the line with the package.

import cpw.mods.fml.common.Mod;

If it does not import it you will have to typ it yourself.
Now you should make the variable, by adding this one line between the brackets just after Tutorial.

public static final String modid = "YourName_ModName";

To get this in your mod you have to keep everything the same except for the thing between the quotation marks. In here you add your name and your mod name.
The second line that you need to add goes right between the @Mod line and the public class line. It should look exactly like this one.

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

This line will make sure that people using this mod can connect to servers that don't have it and that they can't connect to servers that have it when they don't. You need to have it this way or it will crash your mod when you try to connect to a server.
Once again you will get an error under @NetworkMod. Again you have to press Ctrl, Shift, O. And if that still doesn't work you have to add this line inside of your file.

import cpw.mods.fml.common.network.NetworkMod;

Now the whole file should look like this.

package tutorial;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.network.NetworkMod;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

}

One thing that you should notice is that I moved the bracket behind Tutorial to a line lower. This is because I don't like the bracket there. That is completely my own style of coding and you don't have to copy that exactly. There are a lot of coding styles that you can use and none of them is the best. Your style should simply be the way you can read code the easiest.
The next thing you have to add is this.

@EventHandler

public void load(FMLInitializationEvent event)

{

}

This has to be added inside of the brackets below the public class Tutorial line. The public void load() is the first method in your mod. A method is a piece of the code that can be called from outside. The @EventHandler above makes sure that forge will call it during the Init phase of start-up.
Inside of this method will be most of the code for your mod. It is a very important method and it will become very big.
You might get errors under @EventHandler and inside of the load brackets. Fix it by pressing Crtl, Shift, O or by adding these 2 lines.

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

The whole file should now look like this.

package tutorial;

import cpw.mods.fml.common.Mod;

import cpw.mods.fml.common.Mod.EventHandler;

import cpw.mods.fml.common.event.FMLInitializationEvent;

import cpw.mods.fml.common.network.NetworkMod;

@Mod(modid = Tutorial.modid, name = "Mod Name", version = "1.0")

@NetworkMod(clientSideRequired = true, serverSideRequired = false)

public class Tutorial

{

public static final String modid = "YourName_ModName";

@EventHandler

public void load(FMLInitializationEvent event)

{

}

You can download the source code from this tutorial right here.
I don't suggest copying the code directly from this download. It will not learn you as much nor will you remember the code. If you want to do that or if you just can't figure out why your code isn't working you can download this.

In the next tutorial I will show you how to add a basic block to Minecraft.

When you are done you can go back to the tutorial list over here.

Wuppy's Minecraft Forge Modding Tutorials for 1.6.2: Set-up

2013-08-07T08:40:00.001-07:00

In this tutorial I will explain how to set up your development environment for MC 1.6.2.
The best way to get everything set up is by watching the video tutorial for it.
http://www.youtube.com/watch?v=vbW0GJeOGGs
There are quite a few things you have to do to get everything set up.

Setting up JDK (skip if you already coded anything in Java)

1. Download Java JDK
2. Install the Java JDK
3. Go to the folder where you have it installed, it should be something like: C:\Program Files\Java\jdk1.7.0_21\bin
4. Copy that folder name
5. Right click on Computer in your start screen and select Properties
6. Click Advanced System Settings (lowest button on the left)
7. Click the Environment Variables button at the bottom which opens up a new window. In that window should be something like "User variables for [your user name]". In there should be 2 variables. TMP and TEMP.
8. Now hit the new button right under that part of the window (so User variables, not System variables).
The Variable name has to be: Path.
The Variable value has to be: C:\Program Files\Java\jdk1.7.0_21\bin (or whatever your install location is)
9. Hit OK, OK, Apply, OK and the window should all be closed and everything saved.
10. To test if the JDK is installed properly open your cmd and type: javac. If you get a whole list of commands printed out it is installed.

Setting up Eclipse and Forge

There are currently 2 main ways to set up your Forge. The easiest and fastest way is to use the simple install file in forge. The other takes a whole lot longer to set up and is also much more complicated. However, if you use this second way, which some call the "Pahimar setup" you will have a much better and more organised setup.

I will be showing the simple setup. If you want to see how to do the Pahimar setup take a look at his video over here.

You should use the pahimar setup if you want to make a very big mod or multiple ones, but for learning you may as well stick to the basic setup. Personally I use the Pahimar setup.

Here is how you do the simple setup.

1. Download Eclipse over here. Make sure you get the Eclipse IDE for Java EE Developers.

2. Download the newest version of the forge code over here. You need the src download for this.

3. Extract Eclipse into a folder where you want to be programming in.

4. Extract Forge where you want your code to go.

5. When you have extracted the Forge you should see a install.bat or install.sh. Start this program and it will install Forge, MCP and everything else you need to start coding. This can take a long time. It has to download over 40 libraries and almost 600 resources (images, lang files etc.) which takes time.

6. When the install file is done exit out of the program and start your Eclipse.exe.

7. This will open up a screen which asks you to select a workspace. Click the browse button and navigate to the location where you have forge installed. Then go to: forge/mcp/eclipse. Select the eclipse map and hit Ok.

8. On the left you can see the Minecraft project. In there you can find all the source code for Minecraft, Forge and FML. You are now ready to start modding for Minecraft.

When you are done you can go back to the tutorial list over here.

Open sourced mods

2013-08-07T07:55:00.002-07:00

All of the mods you can find on this page which are all made by me are now open sourced.

If you want to take a look at the code for the Peacefulpack, Goblins and Giants, Harder Peaceful etc. you can now do that over here.

All of the code is licensed under the GNU GPL license which pretty much means, use it in any way you want, just don't copy it over and release it somewhere else.

One thing you should now about the code is that some of it may look very bad. That is because a part of the code that is online is over a year old and made before I even knew Java. There is also outdated code which I haven't fully updated to 1.6 yet and there is other code I am working on right now which may also not work fully. So learn what you want from the code, but like almost anything it is not perfect.