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 seriously, Forge is much easier to install after Minecraft 1.6.1! As of this writing, THE NEW LAUNCHER WORKS WELL, BUT IT IS NOT RECOMMENDED YET!! If you are all about stability, stick to 1.5.2.



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 "installer". If you are new to Minecraft Forge, click the Install link next to the recommended version. 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.


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.



1.6.1 and 1.6.2:






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.

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.

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