How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (2023)

Modding Minecraft can be a lot of things: Your new hobby, a side-hustle or if you’re talented maybe even the start of a new business. Starting with Minecraft Modding can be a daunting task, but not with this STEP-BY-STEP introduction on how to start Modding Minecraft!

What you need

You should be able to install programs onto your Computer and you should have the basic computer to skills to know how to do it. For the Setup you will need a few things listed below:

  1. A Java JDK. I personally would recommend AdoptOpenJDK from here. But you are free to use any other JDK as well. However, make sure you use Java 8, other JDKs might not be supported perfectly!
  2. An IDE (Integrated Development Environment). I personally use IntelliJ IDEA for modding, the community version of which, you can download here. It is free and gives you all the amazing tools you need to start Modding in Minecraft.
  3. Java knowledge. Yes, this is NOT optional. You cannot start to mod Minecraft without at least some knowledge of Java. I might add a new post in the future, detailing what exact things you need to know, but you must at least know basics of OOP (Object Oriented Programming) and some knowledge of lambdas doesn’t hurt either.
  4. Forge. You can download forge here. Note that this description holds only for the 1.16 Versions of Minecraft. Make sure to download the MDK from the site. Choose the right download which is the recommended Version!

We will proceed with the basic setup for Forge to finally start modding Minecraft.

Minecraft Modding: Forge Setup

By this point you should have both a Java JDK installed and IntelliJ as an IDE. Firstly, when you download Forge you will have a .zip File inside your Downloads folder. Unpack it with a program such as WinRar of 7Zip. The contents of the folder seen below should be moved to somewhere, where you want your Mod Project to be created. And rename the folder the contents are to something of your choosing.

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (1)

After moving the contents to your desired location, we can now start IntelliJ and import the project.

IntelliJ project Setup

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (2)

Upon opening IntelliJ for the first time a screen similar to this will appear. You want to choose Open or Import. A File Dialoge will open where you can choose the location of the existing project. Make sure to select the folder where the contents of the zip file are contained in like this.

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (3)

Press OK. A new window will open a bunch of things will start happening. This might take quite a while. Please be patient and wait for a couple of minutes until either a BUILD SUCCESSFUL or BUILD FAILED is shown inside the build window. Most important is that after everything is done to the left of the window inside the Project window you see the colors of some of the folders change as well as a BUILD SUCESSFUL at the bottom inside the Build window.

Warnings as well as “Deprecated Gradle features” can be ignored. Only errors or a BUILD FAILED is cause for “concern” although those will most likely be fixable as well.

Changes to the build.gradle file

For the next step you will open the build.gradle file which contains crucial information about your mod as well as other things needed for the forge project.

(Video) How to Start Minecraft Modding 1.16.5 with Forge | Forge 1.16.5 Modding #1

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (4)
version = '1.0'group = 'com.yourname.modid' archivesBaseName = 'modid'

Located on line 15, 16 and 17 respectively are the first important things to change.

version refers to the version of your Mod (NOT the Minecraft Version).
group refers to the name of your package which contains the mod. Think of it as a reverse of a domain would be for a Mod from
modid is very important and refers to a unique id with which your mod will be identified. For demonstration purposes we will change it to tutorialmod in this case!

I have changed the line accordingly:

version = '1.16.5-1.0'group = 'net.tutorialsbykaupenjoe.tutorialmod'archivesBaseName = 'tutorialmod'

Refrain from using the same group as me. Use com.yourname.tutorialmod. Otherwise people might not believe your work is actually yours!

We’re not done yet though. Press CTRL + R or CMD + R (on MAC) to open up the Replace menu. At the top of the file a replace menu you should open.

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (5)

Put examplemod in the first line and tutorialmod in the second and click Replace all. You can then save the file by pressing CTRL + S. You should note that a little elephant appeared on the top right corner. Do not yet click it though.


Mappings for Minecraft are a sort of way of translating the code – making it possible to read. You will most likely find these mappings here (found on line 34 of the build.gradle file):

mappings channel: 'official', version: '1.16.5'

These are the official mapping used by the Minecraft developers themselves. You can use them, but I would personally advise to switch to the Forge mappings as I feel they are more intuitive when it comes to the names:

mappings channel: 'snapshot', version: '20210309-1.16.5'

Note that if you choose not to change the mappings most other articles on the site as well as the video tutorials on YouTube might prove challenging to follow as the naming of fields and methods is going to be significantly different. Keep that in mind.

Changing the packages

Inside the Project window when you expand main > java you should the package default package structure with a class called ExampleMod at the end.

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (6)

Open the class by double clicking. We’ll have to a change a few things here as well.

(Video) Minecraft Modding! Step 2: Setting up Forge MC 1.16.5

At the very top of the class you can see package: com.example.examplemod; this will need to be changed to our group name we have defined earlier. For me this will be net.tutorialsbykaupenjoe.tutorialmod

If you change it, a red underline will appear signifying an error. Right click on the line and chose “Show Context Actions” and then the first option with “Move”

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (7)

Upon choosing this you should see a new package appear in your project window.

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (8)

The other packages can now be deleted. Select the com package (or if your custom package started with com the example package) and hit the delete key. Confirm by pressing the Delete key and you should now be left with only your group packages and the ExampleMod class. This will now be renamed.

Right click the ExampleMod class and chose Refactor > Rename… and rename it to TutorialMod or if your Mod has a name then to that. Please be cognizant of Java Naming Conventions please! The name of this class should NEVER be the same as you mod id!

After renaming it, the last thing we will need to do is to make sure our Mod Id correctly used everywhere.

The Mod Id

It is important to note that the mod id must be written in lower-case with no spaces or special character expect for underscore or dashes. My recommendation is to choose something easy with words being separated by underscores. We will be using tutorialmod as the mod id.

Firstly you will see that above our TutorialMod class there is a @Mod(“examplemod”) that is first occurrence of the mod id inside of our code. To make our life in the future easier we will define a new string to reference instead of having to constantly write out the mod id. This will not be more useful in this tutorial, but will greatly reduce possible errors caused by misspelling out mod id.

@Mod(TutorialMod.MOD_ID)public class TutorialMod{ public static final String MOD_ID = "tutorialmod";

This is the way we change the beginning. We add a static variable with our mod id and the replace the string inside the @Mod with the static call to that variable.

There is one more place where the mod id needs to be changed and the the setup will be complete. Inside the resources folder there is a META-INF folder which contains the mods.toml file. Open the file and look for modId=”examplemod” this will also need to be change to our mod id. In here we need to specify it ourselves.

# The modid of the modmodId="tutorialmod" #mandatory

this is how it should look like! You can also change the displayName to something like Tutorial Mod

(Video) Minecraft Forge Modding Tutorial 1.16.5 #1 | Setup

# A display name for the moddisplayName="Tutorial Mod" #mandatory

A quick list to verify where the Mod Id needs to be changed:

  1. build.gradle file (with the help of CTRL + R to replace all occurrences)
  2. TutorialMod class inside the @Mod
  3. mods.toml file

The final command

Now all you need to do is open the Terminal and type in this:

gradlew genIntellijRuns

hit enter and this will build and download some additional resources forge needs to function (Please note that if you are on Linux or Mac OS you need to use ./gradlew genIntellijRuns). You might get a BUILD FAILED. Simply run the command again. This might be everything you need to fix it.

After this point you can also hit the elephant at the top right corner. This will reload the gradle changes. And one error will pop up if you have chosen the forge mappings. Inside your TutorialMod file this line (53 probably) will have an error:"Got game settings {}", event.getMinecraftSupplier().get().options);

Please simply delete the line as it is unimportant to us!

There might or might not be another error present inside the processIMC method, which looks like this:

// some example code to receive and process InterModComms from other"Got IMC {}", event.getIMCStream().map(m->m.getMessageSupplier().get()).collect(Collectors.toList()));

the getMessageSupplier() might be red. Simply delete the entire contents of the method until you are left with this:

private void processIMC(final InterModProcessEvent event) { }

Finally starting Minecraft

Navigate to the very top right corner to Gradle and expand the everything until you expand fg_runs double click runClient and Minecraft should start up.

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (9)

Modding Minecraft Setup: COMPLETE

You can double check if your mod is inside the game by taking a look at the Mods:

How to Start Minecraft Modding in 1.16.5 with Forge (STEP BY STEP) (10)

Congratulations you have successfully started Modding in Minecraft. There is of course quite a bit more to it. But these were great first steps. If you found this useful I would appreciate checking out my YouTube Channel which has the exact same content (as well as other videos) just in video form.

If any questions remain please feel free to leave a comment on here or on YouTube 🙂

(Video) How to make a Minecraft Mod : World Saved Data, Forge 1.16.5

Was this helpful?

91 / 8

Share this post

  • tweet
  • share
  • share
  • share
  • share

Post Views: 17,835

#Minecraft 1.16 #Minecraft Modding


How do I launch mods with Forge? ›

Adding Mods
  1. From the Minecraft launcher, enter the Installations tab at the top.
  2. Hover over your Forge installation, then press the Open Folder icon to the right.
  3. In the new window, locate or create the mods folder, then enter it.
  4. Paste the mod . ...
  5. Once done, return to the MC launcher and press Play .
Dec 27, 2022

How do you mod Minecraft with Forge? ›

How to Install Minecraft Mods Manually
  1. Install Minecraft Forge. The most popular modding add-on is Minecraft Forge. ...
  2. Download the Mods You Want. The next step involves downloading Minecraft mods. ...
  3. Copy the Mod to the /mods Folder. It's time to install some Minecraft mods. ...
  4. Check the Mod Installation.
Dec 7, 2022

How do I start modding in Minecraft? ›

The Ultimate Guide to Minecraft Modding with Java
  1. Step 1: Set up Java Developer Kit (JDK) ...
  2. Step 2: Set up your Text Editor. ...
  3. Step 3: Set up Forge. ...
  4. Step 4: Install Pinta. ...
  5. Step 5: Create Your Project. ...
  6. Step 6: Make Your Own Mod – A Custom Sword! ...
  7. Step 7: Compile your Mod. ...
  8. Step 8: Test your Mod!
Jun 23, 2020

How do you create mods? ›

Creating a mod manually

Create a folder under steamapps\SourceMods\ (A mod can actually reside anywhere, but placing it here allows Steam to detect and launch it.) Create a gameinfo. txt in the folder. You now have a mod!

Do you need Forge to run mods? ›

To install these mods, you'll need to use a free add-on called Minecraft Forge. This will let you customize Minecraft: Java Edition with mods. Quick tip: Minecraft Forge can't be used to add mods to Minecraft: Bedrock Edition. You'll need to be playing the "Java" version.

Does mod menu work with Forge? ›

All mods that work with Forge's mod list will automatically work with Catalogue and requires no extra work from developers.

How do I use the forge installer? ›

Install Forge
  1. Step 1: From the Recommended Download section, select the Installer option. ...
  2. Step 2: Once the download is finished, you should have a new file on your computer with a filename similar to forge-1.15. ...
  3. Step 3: Now that Java is installed on your computer, you should be able to click on the file and run it.
Dec 13, 2021


1. Minecraft Modding! Step 2.5: Minecraft Development Plugin Forge and Fabric 1.16.5
(MarcAura & Crylrex)
2. Minecraft Modding Tutorial 1.16 | 1.0 - Setup
(Cy4's Modding)
3. How To Download & Install Forge + Mods (Minecraft Forge 1.16.5 Tutorial)
4. Minecraft Modding Forge Workspace Setup (1.16 - 1.12)
(Eric Hedengren)
5. How To Make A Modded Minecraft Server in 1.16.5 (Forge Server 1.16.5)
(The Breakdown)
6. Add CUSTOM ENTITIES to Minecraft 1.16.5 | Forge 1.16.5 Modding #38
(Modding by Kaupenjoe)
Top Articles
Latest Posts
Article information

Author: Rubie Ullrich

Last Updated: 02/23/2023

Views: 5915

Rating: 4.1 / 5 (52 voted)

Reviews: 83% of readers found this page helpful

Author information

Name: Rubie Ullrich

Birthday: 1998-02-02

Address: 743 Stoltenberg Center, Genovevaville, NJ 59925-3119

Phone: +2202978377583

Job: Administration Engineer

Hobby: Surfing, Sailing, Listening to music, Web surfing, Kitesurfing, Geocaching, Backpacking

Introduction: My name is Rubie Ullrich, I am a enthusiastic, perfect, tender, vivacious, talented, famous, delightful person who loves writing and wants to share my knowledge and understanding with you.