A Minecraft mod is a change to the sandbox game Minecraft. These mods can add new items, change game features, and make the game run better. Thousands of mods have been created for the game, and some authors earn money from their work. Mojang Studios does not provide an official API for modding, but community tools help developers create and share mods. The popularity of these mods has helped Minecraft become one of the best-selling video games. As of March 2025, there are more than 250,000 mods available on sites like CurseForge, Modrinth, and PlanetMinecraft.

The first Minecraft mods worked by changing the Java code of the game. The original version, now called Minecraft: Java Edition, is still modified this way, but with better tools. Minecraft: Bedrock Edition, which runs on mobile devices, consoles, and Windows, uses a different programming language called C++. Because of this, modders cannot change the code directly. Instead, they use special tools called "add-ons" written in a scripting language to add new content.

Background

Minecraft: Java Edition (available for Windows, macOS, and Linux) can be modified on the client (the version of the game installed on a player’s computer), on servers, or on both at the same time. Client modifications can change how the game looks and some of its actions. Server-only modifications, often called plugins, can change how the game works and may add features like mini-games, anti-cheat systems, or login systems. For more complex changes, such as adding new blocks, items, creatures, or game areas, or changing existing parts of the game, the same modification must be added to both the client and the server so they can work together. Some modern server plugins can create the appearance of new items or blocks by combining server rules with special files sent to the client, but this method does not offer all the abilities of traditional client modifications. In single-player mode, the client acts as both the player’s device and the server, allowing it to run both client and server modifications. However, some modifications must be installed on a dedicated server, as noted by the "Dedicated servers only" label on their pages on Modrinth.

Client modifications can slow down older or weaker computers, especially when many modifications are used together in a collection called a "modpack." These changes are possible because the community studies Minecraft’s source code, which is written in Java, to create new features.

Although Mojang does not officially support Minecraft modifications, they are allowed to be created and shared online. Mojang’s development team has an informal relationship with many mod creators. Some developers who made popular modifications later worked at Mojang. Popular places to find modifications include CurseForge and Modrinth. Most Minecraft modifications are free, created as a hobby. Some creators earn money through ads on download sites or crowdfunding. This income has allowed some developers to work full time or start small game studios focused on modifications or modding tools.

Modifying the mobile and console versions of Minecraft, which use the Bedrock codebase, is different because these versions are written in C++ instead of Java. Players who want to modify these versions have an easier process because the Bedrock codebase includes built-in support for "add-ons." These add-ons are simpler to install than Java Edition modifications and do not require special tools. However, add-ons in Bedrock Edition have fewer options because they can only change parts of the game that Mojang specifically allows.

In 2012, Mojang announced plans to create a repository for Minecraft modifications. Minecraft’s creator, Markus "Notch" Persson, said in 2012 that he was initially unsure about modifications, worried they might interfere with his vision for the game. He later changed his mind, saying modifications are "a huge reason of what Minecraft is." Minecraft 1.13 introduced a feature called "data packs," which allows players or server managers to add new content to the game. This content is limited to improving existing features, such as adding new recipes, changing what items blocks drop when broken, or running commands in the game.

History

The first version of Minecraft was released in May 2009. However, client-side modding became popular only after the game reached its alpha stage in June 2010. During the Indev and Infdev stages, only a few client-side mods with small changes to the game were created.

When Minecraft Alpha was released, the first server-side mods appeared. One example was hMod, which provided basic tools to manage a server. Michael Stoyke, also known as Searge (who later worked for Mojang), created Minecraft Coder Pack (MCP). This tool was later renamed Mod Coder Pack (MCP). MCP allowed users to take apart and make easier to understand Minecraft’s code. It could then reassemble and scramble new or changed code, which could be added to the game. However, if multiple mods changed the same code, it could cause errors. To fix this, Risugami’s ModLoader was created to prevent conflicts from overlapping changes.

By late 2010, Minecraft was preparing for its beta phase. Popular mods like IndustrialCraft, Railcraft, and BuildCraft were first released during this time. Unlike earlier mods, these added major new features and mechanics to the game.

In December 2010, a project called Bukkit began development. It aimed to replace hMod after its development slowed. Bukkit included a GPL-licensed API for creating server plugins and a modified version of Minecraft called CraftBukkit, which allowed the API to run. Like hMod, Bukkit let server owners add plugins to change how the server handled player input and output without requiring players to install client-side mods.

In mid-2011, CurseForge, a website for hosting user-created game content, added forums and a section for Minecraft mods. Initially, it linked to Bukkit plugins hosted on Bukkit’s website.

In November 2011, Forge Mod Loader and Minecraft Forge were released. Forge allowed players to run multiple mods at the same time using Mod Coder Pack mappings. A server version of Forge was also created, enabling modded servers. Forge eliminated the need to alter the base source code, allowing separate mods to work together without conflicting. It also included tools that made mod development easier. Forge could be used on Android devices through PojavLauncher, which let players run Minecraft: Java Edition on mobile platforms. Development of PojavLauncher later stopped, and Amethyst launcher became its replacement.

After Minecraft’s full release in November 2011, the modding community grew. In February 2012, Mojang hired Bukkit developers to create an official modding API, giving modders easier access to Minecraft’s files. Bukkit was then maintained by the community.

A version of CraftBukkit called Spigot was developed, which was backward compatible with plugins. In 2012, Spigot released BungeeCord, a server software that connected multiple servers through a proxy. BungeeCord had its own plugin system, allowing Spigot plugins to work alongside it. Many popular Minecraft servers use BungeeCord to link servers together.

In early 2014, a server software called Sponge was released. It had a powerful plugin API compared to Bukkit and supported Forge mods. Sponge also introduced mixins, an alternative to modifying code directly.

When Microsoft acquired Mojang in mid-2014, some modders worried that Microsoft might change Mojang’s policies on modding. However, Microsoft did not alter these policies, and modding continued as before.

In April 2015, Microsoft added a Minecraft Mod Developer Pack to Microsoft Visual Studio, giving users an easier way to create mods. The pack was released as open source and free.

In July 2015, a "Windows 10" version of Minecraft was announced. This version used C++ instead of Java, raising concerns that Java-based versions might be phased out, which could limit modding. Mojang developer Tommaso Chechi reassured fans on Reddit that Java-based versions would not be discontinued.

In April 2017, Mojang announced the Minecraft Marketplace, a platform for selling user-created content for the Windows 10 version of the game. This store focused on adventure maps, skins, and texture packs, bringing the Windows 10 version closer to the moddable features of the original Java Edition.

In December 2018, a new modding toolchain and loader called Fabric was released. Fabric became one of the most widely used modding tools for Minecraft.

In April 2022, a fork of Fabric called Quilt was released. Quilt is designed to be compatible with mods created for Fabric.

In July 2023, many Forge developers and contributors announced they were splitting from the project to create a new fork called NeoForge.

In October 2025, Mojang Studios announced the removal of obfuscation from Java Edition’s source code. This change aimed to make mod development "quicker and easier."

Mod content

It is hard to count all the mods for Minecraft: Java Edition because there are so many. As of March 2025, CurseForge lists more than 200,000 mods.

Some mods improve parts of the game. For example, Journeymap and Xaero's Minimap add a mini-map to the screen. Just Enough Items adds a tool to view crafting recipes. Chisel adds new versions of blocks to make the game look better. Other mods add new areas, plants, worlds, food, armor, tools, and more. A reviewer named Julia Lee from Polygon said she finds modded tools like a hammer that breaks large blocks and an axe that cuts whole trees very useful.

Some mods help the game run faster on older computers or add new features like using multiple computer parts at once or showing more detail. Optifine improves performance and adds support for high-quality images, lighting, and special effects. Distant Horizons adds a system that reduces detail far from the player and increases the distance the game can show from 32 to 1,024 chunks.

Mods are sometimes grouped into downloadable collections called "modpacks." These are easy to download and play without needing to know how to set up a modded game. Creators can manage how the mods work together using settings and custom images.

WorldEdit is a tool made by EngineHub that helps players build structures and create custom landscapes. It includes tools like brushes and block changers, and actions like copying, pasting, and filling shapes. These tools can speed up building because they add features the game does not include. WorldEdit is one of the most popular building tools, used in patents, scientific papers, and was first released in 2010 as a plugin. It has since been adapted for other platforms.

Minecraft: Bedrock Edition supports add-ons that work with the game's built-in mod system. Free and paid add-ons are available on the Minecraft Marketplace since 2024. Free user-made add-ons can also be downloaded from websites like MCPEDL and CurseForge.

Minecraft: Legacy Console Edition, an older version of the game for consoles, did not support mods except for official DLC packs because the consoles had limited access. In 2026, the source code for a 2014 version of Legacy Console Edition was shared online. Players then created a version for computers and started making mods for it, adding features from newer Minecraft versions.

Malicious software has sometimes been spread through Minecraft mods. In March 2017, a company named ESET found 87 fake mods on the Google Play Store that acted as malware. These mods showed ads or tricked players into downloading other apps, and together they were downloaded over 1,000,000 times.

In June 2023, attackers added malware to popular mods and modpacks like "Better Minecraft," which was named "Fractureiser" after the account used to share it.

In July 2023, a security flaw was found in some Forge-based mods, like BdLib and EnderCore. The malware was called "BleedingPipe" by the Minecraft security community. It used a mistake in how some mods handled data. This problem existed since 2017, but it became widely known after a blog post by MMPA, which led to more use of the flaw before fixes were made.

Reception

In 2011, PC World's Nate Ralph described installing mods for Minecraft as a complicated process, but he noted that it could help players who want more from the game.

In 2013, Max Eddy of PC Magazine said setting up a game with mods seemed difficult at first. He admitted he was too nervous to try modding Minecraft at first, but later found that modding was actually easy to learn. However, he also pointed out that Mojang's quick updates for the main game have made it harder for popular mods to keep up.

The Minecraft mod Galacticraft was featured as "mod of the week" in PC Gamer in July 2013.

George Avalos of the San Jose Mercury News stated that mods are suitable for people who enjoy games widely, but warned that care must be taken to avoid downloading harmful or unwanted software when searching for Minecraft mods. He also noted that installing mods may need help from an adult, even though Minecraft is often played by children.

Official support

Minecraft mods helped children learn coding and programming. Educational projects like LearnToMod, ComputerCraftEdu, and Minecraft: Pi Edition were created to teach students coding. These tools are free for teachers to use. The University of California also started programming classes using Minecraft to teach children aged 8–18 how to create applications.

In 2011, "MinecraftEDU" was made as a paid mod for schools. It allowed teachers to use Minecraft to teach subjects like language, history, and art. In 2016, Microsoft bought MinecraftEDU and turned it into a separate version called "Minecraft: Education Edition."

In The Parent's Guidebook to Minecraft, author Cori Dusmann wrote that homeschooling and Minecraft work well together. She explained that making simple mods can show scientific ideas, which homeschooling teachers find helpful.

Tom Bennett, a British government adviser, disagreed with using Minecraft in schools. He called it a gimmick and said schools should focus on books instead. Some journalists from The Guardian disagreed, saying Minecraft in schools was a useful new idea.

Dr. Zhark added horses to Minecraft through the Mo' Creatures mod. Later, he helped Mojang include horses in the main game. Pistons were first created by a mod from Hippoplatimus. Mojang liked them so much they added them to the main game. Kingbdogz, who made the popular The Aether mod, was hired by Mojang in 2020.

Mojang said they respected the work done on the server modding tool Bukkit. In 2012, they hired the main developers of Bukkit.