From Minecraft Forge
Jump to: navigation, search

These are the instructions for Minecraft Forge installation. Note: Since Minecraft 1.6.1, installation works differently, and Forge appears in the form of profiles! We still support the legacy launcher installation instructions, but Forge is much easier to install for versions newer than Minecraft 1.6.1.



First, you will have to download everything you need. You're going to need a fresh:

Note: DO NOT install ModLoader or ModLoaderMP. Forge contains FML, which is a superior replacement for ModLoader and ModLoaderMP.

Post-1.6.1 Minecraft Forge (using installer)

For 1.6.1 and later, the process of installation is quite radically changed. However, it's much, much easier.


Use the vanilla launcher to play the vanilla game once. You do not need to actually start a world or connect to a server, but you do need to bring up the menu.


Next, download the installation file by clicking on the "Installer" button. If you are new to Minecraft Forge, click the "Install" link under the "Downloaded Recommend" box if it is available. Pass through and download the file.

Open Installer

The file will be of type JAR. Depending on your system, running JAR files may be different.


Right click on the JAR file and select Open With > Java. If you are unable to open the JAR file with Java, take a look at this video on restoring your JAR file association.


You may need to right click the file and select properties. Enable the box under 'Permissions' which says 'Allow executing file as a program'. Close the window to save your changes. Next, right click in the Download folder and select 'Open Terminal'. Type java -jar <filename>.

Complete Install

If you are playing Minecraft Forge, click "Install client". To install a server, click "Install server".


Click "Next" and it should say "Successfully installed Forge build xxxxx". This will create a profile called "Forge" in the launcher. Click on that to log in and begin playing. Let the green bar at the bottom fill first, then Minecraft Forge should launch.

To add mods, just go to:

Windows: %appdata%/.minecraft/mods

Unix: ~/Library/Application Data/Minecraft/mods

like it always was at.

Client Video Tutorials

If you prefer, a full YouTube video tutorial for installing Minecraft Forge for clients is available for the following post-1.6.1 versions:

NOTE: Each version here is installed fairly similarly.

Video tutorials for Windows-based computers:

Minecraft Version Video Link

Video tutorials for Mac-based computers:

Minecraft Version Video Link

Video tutorials for Linux-based computers:

Minecraft Version Video Link


The installer will install minecraft_server.jar and a bunch of other things onto your system. Make sure to choose a path to extract everything to! After that, normally use the Forge server jar as a server to double-click on for GUI, or command line using batch/shell scripts.

Server Video Tutorials

If you prefer, a full YouTube video tutorial for installing Minecraft Forge for servers is available for the following versions:

NOTE: Each version here is installed fairly similarly.





Headless (no GUI) servers

As of Forge 1.6.2-, the installer has a three command line options, -h/--help, --extract and --installServer (all of them are case sensitive). -h/--help will just print out the command line usages. --installServer and --extract both function just like in the installer's GUI, but with no option to pick a path to an install location and places the files into the working directory.

Prior builds of Forge do not have this functionally. Use the installer on your local system to install the server to an empty folder and copy the contents to the remote headless server.

Compatibility with non-Forge mods

Use mods not written with FML at your own risk. The following pages might help: OptiFine Compatibility Guide

Pre-1.5.2 Minecraft Forge

Note: The new minecraft launcher allows you to run version 1.5.2 or lower of minecraft. However, the method it uses to do this is incompatible with the Pre-1.5.2 Minecraft Forge versions. If you want to run a 1.5.2 version of minecraft with forge installed you need to delete or rename your old .minecraft folder and build your .minecraft instance from scratch using the old launcher - found here.

Install Forge

Open your minecraft.jar file and the universal zip file. Drop the contents of the zip file into minecraft.jar then delete the files in META-INF which begin with MOJANG.

To complete the forge installation - start minecraft and log in. Minecraft will then download some more instal files from and install them to .minecraft/lib. However, it will fail to find two files - bcprov-jdk15on-148.jar and scala-library.jar. For some reason these two files are on the but have been renamed scala-library.jar.stash and bcprov-jdk15on-148.jar.stash. So you need to manually download bcprov-jdk15on-148.jar.stash and scala-library.jar.stash to .minecraft/lib and remove the .stash extension from the file names. After doing this - restart minecraft and login again. The final forge setup phase should then complete.

If using a mod manager, place the forge zip under the jarmods section.

Vanilla Server

Thanks to the work of cpw, now Forge can be installed without modifying the server jar! THIS ONLY WORKS FOR BUILD 315 AND ABOVE!!!

Place the universal zip into the same folder where your minecraft_server.jar is, then change the extension of the forge zip to a .jar. Run it.

Optionally, you may use java -jar in a command prompt.

Install Other Mods

Finally, just follow the installation instructions for the other mods you are using. Typically you place them in the mods or coremods folder.

  • It should be noted that NO instructions are better than INCOMPLETE instructions. (i.e. Just place the packages into the mods folder)
Personal tools