How To Create A Minecraft Mod 1.8

This article is about creating mods for Java Edition. For the Bedrock Edition add-ons, see Add-on.

This article is a work in progress.

Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.

1 Overview
- 1.1 Things you are not to do
2 First steps with Forge
- 2.1 A note about placeholders
- 2.2 1. Create a folder for your project
- 2.3 2. Obtain a "source distribution"
- 2.4 3. Copy key files to your project folder
- 2.5 3½. A note about mappings
- 2.6 4. Import the gradle project
- 2.7 5. Designate the JDK
- 2.8 6. Set up workspace
- 2.9 7. Configure Run settings
3 Creating a mod for Forge
- 3.1 Identifying your mod
- 3.2 Setting up Item Registration
- 3.3 Creating a Custom Tool
  - 3.3.1 Custom Layers over Vanilla Textures
  - 3.3.2 Textures from Scratch
- 3.4 Creating a Custom Mob
  - 3.4.1 Models from Scratch
- 3.5 Creating a Config file
- 3.6 Sharing Your Mod
4 Further Reading
5 Additional Info
6 See also

Overview [ ]

Mods (short for 'modifications') can modify or add items, blocks, entities, and much more. Presumably, you already have an idea for a mod you want to create. If you simply want to add custom advancements, functions, loot tables, structures, recipes or tags to your game, look into how to make a Data pack, which does not require programming. Or look into how to make a resource pack if you simply want to customize textures (colors and designs), models, music, sounds, languages, splashes, fonts, or the end poem. Or perhaps you want to 'fork' a favorite mod to update for newer versions of Minecraft. In any case, this guide will eventually cover only the most basic elements of creating an item and creating an entity (a moving thing like a villager, sheep, zombie, etc.), and distributing the resulting mod package.

Minecraft mods consist of jar files (example: yournewmod.jar) which contain class files, JSON files, and image files, to name a few of the most common.

Class files are specific to the Java programming language. A few Java tutorials to try are w3schools (web and mobile), SoloLearn (web and mobile), and kodevelopment(web). You will need an IDE (Integrated Development Environment) such as IntelliJ or Eclipse to read or create class files. This tutorial will focus on IntelliJ IDEA Community Edition 2019.
JSON files are a means of detailing the characteristics of objects used by Java class files. JSON is much simpler than Java. You will need a text editor such as Notepad++, Vim, or Emacs to read or create JSON files. You probably already have a basic text editor on your computer, but there are many advantages to using other ones instead.
Image files you may be familiar with include .bmp and .jpg formats, but Minecraft requires .png format (example: yournewlogo.png) in multiples of 16 pixels square (example: 16x16, 32x32, 64x64). You will need an image editor such as Paint.NET or GIMP to edit or create .png files. You probably already have MS Paint on your computer, but GIMP has so much more functionality, and Paint.NET is quite user-friendly. There are also several websites with tools for creating pixel art.

If you have been playing Minecraft Java Edition, you probably already have JRE (Java Runtime Environment). To develop a mod, you will need to find JDK (Java Development Kit), which includes the JRE and an emulator. Create a free account at oracle.com and download JDK Standard Edition version 8. Then follow the instructions for installing it, and make note of the location it installs to. Pay particular attention to the section on Updating the PATH Environment Variable.

With a Java Development Kit installed, and the IntelliJ Integrated Development Environment to manipulate Java with, you now have the tools to develop custom software that can be used in a variety of applications. While working on a mod, continue working through Java tutorials. The lessons will enable you to put your ideas into action, while the ideas will make the lessons more interesting and memorable.

One more tool you should set up before starting a mod is the Forge MDK (Mod Development Kit). Forge is a collection of useful resources and mod loader, designed specifically to simplify compatibility between Minecraft Java Edition and multiple community-created mods. This tutorial will focus on the MDK for version 1.12.2 of Minecraft Java Edition, although Forge for 1.14.4 has been around for some time. An alternative to Forge is Fabric, but Java is still used to code mods either way.

Things you are not to do [ ]

There are some things that you should be careful to not do when creating a mod. Keep this list in mind:

Don't do anything that violates Mojang Studios' terms of use for Minecraft.
Don't release Minecraft versions or modifications that allow you to play without having bought Minecraft from Mojang Studios.
Don't release the de-compiled source code of Minecraft in any way.
Don't modify existing mods without permission from that mod's author(s). Check their License, usually available in the author's GitHub repository. If you can't find the license, then you do not have permission to share a modified version with anybody. You may tinker with the files for personal use only.

First steps with Forge [ ]

This wiki article aims to provide a foolproof walk-through of a few key elements of Forge's tutorial: https://mcforge.readthedocs.io. Bookmark their page, as it addresses many issues this article will not. Moreover, there's more than one valid way to achieve the desired result; this wiki article will focus on the simplest, which is probably not the most efficient or elegant. If you follow precisely the steps outlined here, you should soon have a functional mod, which you can then tinker with to your heart's content. If you use Linux, Forge's tutorial will probably be more useful for you. If you use Windows, read on.

A note about placeholders [ ]

This tutorial will use "You" to represent the User profile you are logged in with; if you copy-paste paths from this tutorial, be sure to replace "You" with your own Windows username. This tutorial will use "yournewmod" to represent sections you should replace with the mod name you choose for your project.

1. Create a folder for your project [ ]

Navigate to C:/Users/You/Documents and create a new folder. The name of this folder may be changed easily later.

2. Obtain a "source distribution" [ ]

Visit https://files.minecraftforge.net and make sure the version selected is the version for which you want to create a mod. In the large "Download Recommended" box, click on the small MDK box. A dialog box will appear, asking where you want to save the file, and what to name it. Choose any convenient location, but leave the name unchanged.

3. Copy key files to your project folder [ ]

Open the forge-1.16.5-...-mdk folder (with or without unzipping it first) and copy-paste the following 5 files from this folder^{[ more information needed ]} to the project folder you created in the first step:

the src folder
the gradle folder
gradlew
gradlew.bat
build.gradle

3½. A note about mappings [ ]

There are two different sets of mappings available for method names - "MCP" community-based mappings, and "Official" mappings based in part on the official Obfuscation maps (though class names are different for technical reasons). The default in the MDK has recently been changed to 'official', but this tutorial will use the MCP mappings for now because function parameter names are not available in the official mappings.

Change the following line in build.gradle line 34

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

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

On line 51 of ExampleMod.java, change options to gameSettings (or simply comment or delete the line)

4. Import the gradle project [ ]

Open/Run the IntelliJ IDEA program. In the landing screen, click on Open. A dialog box will appear, asking which file to import. Navigate to your project folder and select "build.Gradle," then click OK.

5. Designate the JDK [ ]

In the next window, click in the "Gradle JVM" field and navigate to the JDK files you installed earlier. If you got version 8 update 282, select the folder named "jdk1.8.0_282." Click OK and wait for the build to finish, Showing the results in the bottom field.

[TODO: I didn't get another window, need to verify what happens on a fresh IDEA install]

[Note: Confirming that on IntelliJ IDEA 2021.1.2 window doesn't appear, most likely that it detects JDK itself, so it will only appear if it failed to locate appropriate JDK]

6. Set up workspace [ ]

No Dependencies needed to be Installed. Move to next step as new update in Forge command setupDecompWorkspace is not needed

7. Configure Run settings [ ]

After refreshing gradle, open the gradle panel and double-click the "genIntellijRuns" entry in the "fg_runs" folder. This will create new run configurations that allow your mod to be run. Next, open the "Edit configurations" window of Run settings and look approximately halfway down, for "Use classpath of module." Click on its dropdown field, and select the option that ends with .main, then click Apply. If the settings you just finished editing were for the Minecraft Client, click on Minecraft Server and repeat the steps to set the classpath. [TODO: Is this necessary anymore? It was already set]

You can now select and run runClient in the run configuration drop down menu. This will start the Launcher with your mod included. When you get to the landing menu, you can check whether your mod is present.

Creating a mod for Forge [ ]

Identifying your mod [ ]

This section is a work in progress.

Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.

The project as delivered with the MDK is called "examplemod" with the package name "com.example.examplemod". You will need to rename this to your own names in the following places - rename the class files - build.gradle - META-INF/mods.toml

Package names should be based on a domain name in reverse order, or a name that is not a valid domain name if you do not own a domain name.

[TODO clearer instructions, set up MODID variable]

Setting up Item Registration [ ]

This section is a work in progress.

Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.

You can create a class to put your definitions in. Here we call it RegistryHandler, though some mods have separate classes for each type of object called ModItems, ModBlocks, etc; and in theory you could just add it to the main class. Having at least one class file (or, ideally, a package) to put registrations in without any non registration related code provides better organization for when you expand your mod.

                        package            com.example.examplemod            ;            import            net.minecraft.item.Item            ;            import            net.minecraft.item.ItemGroup            ;            import            net.minecraftforge.fml.RegistryObject            ;            import            net.minecraftforge.registries.DeferredRegister            ;            import            net.minecraftforge.registries.ForgeRegistries            ;            public            class            RegistryHandler            {            public            static            final            DeferredRegister            <            Item            >            ITEMS            =            DeferredRegister            .            create            (            ForgeRegistries            .            ITEMS            ,            ExampleMod            .            MODID            );            }

In your main class, set it up to automatically be called at the appropriate time, in the public ExampleMod() constructor:

                        RegistryHandler            .            ITEMS            .            register            (            FMLJavaModLoadingContext            .            get            ().            getModEventBus            ());

Creating a Custom Tool [ ]

Let's make a simple spear, with damage ability similar to a stone sword.

So, to start off with we need to make a new directory called tools in your package. Next create a new Java enum called ModItemTier. In this file you need to type a variant of the following:

                        package            com.example.examplemod            ;            import            mcp.MethodsReturnNonnullByDefault            ;            import            net.minecraft.item.IItemTier            ;            import            net.minecraft.item.Items            ;            import            net.minecraft.item.crafting.Ingredient            ;            import            java.util.function.Supplier            ;            @MethodsReturnNonnullByDefault            public            enum            ModItemTier            implements            IItemTier            {            CUSTOMNAMEHERE            (            1            ,            131            ,            4.0F            ,            3.0F            ,            5            ,            ()            ->            Ingredient            .            fromItems            (            Items            .            FLINT            ));            private            final            Supplier            <            Ingredient            >            repairmaterial            ;            private            final            int            enchantability            ;            private            final            float            attackDamage            ;            private            final            float            efficiency            ;            private            final            int            maxUses            ;            private            final            int            harvestLevel            ;            ModItemTier            (            int            harvestLevel            ,            int            maxUses            ,            float            efficiency            ,            float            attackDamage            ,            int            enchantability            ,            Supplier            <            Ingredient            >            repairmaterial            )            {            this            .            harvestLevel            =            harvestLevel            ;            this            .            maxUses            =            maxUses            ;            this            .            efficiency            =            efficiency            ;            this            .            attackDamage            =            attackDamage            ;            this            .            enchantability            =            enchantability            ;            this            .            repairmaterial            =            repairmaterial            ;            }            @Override            public            int            getMaxUses            ()            {            return            this            .            maxUses            ;            }            @Override            public            float            getEfficiency            ()            {            return            this            .            efficiency            ;            }            @Override            public            float            getAttackDamage            ()            {            return            this            .            attackDamage            ;            }            @Override            public            int            getHarvestLevel            ()            {            return            this            .            harvestLevel            ;            }            @Override            public            int            getEnchantability            ()            {            return            this            .            enchantability            ;            }            @Override            public            Ingredient            getRepairMaterial            ()            {            return            this            .            repairmaterial            .            get            ();            }            }

Next, you need to register your item. Go to your item registry class^[?] and make a new item like the one here:

                        public            static            final            RegistryObject            <            SwordItem            >            NAME_SPEAR            =            ITEMS            .            register            (            "name_spear"            ,            ()            ->            new            SwordItem            (            ModItemTier            .            CUSTOMNAMEHERE            ,            5            ,            -            2.8f            ,            (            new            Item            .            Properties            ()).            tab            (            ItemGroup            .            TAB_COMBAT            )));

The numbers are the base attack damage [added to the damage set in the ItemTier] and the speed modifier, the values chosen for the example are intermediate between a sword and an axe.

After this, you need to make a JSON file in src/main/resources/assets/examplemod/models/item called what you set earlier, like so:

                        {            "parent"            :            "item/handheld"            ,            "textures"            :            {            "layer0"            :            "examplemod:item/name_spear"            }            }

Then, go to your textures folder and input the texture you will make in the next step. If you want to know more about durability I recommend this page.

Custom Layers over Vanilla Textures [ ]

This section is a work in progress.

Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.

Textures from Scratch [ ]

Open an image editor, preferably one that supports transparency, and create a new image, with a size that is a multiple of 16x16 (eg. 32x32, 64x64. etc.)

This example is using a 32x32 pixel image and is made in GIMP.

Create your file, making sure it is in pixels and not inches, millimetres, or any other measurement.

Create a new layer, and delete the original canvas. If you don't do that, then your image will have a white background.

Using a brush of 1x1 pixel, start drawing your item. Make sure to use separate layers for separate parts of the item to allow changes to be made easier.

When you're done creating your art, press file to save. If you're using GIMP or another advanced editor, it won't save as a .png. For GIMP, it saves as a .xcf.

With the spear done, press file and then save. Note the lack of white in the background, and instead the blank .png background.

Navigate to the export dropdown or press ctrl+e on Windows or ⌘+E for macOS. This is to export the file. Make sure you export as a .png, not a .jpg or any other file extension. If it is not saved as a .png, it will have a white background and won't look correct.

Exporting the art of the stone spear to desktop. Note that it is being exported as a .png. Certain parts censored for privacy.

If you're following along with this tutorial and wish to use this image, you can download this finished pixel art here.

Creating a Custom Mob [ ]

Models from Scratch [ ]

The best way to model mobs is probably blockbench (blockbench website). Blockbench is a free modeling tool, and it would be much faster and easier than taking the other approach, which is slow. If you want to model with it, simply make a cube, position it, rotate it, size it, and make your model the way you want to make it. If you need more cubes, you can easily make a new one. This is probably the best method for this. It is fast, easy, and customizable.

Creating a Config file [ ]

This section is a work in progress.

Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.

Sharing Your Mod [ ]

This section is a work in progress.

Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.

To build your mod, run gradlew build or ./gradlew build for macOS. This will output a file in build/libs with the name [archivesBaseName]-[version].jar. This file can be placed in the mods folder of a forge enabled Minecraft setup, and distributed. Then you can upload your mod to CurseForge

Additional Info [ ]

This section is a work in progress.

Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.

Recommended:

create a GitHub account to manage versions of your mod and collaborate with other developers.
further tutorials (in video form, for version 1.15.2)