Minecraft Forums

When you ready to install Fabric, complete the following steps:

• Create a new, empty folder. (NOTE: Fabric versions prior to v0.2.0.64 do not support spaces in the folder's path. If there is a space in the path to the folder, any Fabric mods you attempt to create in your IDE will fail to load properly. To fix this, update to Fabric v0.2.0.64 or above).
• Either create a fork of Asie's sample Fabric mod repository or click "Clone or download > Download ZIP" to download the repo's contents onto your computer.
• Place the contents in the folder you have just created.
• Open the build.gradle file in a text editor such as Notepad++. Once it's open, you should modify the "archivesBaseName" and "version" values to the values you want.
• Open a Command Prompt window and navigate to the folder using the command "cd <path to folder>". Once there, run the "gradlew genSources idea" command to set up a workspace made for IntelliJ IDEA. If you use Eclipse, you can run the "gradlew genSources eclipse" command. If you wish to use Visual Studio as your IDE, follow this tutorial instead.
• Once Gradle is finished building the workspace, it should automatically open in IDEA. If it doesn't, you can simply double-click on the .ipr file with the same name as the directory to open the project in IDEA.

If you have followed the above steps, you should be able to launch the game right away in IDEA using the "Minecraft Client" and "Minecraft Server" run configurations.

If your mod fails to load without any errors being logged, be sure that you have updated Fabric to v0.2.0.64 or newer, and to be even more cautious, double-check that there are no spaces in the path to the project directory.

Similar to building mods with Forge, when you are ready to package your mod and obtain its .jar file, navigate to your project's folder in a Command Prompt window (using the "cd" command to change directories) and run the command "gradlew build". Once it's completed, you should see a new "build" folder in your project directory. Find the "libs" folder inside of "build", and your packaged .jar file will be in there.

Because Fabric takes advantage of Gradle, you can easily update the mapping and loader versions you are using in your project. However, the process can be confusing if you haven't done it in a while. Open up your build.gradle file in your IDE, change the versions to the ones you want to update to, then save the file. Once it's saved, navigate to your project directory in the Command Prompt, run the command "gradlew genSources idea" again, and simply wait for it to finish. This will update your project to use the versions of Fabric that you specified.

Currently, the only way to launch Minecraft with Fabric installed outside of an IDE is to use MultiMC. Many people already use MultiMC, but if you don't, you can find it here. Install it before proceeding to the next step.

Once you have MultiMC installed, go the Fabric downloads page and select the mapping and loader versions that you need. Once you pick the versions you want, click on the "Copy MultiMC instance url" button to save the download link of the correct Fabric MultiMC instance to your clipboard. Open up MultiMC and select the "Add instance" button in the top-left. Click on the "Import from ZIP" option and paste the link you just saved into the textbox. Give the instance a name and click the "OK" button when you are done. Before you can start Minecraft though, you need to install the Fabric API separately. This will cause crashes to occur if you have not completed the following step with Fabric mods installed. Before starting Minecraft, click on this link to be taken to the Fabric API's Maven page. Click on the latest version of the API and select the first .jar file listed. In my case, it would be this one:



This will download that version of the Fabric API as a .jar file. Place it in your MultiMC instance's "mods" folder alongside any other mods before running the game. You can click on "instance folder" in MultiMC then double-click into the ".minecraft" directory for easy access to the mods folder. Once you are finished with this step, you can launch Minecraft by simply clicking the "Launch" button in MultiMC.

Here's a video made by ScottoMotto showing the installation of Fabric:

If you're like me, you probably have no idea what I just said and might have a few questions. You can join Fabric's Discord server here, where people a lot more knowledgeable than myself can help you out.