Modifications to the Minecraft base files to assist in compatibility between mods.
Java
Permalink
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 Do not install mod_list.json for optional mods. Nov 17, 2016
mdk Added gradle.properties to MDK (#3361) Dec 5, 2016
patches/minecraft/net/minecraft Prevent a crash when scheduling block updates for non-existing blocks #… Dec 5, 2016
src Enable Enforcement of modid formatting. Must be lowercase and <= 64 c… Dec 9, 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
EnergySystems.md Create EnergySystems.md Sep 13, 2016
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 Update readme to be a little more clear. Oct 23, 2016
build.gradle Fix AbstractMethodException in FML Registries. Closes #3427 Nov 21, 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 Update assets to new Forge brand (#3464) Nov 30, 2016
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 setupForge or gradlew setupForge. This will download and setup all the bits you need to have a functional Forge workspace.

After that, open a workspace in your favorite IDE and import existing projects the projects folder.

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.