Czech, Thai, and Turkish language wikis are now available. Please help with translating!

Mods/Installing OptiForge/Manual Install/Fresh

From Minecraft Wiki
Jump to: navigation, search

This guide will help you install the latest Minecraft Forge and OptiFine.

Step 1. Finding your .minecraft directory[edit | edit source]

Before you begin you must find your .minecraft directory. This directory will not exist if you have not run the minecraft launcher at least once. This tutorial will work from within this folder.

OS Path
Linux ~/.minecraft
Windows %appdata%\.minecraft
Mac OS X ~/Library/Application Support/minecraft

In many Linux file managers dot files (files and folders prefixed with a period ".") will be hidden. In Nautilus press ctrl+h to toggle the display of dot files.

Step 2. Download Minecraft[edit | edit source]

First you must download a copy of vanilla Minecraft. Skip this step if you have already downloaded the Minecraft version you would like to use. You can either choose to use the Minecraft launcher or download it manually.

Option A. Using the 1.1.1 (5) Launcher (Easy)[edit | edit source]

1. Download the official Minecraft launcher from here: and then open it with Java. In some Linux distributions you must first set the file's executable bit if opening it with xdg-open.

2 (Optional). If you want to use a specific version other than the latest version, click "Edit Profile", then click on your desired Minecraft version from the drop down menu labelled "Use version". Save profile when done.

3. Press play. This will download a copy of your chosen Minecraft version. You can then exit out of Minecraft and continue.

Option B. Download manually[edit | edit source]

1. Select a Minecraft version you wish to use. The version string will follow the format of either "1.6.2" for a full release, or "13w26a" for a development snapshot. For a complete list of versions see This tutorial will use "1.6.2" as it's the latest version at the time of writing.

2. Download the Minecraft jar file. This will be located at "<version>/<version>.jar", replacing "<version>" with the version you chose. For 1.6.2 this will be Save this file to "versions/<version>/<version>.jar" inside your minecraft folder, which would be "versions/1.6.2/1.6.2.jar" for 1.6.2. You will need to create these directories yourself.

Linux (using wget):

wget -cO "$HOME/.minecraft/versions/1.6.2/1.6.2.jar" \

3. Download the Minecraft version json file. This follows the same procedure as above. Download the file "<version>/<version>.json" ( and save to "versions/<version>/<version>.json" ("versions/1.6.2/1.6.2.json")

Linux (using wget):

wget -cO "$HOME/.minecraft/versions/1.6.2/1.6.2.json" \

Step 3. Copy to a new Minecraft version[edit | edit source]

1. In your "versions" directory, create a copy of your selected vanilla Minecraft version ("1.6.2") and give the copy a new name. The name of this folder will be the name of your new Minecraft version. For this guide we'll use "1.6.2 OptiForge"


cp -R "$HOME/.minecraft/versions/1.6.2" "$HOME/.minecraft/versions/1.6.2 OptiForge"

2. You must also rename the .jar and .json files to match. Rename the new "1.6.2.jar" to "1.6.2 OptiForge.jar", and "1.6.2.json" to "1.6.2 OptiForge.json".


mv "$HOME/.minecraft/versions/1.6.2 OptiForge/1.6.2.jar" \
  "$HOME/.minecraft/versions/1.6.2 OptiForge/1.6.2 OptiForge/1.6.2.jar"
mv "$HOME/.minecraft/versions/1.6.2 OptiForge/1.6.2.json" \
  "$HOME/.minecraft/versions/1.6.2 OptiForge/1.6.2 OptiForge/1.6.2.json"

Your directory structure should now look something like this:

  • .minecraft
    • versions
      • 1.6.2 OptiForge
        • 1.6.2 OptiForge.jar
        • 1.6.2 OptiForge.json

3. You now need to modify the .json file and replace the old version name with the new one. Open the .json file in your favorite modern text editor. It is recommended not to use Windows Notepad.

4. Look for "id": "1.6.2", where "1.6.2" is the vanilla version you chose to start with. Change the 1.6.2 to the version name you chose: "id": "1.6.2 OptiForge". Save the file when you're done.

Linux (using Python):

python -c "import sys,json;v=sys.argv[1];f=open('$HOME/.minecraft/versions/\
ps(d,sort_keys=True,indent=2));f.truncate()" "1.6.2 OptiForge""

Replace the "1.6.2 OptiForge" at the end with your version name if it differs.

Step 4. Install Forge and OptiFine into the new version[edit | edit source]

You will now download Forge and OptiFine into the .json file. The rest of this guide is continued on this page: Modify an existing Minecraft version. You will use the new minecraft version you just created as the existing version in that guide.