Modifications to the Minecraft base files to assist in compatibility between mods.
Java
Latest commit 0c8f51b Aug 23, 2016 @pau101 pau101 committed with LexManos Fix item use stats (#3216)
Failed to load latest commit information.
gradle/wrapper Update gradle wrapper to 2.14, reference MC json, and add java6 compa… Aug 21, 2016
jsons Update gradle wrapper to 2.14, reference MC json, and add java6 compa… Aug 21, 2016
mdk Update gradle wrapper to 2.14, reference MC json, and add java6 compa… Aug 21, 2016
patches/minecraft/net/minecraft Fixed decorate event being called with SHROOM type for both convered … Aug 22, 2016
src Fix item use stats (#3216) Aug 23, 2016
.gitattributes Updated the forge logo to a higher-quality GIF file. Closes #2276. Dec 30, 2015
.gitignore 1.9.4 Update. May 18, 2016
CONTRIBUTING.md Update CONTRIBUTING.md Jun 22, 2016
CREDITS-fml.txt FML is no more. FML has ceased to be. FML's expired and gone to meet … Aug 2, 2015
LICENSE-fml.txt FML is no more. FML has ceased to be. FML's expired and gone to meet … Aug 2, 2015
LICENSE-new.txt Update LICENSE-new.txt Apr 28, 2016
MinecraftForge-Credits.txt Step 3: The Rebirth Nov 10, 2013
MinecraftForge-License.txt Small wording change in license to allow for specifc differnet licnen… Apr 7, 2014
Paulscode IBXM Library License.txt Step 3: The Rebirth Nov 10, 2013
Paulscode SoundSystem CodecIBXM License.txt Step 3: The Rebirth Nov 10, 2013
README.md Lets make a half-decent readme. Thanks to Rorax for the install video! Jul 13, 2016
README.txt Update README.txt Aug 6, 2014
build.gradle Update build.gradle to not append the branch name if it matches the m… Jul 7, 2016
gradlew Added FG2 buildscript + updated for Gradle 2.4 Jun 30, 2015
gradlew.bat Added FG2 buildscript + updated for Gradle 2.4 Jun 30, 2015
icon.ico Added FG2 buildscript + updated for Gradle 2.4 Jun 30, 2015
l4jManifest.xml Added FG2 buildscript + updated for Gradle 2.4 Jun 30, 2015
settings.gradle fixed versioning and stuff Nov 10, 2013

README.md

How to install Forge: For Players

Go to http://files.minecraftforge.net and select the minecraft version you wish to get forge for from the list.

You can download the installer for the Recommended Build or the Lastest build there. Latest builds may have newer features but may be more unstable as a result. The installer will attempt to install forge into your vanilla launcher environment, where you can then create a new profile using that version and play the game!

Here is a short video from Rorax showing how to install and setup Forge.

HOWTO Install Forge

For support and user questions, visit http://www.minecraftforge.net.

How to install Forge: For Modders

If you wish to setup a new mod for Forge, visit http://files.minecraftforge.net and select the MDK download.

This is the Modder Developer Kit - basically, an example mod with all the tooling needed to create a Forge mod workspace ready for use in your IDE of choice.

Here is a short video from @cpw showing how to install and setup the MDK in Intellij.

HOWTO Install MDK

How to install Forge: For those wishing to work on Forge itself

If you wish to actually inspect Forge, submit PRs or otherwise work with Forge itself, you're in the right place! Clone this (either directly, or make a Fork first if you want to make a PR) and run gradlew.bat setup or gradlew setup. This will download and setup all the bits you need to have a functional Forge workspace.

Here is a short video from @cpw showing how to install and setup Forge in Intellij.

HOWTO Install MDK

Pull requests

Pull requests should target the current default branch. Currently, that is the 1.10.x branch for Minecraft 1.10.2.

If you intend to modify a minecraft patch, or add a new one, always run gradlew genPatches to generate your patch and validate that you are not doing anything unexpected in your patch.

Contributor License Agreement

As stated in the (https://github.com/MinecraftForge/MinecraftForge/blob/1.10.x/LICENSE-new.txt) file, we require all contributors to acknowledge the Forge Contributor License Agreement. Please ensure you have a valid email address associated with your github account to do this. If you have previously signed it, you should be OK.