Changes

# Obtain a source distribution from forge’s [https://files.minecraftforge.net/ files] site. (Look for the MDK file type)

# Obtain a source distribution from forge’s [https://files.minecraftforge.net/ files] site. (Look for the MDK file type)

# Extract the downloaded source distribution to an empty directory. You should see a bunch of files, and an example mod is placed in <code>src/main/java</code> for you to look at. Only a few of these files are strictly necessary for mod development, and you may reuse these files for all your projects These files are:

# Extract the downloaded source distribution to an empty directory. You should see a bunch of files, and an example mod is placed in <code>src/main/java</code> for you to look at. Only a few of these files are strictly necessary for mod development, and you may reuse these files for all your projects These files are:

#* build.gradle

#* <code>build.gradle</code>

#* gradlew.bat

#* <code>gradlew.bat</code>

#* gradlew

#* <code>gradlew</code>

#* the gradle folder

#* the <code>gradle</code> folder

# Move the files listed above to a new folder, this will be your mod project folder.

# Move the files listed above to a new folder, this will be your mod project folder.

# Choose your IDE:

# Choose your IDE:

#* For most, if not all, changes to the build.gradle file to take effect Gradle will need to be invoked to re-evaluate the project, this can be done through Refresh buttons in the Gradle panels of both the previously mentioned IDEs.

#* For most, if not all, changes to the build.gradle file to take effect Gradle will need to be invoked to re-evaluate the project, this can be done through Refresh buttons in the Gradle panels of both the previously mentioned IDEs.

# Generating IDE Launch/Run Configurations:

# Generating IDE Launch/Run Configurations:

#*For Eclipse, run the genEclipseRuns gradle task (gradlew genEclipseRuns). This will generate the Launch Configurations and download any required assets for the game to run. After this has finished refresh your project.

#*For Eclipse, run the <code>genEclipseRuns</code> gradle task (<code>gradlew genEclipseRuns</code>). This will generate the Launch Configurations and download any required assets for the game to run. After this has finished refresh your project.

#*or IntelliJ, run the genIntellijRuns gradle task (gradlew genIntellijRuns). This will generate the Run Configurations and download any required assets for the game to run. After this has finished edit your Configurations to fix the “module not specified” error by changing selecting your “main” module.

#*or IntelliJ, run the <code>genIntellijRuns</code> gradle task (<code>gradlew genIntellijRuns</code>). This will generate the Run Configurations and download any required assets for the game to run. After this has finished edit your Configurations to fix the “module not specified” error by changing selecting your “main” module.

=== Customizing Your Mod Information ===

=== Customizing Your Mod Information ===

Edit the build.gradle file to customize how your mod is built (the file names, versions, and other things).

Edit the <code>build.gradle</code> file to customize how your mod is built (the file names, versions, and other things).

{{Colored box|title=Important|content='''Do not''' edit the buildscript {} section of the build.gradle file, its default text is necessary for ForgeGradle to function.}}

{{Colored box|title=Important|content='''Do not''' edit the <code>buildscript {}</code> section of the build.gradle file, its default text is necessary for ForgeGradle to function.}}

Almost anything underneath the // Only edit below this line, the above code adds and enables the necessary things for Forge to be setup. marker can be changed, many things can be removed and customized there as well.

Almost anything underneath the <code>// Only edit below this line, the above code adds and enables the necessary things for Forge to be setup.</code> marker can be changed, many things can be removed and customized there as well.

There is a whole site dedicated to customizing the forge build.gradle files - the [https://forgegradle.readthedocs.org/en/latest/cookbook/ ForgeGradle cookbook]. Once you’re comfortable with your mod setup, you’ll find many useful recipes there.

There is a whole site dedicated to customizing the forge <code>build.gradle</code> files - the [https://forgegradle.readthedocs.org/en/latest/cookbook/ ForgeGradle cookbook]. Once you’re comfortable with your mod setup, you’ll find many useful recipes there.

==== Simple build.gradle Customizations ====

==== Simple build.gradle Customizations ====

These customizations are highly recommended for all projects.

These customizations are highly recommended for all projects.

* To change the name of the file you build - edit the value of archivesBaseName to suit.

* To change the name of the file you build - edit the value of <code>archivesBaseName</code> to suit.

* To change your “maven coordinates” - edit the value of group as well.

* To change your “maven coordinates” - edit the value of <code>group</code> as well.

* To change the version number - edit the value of version.

* To change the version number - edit the value of <code>version</code>.

* To update the run configurations - replace all occurrences of examplemod to the mod id of your mod.

* To update the run configurations - replace all occurrences of <code>examplemod</code> to the mod id of your mod.

=== Building and Testing Your Mod ===

=== Building and Testing Your Mod ===

# To build your mod, run gradlew build. This will output a file in build/libs with the name [archivesBaseName]-[version].jar. This file can be placed in the mods folder of a forge enabled Minecraft setup, and distributed.

# To build your mod, run <code>gradlew build</code>. This will output a file in <code>build/libs</code> with the name <code>[archivesBaseName]-[version].jar</code>. This file can be placed in the <code>mods</code> folder of a forge enabled Minecraft setup, and distributed.

# To test run with your mod, the easiest way is to use the run configs that were generated when you set up your project. Otherwise, you can run gradlew runClient. This will launch Minecraft from the <runDir> location, including your mod code. There are various customizations to this command. Consult the [https://forgegradle.readthedocs.org/en/latest/cookbook/ ForgeGradle cookbook] for more information.

# To test run with your mod, the easiest way is to use the run configs that were generated when you set up your project. Otherwise, you can run <code>gradlew runClient</code>. This will launch Minecraft from the <code><runDir></code> location, including your mod code. There are various customizations to this command. Consult the [https://forgegradle.readthedocs.org/en/latest/cookbook/ ForgeGradle cookbook] for more information.

# You can also run a dedicated server using the server run config, or gradlew runServer. This will launch the Minecraft server with its GUI.

# You can also run a dedicated server using the server run config, or <code>gradlew runServer</code>. This will launch the Minecraft server with its GUI.

{{Colored box|title=Note|content=It is always advisable to test your mod in a dedicated server environment if it is intended to run there.}}

{{Colored box|title=Note|content=It is always advisable to test your mod in a dedicated server environment if it is intended to run there.}}