Your First Minecraft Mod with Java

minecraft mod tutorial


Creating a detailed Minecraft mod tutorial from scratch and providing all necessary source code within this format’s constraints can be challenging. However, I’ll outline a basic mod tutorial focusing on adding a new block to Minecraft, which should serve as a solid foundation for beginners interested in Minecraft modding. We’ll use Forge, the most popular modding API for Minecraft, and write our mod in Java.


  • Minecraft Java Edition
  • Minecraft Forge (compatible with your Minecraft version)
  • JDK (Java Development Kit)
  • An IDE (Integrated Development Environment) like Eclipse or IntelliJ IDEA

Setting Up Forge Development Environment:

  1. Download Forge MDK (Mod Development Kit): Choose the correct version from Forge’s official site.
  2. Extract the MDK to a Folder: Name it something relevant like “MinecraftModTutorial”.
  3. Setup Workspace:
  • Open your command line in the folder.
  • Run gradlew setupDecompWorkspace (Windows) or ./gradlew setupDecompWorkspace (Mac & Linux).
  • After completion, run gradlew eclipse or gradlew idea depending on your IDE.
  1. Import the Project in IDE: Open Eclipse or IntelliJ IDEA and import the project.

Creating Your First Block:

We’ll create a simple custom block called “Ruby Block.”

Step 1: Create Your Mod Main File

Create a new package under src/main/java and name it com.yourname.mymod. Inside this package, create a new Java class named MyMod.

package com.yourname.mymod;

import net.minecraftforge.fml.common.Mod;
import net.minecraftforge.fml.common.event.FMLInitializationEvent;

@Mod(modid = MyMod.MODID, name = MyMod.NAME, version = MyMod.VERSION)
public class MyMod {
    public static final String MODID = "mymod";
    public static final String NAME = "My First Mod";
    public static final String VERSION = "1.0";

    public void init(FMLInitializationEvent event) {
        // Initialization logic

Step 2: Register Your Block

Create a new class ModBlocks to register and initialize your blocks.

package com.yourname.mymod;

import net.minecraft.block.Block;
import net.minecraft.block.material.Material;
import net.minecraftforge.fml.common.registry.GameRegistry;

public class ModBlocks {
    public static Block rubyBlock;

    public static void init() {
        rubyBlock = new Block(Material.IRON)

In your MyMod class, call ModBlocks.init() in the init method.

Step 3: Add Your Block Texture

  • Place your block texture (e.g., ruby_block.png) in src/main/resources/assets/mymod/textures/blocks.

Step 4: Create a Block Item Model JSON

  • In src/main/resources/assets/mymod/models/item, create a JSON file named ruby_block.json:
  "parent": "mymod:block/ruby_block",
  "textures": {
    "all": "mymod:blocks/ruby_block"

Step 5: Test Your Mod

  • Run your Minecraft client through your IDE.
  • If everything is set up correctly, you should be able to find your new “Ruby Block” in the game.


This basic tutorial introduces you to the essentials of Minecraft modding, from setting up your development environment to adding a new block to the game. As you become more comfortable with the process, you can explore adding more complex features such as new items, mobs, and crafting recipes. The world of Minecraft modding is vast and creative, offering endless opportunities for those willing to delve into it. Happy modding!


IDE options


16 Apr 2024

Ready to Boost Your Teen’s Future with Coding?

Best dev enviroments for learning to code


16 Apr 2024

Top 5 Epic Coding Environments for Teens

review kids coding sites

Education, Learn to Code

16 Apr 2024

Top Learn-to-Code Online Sites and Tools for Kids

Convert USD to other currency program

Advanced Placement, Java, Tutorial

4 Apr 2024

Object-Oriented Programming in Java – AP CS A

learn to use replit IDE

Advanced Placement, Java, Tutorial

4 Apr 2024

Exploring Concurrency in Java – AP Exam

Minecraft Mods in Java


4 Apr 2024

Getting Started with Minecraft Forge

Lesson on functions in computer science programming


4 Apr 2024

Preparing to Teach Coding for the First Time

learn to code as a family


4 Apr 2024

In-Person vs. Live Virtual Coding Lessons