Exporting mods and installing them

Exporting 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 destination and the mod will be exported to a file. Make sure to follow our Terms of use when distributing and using mods made with MCreator.

Installing MCreator mods

MCreator mods can be installed on both Minecraft client and server. You will need Minecraft Forge in either case.

Installing MCreator mods on client

MCreator mods need to have Minecraft Forge to work. 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 below to fix this issue.
.minecraft/installations/Minecraft_Vanilla_1.16.5

Download and Install 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/.

  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 mew 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 its 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 miss match, one of the mods you have installed may be for another  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. 

Installing MCreator mods on the server

Some of the mods may not work on servers, especially the ones made with an older version of MCreator.

If Minecraft server starts normally, you can use the same exported zip/jar file for the server. To install forge and your mod to a server, use this guide: http://www.minecraftforge.net/forum/index.php?topic=1976.0

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.