Building a Mod (FabricMC#502)

Co-authored-by: Miroma <its.miroma@proton.me>

Author: cassiancc

.vitepress/sidebars/develop.ts

@@ -30,6 +30,10 @@ export default [
         text: "develop.getting_started.generating_sources",
         link: "/develop/getting-started/generating-sources",
       },
+      {
+        text: "develop.getting_started.building_mod",
+        link: "/develop/getting-started/building-a-mod",
+      },
       {
         text: "develop.getting_started.tips_and_tricks",
         link: "/develop/getting-started/tips-and-tricks",

develop/getting-started/building-a-mod.md

@@ -0,0 +1,55 @@
+---
+title: Building a Mod
+description: Learn how to build a Minecraft mod that can be shared or tested in a production environment.
+authors:
+  - cassiancc
+  - cputnam-a11y
+  - gdude2002
+  - Scotsguy
+---
+
+Once your mod is ready for testing, you're able to export it into a JAR file which can be shared on mod hosting websites, or used to test your mod in production alongside other mods.
+
+## Choose Your IDE {#choose-your-ide}
+
+<ChoiceComponent :choices="[
+  {
+    name: 'IntelliJ IDEA',
+    href: './intellij-idea/building-a-mod',
+    icon: 'simple-icons:intellijidea',
+    color: '#FE2857',
+  },
+  {
+    name: 'Visual Studio Code',
+    icon: 'codicon:vscode',
+    color: '#007ACC',
+  },
+]" />
+
+## Building in the Terminal {#terminal}
+
+::: warning
+
+Using the terminal to build a mod rather than an IDE may cause issues if your default Java installation does not match what the project is expecting. For more reliable builds, consider using an IDE that allows you to easily specify the correct version of Java.
+
+:::
+
+Open a terminal from the same directory as the mod project directory, and run the following command:
+
+::: code-group
+
+```powershell:no-line-numbers [Windows]
+./gradlew.bat build
+```
+
+```sh:no-line-numbers [macOS/Linux]
+./gradlew build
+```
+
+:::
+
+The JARs should appear in the `build/libs` folder in your project. Use the JAR file with the shortest name outside development.
+
+## Installing and Sharing {#installing-and-sharing}
+
+From there, the mod can be [installed as normal](../../players/installing-mods), or uploaded to trustworthy mod hosting sites like [CurseForge](https://www.curseforge.com/minecraft) and [Modrinth](https://modrinth.com/discover/mods).

develop/getting-started/intellij-idea/building-a-mod.md

@@ -0,0 +1,25 @@
+---
+title: Building a Mod in IntelliJ IDEA
+description: Learn how to use IntelliJ IDEA to build a Minecraft mod that can be shared or tested in a production environment.
+authors:
+  - cassiancc
+  - cputnam-a11y
+  - gdude2002
+  - Scotsguy
+prev:
+  text: Generating Sources in IntelliJ IDEA
+  link: ./generating-sources
+next:
+  text: Tips and Tricks for IntelliJ IDEA
+  link: ./tips-and-tricks
+---
+
+In IntelliJ IDEA, open the Gradle tab on the right and execute `build` under tasks. The JARs should appear in the `build/libs` folder in your project directory. Use the JAR file with the shortest name outside development.
+
+![The sidebar of IntelliJ IDEA showing a highlighted build task](/assets/develop/getting-started/build-idea.png)
+
+![The build/libs folder with the corrected file highlighted](/assets/develop/getting-started/build-libs.png)
+
+## Installing and Sharing {#installing-and-sharing}
+
+From there, the mod can be [installed as normal](../../../players/installing-mods), or uploaded to trustworthy mod hosting sites like [CurseForge](https://www.curseforge.com/minecraft) and [Modrinth](https://modrinth.com/discover/mods).

develop/getting-started/intellij-idea/generating-sources.md

@@ -7,8 +7,8 @@ prev:
   text: Launching the Game in IntelliJ IDEA
   link: ./launching-the-game
 next:
-  text: Tips and Tricks for IntelliJ IDEA
-  link: ./tips-and-tricks
+  text: Building a Mod in IntelliJ IDEA
+  link: ./building-a-mod
 ---
 
 The Fabric toolchain lets you access the Minecraft source code by generating it locally, and you can use IntelliJ IDEA to conveniently navigate through it. To generate sources, you need to run the `genSources` Gradle task.

develop/getting-started/intellij-idea/tips-and-tricks.md

@@ -6,8 +6,8 @@ authors:
   - Earthcomputer
   - JR1811
 prev:
-  text: Generating Sources in IntelliJ IDEA
-  link: ./generating-sources
+  text: Building a Mod in IntelliJ IDEA
+  link: ./building-a-mod
 next: false
 ---
 

develop/getting-started/launching-the-game.md

@@ -1,6 +1,6 @@
 ---
 title: Launching the Game
-description: Learn how launch a Minecraft instance to start and debug your mods in a live game environment.
+description: Learn how to launch a Minecraft instance to start and debug your mods in a live game environment.
 authors:
   - dicedpixels
   - IMB11

public/assets/develop/getting-started/build-idea.png

@@ -5,6 +5,7 @@
   "develop.getting_started.setting_up": "Setting Up Your IDE",
   "develop.getting_started.opening_project": "Opening a Project",
   "develop.getting_started.launching_game": "Launching the Game",
+  "develop.getting_started.building_mod": "Building a Mod",
   "develop.getting_started.generating_sources": "Generating Sources",
   "develop.getting_started.tips_and_tricks": "IDE Tips and Tricks",
   "develop.items": "Items",