How to create a Minecraft mod? - The Complete Tutorial | Accelerated Ideas
Home | News
Latest guides, tutorials and news stories - Technology, Entertainment and Gaming
Copyright © Accelerated Ideas 2005-2014

How to create a Minecraft mod? - The Complete Tutorial

How to create a Minecraft mod? - The Complete Tutorial
Tag: minecraft

This tutorial will guide you through the process of decompiling the Minecraft source code and editing particular sections of code to create your very own Minecraft mod. In fact it's not as hard as you might think to create your own Minecraft mod.

It's recommended that you have some programming experience, but it's not essential. Most people find it easy to look up Java commands online and enjoy the challenge of learning something new.

Java what!!?

In case you've never heard of Java, its an object oriented programming language, similar to the latest .NET development languages like C#. However, it's been around far longer and is widely consider the original true developer language of choice. Java code is separated into logical units called classes that make it easier to reuse pieces of code. They also make it easy to manage large projects such as Minecraft.

Don't let all that programming jargon put you off, Minecraft is actually really well structured making it easy to make modifications.

Applications you'll need to edit Minecraft source code

Before you can create a mod, you'll need to download the following applications:

1. Java SDK
The development kit that lets you compile Java code into executable programs.
Java SDK

2. MCP – The Minecraft Coder Pack
This is an awesome pack that contains a selection of folders and batch files to help you decompile java code, obfuscate code and run mods in a test environment. You've got no chance without this!
Minecraft Coder Pack

3. Notepad++ - A Source code editor with syntax highlighter
Notepad++ is a free application that makes editing source code much easier thanks to its syntax highlighter. It's far better than the bog standard notepad you get with Windows.

Step by step setup

1. Install the Java SDK (accept the defaults)

2. Install MCP, we recommend choosing C:\MCP as your installation folder

3. Install Notepad++ (again accept the defaults)

4. Create an environment PATH.

Just right click on My Computer and click Properties. Go to the Environment Variables section. Scroll down the list of System Variables and edit the PATH variable. Add a semi colon at the end and paste the full path to the bin folder of the Java SDK e.g.

C:\Program Files\Java\jdk1.6.0_24\bin

5. Copy the Minecraft bin and resources folders from your Minecraft installation folder into the jars folder of the MCP installation.

e.g. C:\Documents and Settings\User\Application Data\.minecraft\bin --> C:\MCP\jars

Decompiling the Minecraft source code

If you've ever had a dig around the minecraft.jar file you'll have seen a tonne of Java class files. It's no good opening these files up and attempting to change a few things because the code is compiled and obfuscated. Its just doesn't make any sense, even in coding terms! And that's the point of obfuscation, it's supposed to be compact and smaller in size.

To be able to view the original Minecraft source code you'll need to turn to our friend MCP and decompile it using their pre-built batch files.

The batch file (.bat) we're looking for is called decompile.bat and it's located in the root of the MCP installation folder. Just double click it to start running.

Creating a Minecraft mod

Ok, now we've got the full original Minecraft source code! Its saved in the MCP\sources folder. E.g.


If you open the src folder, you'll notice that all the original Minecraft class files are fully readable and the code actually makes some sense.

Editing a Minecraft class file

Ok, so you've got all the original source what?

Now the fun begins, all the Minecraft class files are named appropriately. For example, we have an class that controls the Slime mod creature. It's got methods to control the mobs texture, the sound to play when it gets hurt and like other mobs the onUpdate method controls what the mob does on each update.

If we wanted to edit how the Slime mob behaves we would need to edit the file. To do this we turn to our next friend - Notepad++.

Just open Notepad++ and drag and drop the file onto the notepad text editor. It will look something like this:

Creating a Minecraft mod

In this example, we're going to just change the texture that the Slime mob uses (it's a good example if you wanted to copy the Slime mob, create a new minecraft mob and also use your own texture).

Ok, so just type into the text editor and change the texture. In this example, we'll just change it to use the cow texture because we're not going to create a whole new texture.

Creating a Minecraft mod

Recompiling the source code

Now that you've made your change its time to recompile the code. Just run the recompile.bat file and the code will be compiled again.

If there are any errors during compilation (if you have any syntax errors i.e. your coding is dodgy) you can find these in the MCP\logs folder in the minecraft_compile.log file.

If there are errors, you'll need to correct your mistakes before you can test your changes. Go back and review the code changes you made, did you type something by mistake?

Testing the new changes

After the codes compiled, you can run the new Minecraft code using the MCP file called test_game.bat. Just double click the file and Minecraft will run as usual.

Obfuscating your changes

If you want to distribute your changes to other Minecraft players and post them on the Minecraft Forum you'll need to perform a few more steps.

1. Firstly, open the MCP\conf folder and edit the client_obfuscation.txt file. Clear the text in this file and replace it with the names of the classes you have changed .e.g EntitySlime. It's one class per line. Now save the file and close it.

2. Run the reobf.bat file by double clicking it (its in the root of the mcp folder).

3. Your changed classes will be saved in the MCP\final_out\minecraft

4. These will look like the obfuscated files you find in the minecraft.jar file e.g. qm.class

5. These classes are ready to distribute as a new mod..congratulations!!


  • Don't expect success overnight, programming takes time. Get familiar with the Java language and learn from the code that Notch has created. It's taken him years to get this far, so respect his work and learn from it!
  • Start simple, change a single line of code, recompile and test the changes. The key to success is change little and test often. Its easier to find mistakes if you haven't changed tonnes of code before testing it.
  • If you want to distribute your new mod, don't make large changes to Minecraft class files as they could conflict with other mods. Try and separate your mod as a new class and hook into it with minimal code.
  • Once you've had a bit of practice using MCP and trying to create a mod, why not try using the test_mod.bat file? This allows you to enter commands into the Minecraft environment and test conditions and execute methods.
  • If you distribute mods, keep em clean! Others might want to expand your mod later so make it nice and readable like Notch has done.


Minecraft 1.6 Features - New Handheld Maps

Apart from a long list of bug fixes, Minecraft 1.6 contains a new mapping feature. The handheld maps are just like real maps that track your progress as you explore a world. You can share maps with friends too but they’ll only work when you’re..

Best Minecraft Adventure Maps

With hundreds of Minecraft Adventure Maps around it's hard to know which ones are any good. Our list contains the top 5 best Minecraft Adventure Maps to play. Yes we know, we're helping you out again..just make sure you enjoy yourselves..

Sign Up as a Minecraft Mod Developer

After the earlier announcement that a mod API would not be released, Notch has confirmed his plans for mod development. Developers can now sign up for a FREE Minecraft mod developer account and legally distribute mods for Minecraft.

No Minecraft Modding API. Its ditched - do not expect a release date
No Minecraft Modding API. Its ditched - do not expect a release date (Apr 2011)
In Notch's latest message he reveals that the Minecraft API will not be released. It makes sense really. The API would never give the same flexibility as developing mods using Java code. However, this still leaves Notch with the dilemma of stopping..

How to create a Minecraft skin?
How to create a Minecraft skin? (Apr 2011)
Creating your own Minecraft skin is actually quite easy thanks to the free Minecraft Skin Editor software - SkinEdit. In this tutorial we guide you through using SkinEdit and creating your own Minecraft skin.

Minecraft 1.5 Features - Weather, Stats and Achievements
Minecraft 1.5 Features - Weather, Stats and Achievements (Apr 2011)
Notch confirmed in his latest statement that Minecraft 1.5 contains the completed achievements and stats system, an advanced weather system with lightning bolts during storms, ice growing back in cold regions and snow covering the ground when its..



Thank you so much I've been trying to recompile the minecraft code with eclipse but it wasn't working. Now I can finally start working towards making my first mod. What I was thinking was a portage mod which would go as follows: When you are in sneak mode (holding shift) then you could right click on a boat and it would go on your head. This would be useful if you want to go out and explore so you wouldn't need to bring a lot of boats. Once again I thank you for this amazing post!


I tried to recompile minecraft and it gives 31 errors :/


thanks for this. but do you have to use the official JDK because using Eclipse doesnt work our for me. and when i ty to decompile the correct files you said it never does it and gives me a few errors.

GuestMe ofc

Great Tutorial! Help'd me Alot Thanks ! :)


When I tried to decompile it said it couldn't find the folder 'minecraft' in the sources folder. So I made it in there. Then it said it couldn't find 'minecraft_server.jar' what should I do???


was wondering what you meant when u say "edit the PATH variable. Add a semi colon at the end and paste the full path to the bin folder of the Java SDK" since I can't paste that line of text into the bin folder, am i reading something wrong?


The windows PATH variable is configured via My Computer - Properties. You don't need to add anything to the Minecraft bin folder. Just copy the location (path) to your Minecraft bin folder and paste into the Environment Variables section.


this is the only piece of information on this i can find on the internet, great post


I love your tutorial :D
But when i went to recompile it gave me a bunch of errors >.>
Help please :}


i run decompile.bat and it finishes, then i go into the sources but theres nothing but a folders inside.
help plz


keep expanding the folder you find until you get to a gigantic list of .java files.

Guesttirso daniel

Owww god!

men this is a very good tutorial

you helped me too much
i will try to change the creeper's sound (when ''ignited'')

If i make it i will put the download link :D

GuestMonster Hunter

THX A LOT! great tutorial))

P.S. for newbies: errors often found if only using minecraft with MODS..if its that, use ''clean'' one first, after recompiling you can add other mods which had given errors till decompiling

...or delete them before and\or after using MCP


I got 2 problems. FIrst Problem: Step number 4: I have NO idea where the Path is. I right click "computer" click "properties" But i cant find ANYTHING named even close to Environment Variables so therefore i skipped that step.

Second problem: When i decompile it finish it but when i go to Src folder the folder is empty. There is nothing in there. But again when i looked at the log in decompile it also said "Error: Detecting modified Jar. Unpredictible Results". Maybe it has something to do with 2 things: One: I have mods installed. Two: I skipped step 4


but how can I create a new block and item???

Guestunknown help

for some others having problems with the server.jar download it at and multiplayer outdated but free then download extract or just open it copy the server.jar to your mcp jar folders then decompile look at the jar again minecraft minecraft until you see the src folder


I dont have the final_out folder. What shall I do?


I can't find client_obfuscation.txt in the conf folder. Help :(


FML now that I did that environment variable thingy, I can't start MINECRAFT AT ALL!!!! I get the error Error: loading: G:\Java SDK\bin\jvm.dll


When i run decompile.bat it says it cannot find path specified.


If you want to put a custom texture on one of the mobs, where do you place the file?

Post a Comment

Post as anonymous or connect with your favourite social network
Login to Twitter Login to Facebook

Html is not allowed!

Enter the characters shown in the image so we know you're human!

Latest - minecraft

Whats New in Minecraft 14w17a - Customize World Options, Choose a BiomeWhats New in Minecraft 14w17a - Customize World Options, Choose a Biome
Minecraft 14w17 is part of Minecraft 1.8 and for a change it's a big version with a major feature included. Thanks to a guy called Ryan Holtz, an ex-modder now working for Mojang, we have a new feature - Customize World Options.

Whats New in Minecraft Snapshot 14w10a - Name Changing, UUID BansWhats New in Minecraft Snapshot 14w10a - Name Changing, UUID Bans
Dinnerbone described Minecraft 14w10a as a "Big Bang" step towards name changing in Minecraft. As a result, Snapshot 14w10a contains the barebones of the name changing feature which impacts many server commands - Ban lists, Whitelists etc.

Whats New in Minecraft 14w05a - Spectator Gamemode, Tilting MinecartsWhats New in Minecraft 14w05a - Spectator Gamemode, Tilting Minecarts
It's that time again! Minecraft 14w05a has been released by Mojang and it's available to download using your launcher. Minecraft 14w05a, part of version 1.8, comes with a small but exciting list of features. The most notable being the new gamemode..


Whats New in Minecraft 14w17a - Customize World Options, Choose a BiomeWhats New in Minecraft 14w17a - Customize World Options, Choose a Biome
Minecraft 14w17 is part of Minecraft 1.8 and for a change it's a big version with a major feature included. Thanks to a guy called Ryan Holtz, an ex-modder now working for Mojang, we have a new feature - Customize World Options.

Titanfall DLC Expedition - Coming May 2014Titanfall DLC Expedition - Coming May 2014
The first DLC for Titanfall was announced at PAX East, it's called Expedition and will be available in May 2014. Few details were revealed about the new DLC but we can confirm that 3 new maps are included.

Extinction DLC 3 - Balls Pyramid is the Location for the Next MapExtinction DLC 3 - Balls Pyramid is the Location for the Next Map
We've just completed Extinction Mayday and just like Nightfall, the final cutscene reveals the next map for DLC 3. Set in Australia, the next map takes us to Balls Pyramid, deep underground to the resting place of the Master aliens. The Masters..


popular Most Popular

Popular Topics

minecraft, black ops 2, celebrity
cod ghosts, brazil carnival

English English  |  Portuguese Portuguese