How to export and install Minecraft mods

Exporting Minecraft mods

To export your mods, open MCreator and click on the export button which is located in the top toolbar. Enter the mod details and click Export.  MCreator will build all resources and sources. The file save dialog opens. Select a destination and the mod will be exported to a file.

Installing MCreator NeoForge mods

MCreator mods can be installed on both the Minecraft client and server. You will need NeoForge, or Minecraft Forge for versions below and including 1.20.1 in either case.

Installing Minecraft mods on the client

MCreator mods need to have Minecraft Forge installed in order to work. If you use Minecraft Fabric generator, you need to have that installed too. Make sure to use the same version of Minecraft Forge as MCreator uses. You can find out the version of the Minecraft Forge MCreator is using by pressing on the version number in MCreator. The version will be listed in the "about window" that opens. 

MCreator mods are installed in the same way as other forge mods. You simply put your mod into the mods folder. If you don't have a mods folder then make one in your .minecraft folder

If you have trouble installing Minecraft Forge, follow these instructions or read below for more information.

Installing the Minecraft Version

The same game version for the mod/forge must be installed first. 
If you have the Minecraft version installed already then you can skip this step.

  1. Start the Minecraft Launcher
  2. Select Java Edition
  3. Select Installations
  4. Select new installation 
  5. Name your installation e.g. Minecraft Vanilla 1.16.5
  6. Set the version to match the same version as the mod uses.
  7. Set the game directory (See optional steps below.)
Optional Steps

Minecraft likes to through all files into one folder, this can cause game incompatibilities when using mods that are not supported for that game version. It's recommended to select a separate game directory for your installations.

You can use something like the one below to fix this issue. 
.minecraft/installations/Minecraft_Vanilla_1.16.5

Download and Install NeoForge or Minecraft Forge

You will need the same version of Minecraft to forge as the mod/installation you just made, download and stall the version from the official site here: https://files.minecraftforge.net/net/minecraftforge/forge/. For NeoForge, use https://projects.neoforged.net/neoforged/neoforge

  1. Download Minecraft Forge for the same version.
  2. Run the installer and install the client version for your launcher.  
    If on Windows you will need Java installed to run the .jar file.

Make a new mod Installation

  1. Run the Minecraft Launcher.
  2. Make a new installation for your mod profile. Follow the steps in Installing the Minecraft Version section.
  3. Instead of installing a vanilla jar search for your new Minecraft Forge installation
  4. It is important to keep your mod jars separate so it's best to make a custom directory for your forge installation.
  5. Run the game once then close out and move to the next step.

Adding mods

  1. A new folder called mods will be in your root directory for your installation.
  2. Navigate to your mods folder.
  3. Search %appdata% in your Windows search bar.
  4. Open .minecraft then navigate to your installation folder.
  5. Drag and drop your mod .jars into this mods folder.

Run the Installation

Test to make sure the game does not have any problems with the mods. 
If the game does not reach the game menu screen and crashes then could mean you have one or more issues with the mods you have installed.

Troubleshooting
  • A mod could require additional dependencies API, another mod, etc. Read the download sites to ensure you have all the dependencies for the mods you have installed. 
     
  • A mod may have a conflict with another mod, the easiest way to test if this is the the issue is to remove one mod at a time until you can launch the game. If you have mods left over then it could be that the last mod you removed has issues with one of the mods left in the mods folder. Try running the mod without any other mods installed to see if it's a conflict issue if the mod runs properly then it's a conflict issue, try to find out what mod it has the issue with by running one of the remaining mods with the issue mod at a time, when you find an issue with the other mod, you may contact the developer of the mod with the issue to let them know about it. 
     
  • A mod could also have a version mismatch, one of the mods you have installed may be for another Minecraft Forge/Minecraft version. Check the mod download pages for the mod to make sure you're not missing any dependencies and have the right version for the Minecraft/forge version you have installed. 

Video tutorial

If you prefer to watch the video, you can find the wiki page above summarized in a video:



Donate to MCreator

By donating to developers you can speed up development, as with more resources, we can dedicate more time to MCreator. It is a free project made by developers working on it in their free time.