1. Introduction To Minecraft Modding

Minecraft modding involves modifying the base game to add new features, modify features, replace features, or even remove features if wanted. Minecraft modding can be fun, both for players and modders alike, as it allows expanding the game in fun ways and express creativity in new ways.

Modding is interesting because it allows you to expand your technical knowledge (optimization, rendering, etc.), express creativity in unique ways, better your game design skills, and share stuff with people!

If you want to have a good time with modding, you should primarily approach it as a hobby and for fun, if a modder manages to make modding their job, good for them, but that's very unlikely to happen. Despite modern social networks emphasis on numbers, you really shouldn't look at how many times your mod has been downloaded or how much money it made, you should focus on your own fun!

Let's get into it!

  1. Prerequisites
  2. The Mod Loader
  3. Mappings
  4. Modding Philosophy
    1. Clean and Readable Code
    2. Test Your Mod
    3. Compatibility & Integration
  5. Let Me Begin!


To start modding you may need to know some stuff first to make it easier.

Minecraft is made in Java, Java has the advantage of being a relatively flexible enough language for modding. This means we can easily inject new Java code, or even replace parts of the code with other. This means a very important thing:

You should learn Java first!

Knowing Java will help you greatly in writing code for your mods.

Not interested in learning Java but still want to make mods? It's ok! There's alternatives to participate in the modding scene:

Have a different skill set? You're not a fan of programming but you prefer texturing or writing lore?
That's fine! Everyone's different, looking for other modders that know how to code might be interesting to work as a team on a mod. Lots of big mods are made by teams of people!

If you go with the non-programmer way, this article won't be entirely relevant to you, though some points may still be interesting.

If you go with the programmer way and know enough Java, you should get an IDE (Integrated Development Environment), this will improve greatly your programming experience. IDEs commonly used by the community are:

Once you've got the IDE, you might need to familiarize yourself with Gradle which is the build tool used.

The Mod Loader

The mod loader is a big question, some may want to make their mod on all mod loaders, some only choose one. The mod loader is what will load your mod, usually there's standard libraries made along them for your mod to use, simplifying greatly some things and improving greatly compatibility.

There's currently 4 main mod loaders:

The rest of this article should talk of things that would apply no matter the mod loader, but when it comes to code they're very different, this means if I have more articles that introduce code they won't always be relevant, and it also usually means mods of a specific loader cannot run on others.


Mappings are the names of the methods, fields, and other various symbols in the Minecraft code. Minecraft is obfuscated, this means that all the names are shortened and loose meaning, for a long while Mojang did not offer official mappings, this lead to the community creating various mappings using retro-engineering like MCP which is now defunct, or Fabric's Yarn, and Quilt Mappings.

For newer versions Mojang publishes the official mappings (often called "mojmap"), which are the actual original names. Though it lacks any kind of documentation (which Parchment is trying to fix).

If you want to make a mod that's available on multiple mod loaders it's recommended to use mojmap. For Quilt or Fabric you may choose to use Yarn or Quilt Mappings as alternatives, though it's not a must, so it should be chosen purely out of preference.

Modding Philosophy

Before jumping straight to modding, I wish to discuss something that's often overlooked in modding tutorials: the modding philosophy.

If your mod is intended to be used along other mods by a lot of people, then you really should pay attention to this part.

Here's some things you should keep in mind when modding:

Clean and Readable Code

You should keep your code readable! While it might seem an obvious advice, it's often a forgotten one. Clean and readable code will greatly help you when you wish to update your mod.

Test Your Mod

You should always try to test your mod before publishing it, of course bugs always slip in, but a tested mod is less likely to break!

Mod loaders are starting to include tools to use the Game Test system as seen in Henrik Kniberg's keynote, or unit testing abilities, allowing to automatize the testing of your mod.

Also make sure to not just test with the Minecraft client but also test dedicated servers. They have some subtle differences, and it's sadly common to see mods break on dedicated servers.

Compatibility & Integration

One of the amazing things of modding is being able to combine mods, it's so popular that people create modpacks and share them.

To allow this to happen it requires to put extra attention to your mod's code to make it compatible. Other mod authors will also appreciate if your mod is made with compatibility in mind since solving such issues is always annoying, especially for other parties that can't fix your incompatibility.

Though, I'd argue that compatibility is not enough, integration is much better. If possible you should strive for integration, it creates more cohesive experiences for players.

For example having a mod that adds a new tree and wood type, and a mod that adds wooden chairs, them not crashing and working along will be compatibility, though it doesn't mean there's a wooden chair for the new wood type. Making so that a wooden chair for that new wood type is also added when both mods are present is integration.
You don't just make it work "together", you make them work hand-in-hand together. And that, in my opinion, is much better and enjoyable.

Let Me Begin!

Okay! okay!

I am not going to cover how to code a mod here, so now it's time to dig into the mod loader's documentation you wish to use.

Great starting points are example mods like Quilt's template mod and wikis.

So now go wild!