A Minecraft mod is a type of modification that changes parts of the sandbox game Minecraft. These mods can add new content to the game, adjust specific features, and improve how the game runs. Thousands of mods have been created for Minecraft, and some have helped their creators earn money. Although Mojang Studios does not offer an official tool for modding, community-developed tools help developers create and share mods. The widespread use of Minecraft mods is believed to have contributed to Minecraft becoming one of the best-selling video games ever. As of March 2025, more than 250,000 mods for Minecraft are available on websites like CurseForge, Modrinth, and PlanetMinecraft.

The earliest Minecraft mods worked by breaking down and changing the Java code of the game. The original version of the game, now called Minecraft: Java Edition, is still modified this way, but with more advanced tools. Minecraft: Bedrock Edition, which is available for mobile devices, consoles, and Microsoft Windows, is written in C++. Because of this, it cannot be modified the same way as Java Edition. Instead, players use "add-ons" written in a scripting language to add new content to the game.

Background

Minecraft: Java Edition (available for Windows, macOS, and Linux) can be modified on the player's computer, on servers, or on both at the same time. Modifications made on the player's computer can change how the game looks and some of its actions. Modifications made only on servers (called plugins) can change how the game works and often add features like mini-games, anti-cheat systems, or login systems. For more complex changes, such as adding new blocks, items, creatures, or worlds, or changing existing features, the same modification must be added to both the player's computer 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 player's computer, but this does not offer all the abilities of traditional computer-based modifications. In single-player mode, the player's computer acts as both the client and server, allowing it to run both types of modifications. However, some modifications must be installed on a dedicated server, as noted by the "Dedicated servers only" label on their Modrinth pages.

Modifications on the player's computer can slow down older or less powerful computers, especially when many modifications are used together in a group called a "modpack." These changes are possible because the community studies and analyzes Minecraft's 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. The game's development team has an informal relationship with many mod creators. Some mod developers have later worked at Mojang after creating popular modifications. Popular places to find modifications include CurseForge and Modrinth. Most Minecraft modifications are free, created as a hobby. Some mod 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 modify Bedrock versions have an easier process because these versions include official support for "add-ons," which are simpler to install than Java Edition modifications and do not require special tools. However, add-ons in Bedrock Edition have fewer features and options because they can only change parts of the game that Mojang has made available.

In 2012, Mojang announced plans to create a storage system for Minecraft modifications. Minecraft's creator, Markus "Notch" Persson, said in 2012 that he was initially unsure about modifications, worried that user-created content might change his vision for the game. Persson later changed his mind, stating that 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. These additions are 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 development 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 of these was hMod, which provided tools to help manage servers. Michael Stoyke, known as Searge, later worked for Mojang, and he created the Minecraft Coder Pack (MCP). This tool was later renamed Mod Coder Pack (MCP), keeping the same acronym. MCP allowed users to convert and reorganize Minecraft's code. It could also reassemble and obscure new or changed code, which could be added to the game. However, if multiple mods changed the same base code, it could cause errors. To fix this, Risugami's ModLoader was developed to prevent conflicts between mods.

By late 2010, Minecraft was preparing to enter its beta phase. Popular mods like IndustrialCraft, Railcraft, and BuildCraft were released during this time. These mods added significant new content and mechanics, unlike earlier mods that only made small changes.

In December 2010, a project called Bukkit began development. It aimed to replace hMod after its development slowed. Bukkit was released in 2011 and included a GPL-licensed API for creating plugins that modified Minecraft servers. It also included "CraftBukkit," a modified version of Minecraft's software that allowed Bukkit to run. Like hMod, Bukkit let server owners install plugins to change how servers handled player input and output without requiring players to install client-side mods.

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

In November 2011, Forge Mod Loader and Minecraft Forge were released. Forge allowed players to use multiple mods at once, using Mod Coder Pack mappings. A server version of Forge was also created, enabling modded servers. Forge eliminated the need to alter base source code, allowing separate mods to work together without touching the base code. 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 mod creators 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 a separate plugin API from Spigot, allowing Spigot plugins to work together. Many popular Minecraft servers use BungeeCord to link servers.

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 changing code directly.

Concern arose in mid-2014 after Microsoft acquired Mojang. Some modders worried that Microsoft might end Mojang's policy of allowing free mod development. However, Microsoft did not change Mojang's policies, and modding continued as before.

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

In July 2015, a "Windows 10" version of Minecraft was announced. Unlike earlier versions, it was programmed in C++. Fans worried that Java-based versions might be phased out, making modding harder. Mojang developer Tommaso Chechi reassured players on Reddit that Java-based versions would not be discontinued.

In April 2017, Mojang announced the Minecraft Marketplace, a digital store where players could sell user-created content for the Windows 10 version of the game. This store focused on adventure maps, skins, and texture packs. PC World noted that this change brought the Windows 10 version closer to the moddable worlds 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 work 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 that it would remove obfuscation from Java Edition's source code. This change aimed to make mod development faster 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 has over 200,000 mods.

Some mods improve parts of the game. For example, Journeymap adds a mini-map to the screen. Just Enough Items includes 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 other game elements. Julia Lee from Polygon said she "cannot live without" tools like a hammer that breaks large blocks quickly and an axe that cuts down whole trees.

Some mods help the game run better on older computers or support new features like using multiple parts of the computer’s processor at once. Optifine improves performance and adds support for high-quality images, lighting effects, and custom visual styles. Distant Horizons adds a system that reduces detail far from the player, allowing the game to show more of the world.

Mods are sometimes grouped into downloadable collections called "modpacks." These are easy to download and use without needing to know how to set up a modded game. People who create these modpacks often use special files and custom images to manage how the mods work together.

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 help players build faster than they could without the mod. WorldEdit is one of the most popular building tools in Minecraft, used in patents and scientific studies. It was first released in 2010 as a plugin for a different mod and later adapted for other platforms.

Minecraft: Bedrock Edition supports add-ons that use the game’s built-in mod system. Free and paid add-ons are available on the Minecraft Marketplace since 2024. Players can also find free add-ons on websites like MCPEDL and CurseForge.

Minecraft: Legacy Console Edition, an older version of the game for consoles, did not support user-created mods because the consoles had limited features. In 2026, the source code for a 2014 version of this edition was shared online. People then made a PC version of the game and began creating mods for it.

Minecraft mods have sometimes been used to spread harmful software. In March 2017, a company called ESET found 87 examples of harmful programs disguised as Minecraft mods on the Google Play Store. These programs showed ads or tricked players into downloading other apps, and together they were downloaded over 1,000,000 times.

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

In July 2023, a security weakness was found in some Forge-based mods, like BdLib and EnderCore. This weakness allowed harmful code to run and was named "BleedingPipe" by Minecraft security experts. The weakness existed since 2017, but it became widely known after a blog post by MMPA, which led to more use of the vulnerability before fixes were made.

Reception

In 2011, PC World’s Nate Ralph described installing mods for Minecraft as a complicated process. However, he noted that this method could help players who want more from the game experience.

In 2013, Max Eddy of PC Magazine discussed the difficulty of setting up a game with mods. He said the process seemed complex and that he was initially too nervous to try modding Minecraft. However, he later found that modding Minecraft was not too hard once he started. Eddy also mentioned that Mojang’s fast updates for the main game have made it harder for popular mods to keep up with changes.

In July 2013, the Minecraft mod Galacticraft was named the featured mod for the week in PC Gamer.

George Avalos of the San Jose Mercury News stated that mods are suitable for people who enjoy games widely. However, he warned that care should be taken to avoid downloading harmful or unwanted programs when searching for Minecraft mods. Avalos also noted that installing mods may require help from an adult, even though Minecraft often appeals to children.

Official support

Minecraft mods are known for helping children learn coding and programming. Many educational projects have been created to teach students how to code using Minecraft. These include LearnToMod, ComputerCraftEdu, and Minecraft: Pi Edition, which are all available for free to teachers. Schools have also used Minecraft in programming classes, such as those started by the University of California, to teach children aged 8–18 how to create applications.

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

In The Parent's Guidebook to Minecraft, author Cori Dusmann explains that homeschooling and Minecraft work well together. She notes that creating simple mods can show scientific ideas, and homeschooling providers often support this approach.

Tom Bennett, an adviser to the British government, disagreed with using Minecraft in schools. He called it a gimmick and suggested schools should focus on books instead. However, some journalists from The Guardian argued that using Minecraft in schools was a valuable new idea.

Mod developer Dr. Zhark added horses to the game through the Mo' Creatures mod. Later, he helped Mojang include horses in the original version of Minecraft. Pistons were first created by another developer, Hippoplatimus, in a mod. Mojang liked the idea so much that they added pistons to the main game. Kingbdogz, the creator of The Aether mod, which adds a new world to the game, was hired by Mojang in January 2020.

Mojang acknowledged the work done on the Bukkit project, which is a tool for modifying Minecraft servers. In 2012, the company hired the lead developers of Bukkit.