User Tools

Site Tools


tutorial:setup

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
tutorial:setup [2020/02/21 11:13] – Reorganize instructions and add a step for IDEA mkpolitutorial:setup [2023/09/09 18:03] (current) andrew6rant
Line 2: Line 2:
  
 ===== Prerequisites ===== ===== Prerequisites =====
 +   * A Java Development Kit (JDK) for Java 17 (recommended) or newer. Visit [[https://adoptium.net/releases.html]] for installers.
 +       * If you are professional, you can obtain a JDK from [[http://jdk.java.net/]], which needs to be extracted and have system variables set up manually.
 +   * Any Java IDE, for example [[https://www.jetbrains.com/idea/download/#section=windows|Intellij IDEA]] and [[https://www.eclipse.org/downloads/|Eclipse]]. You may also use any other code editors, such as [[https://code.visualstudio.com/|Visual Studio Code]].
 +       * If you are not familiar with any of these, we recommend to use Intellij IDEA as that is what most people choose for modding.
  
-   * A Java Development Kit (JDK) for Java 8 or newer [[https://adoptopenjdk.net/]] +===== Mod Setup ===== 
-   * Any IDE, for example [[https://www.jetbrains.com/idea/download/#section=windows|Intellij IDEA]] +==== Manual Steps ==== 
- +   - Copy the starting files from [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] (or from [[https://fabricmc.net/develop/template/|the template generator]], if you wish to use Kotlin or other featues.) excluding the ''LICENSE'' and ''README.md'' files - as those apply to the template itself, not necessarily to your mod.
-===== General Steps ===== +
-   - Copy the starting files from [[https://github.com/FabricMC/fabric-example-mod/|fabric-example-mod]] (or from [[https://github.com/natanfudge/fabric-example-mod-kotlin|the Kotlin version]], if you wish to use Kotlin,) excluding the ''LICENSE'' and ''README.md'' files - as those apply to the template itself, not necessarily to your mod.+
    - Edit ''gradle.properties'':    - Edit ''gradle.properties'':
        * Make sure to set ''archives_base_name'' and ''maven_group'' to your preferred values.        * Make sure to set ''archives_base_name'' and ''maven_group'' to your preferred values.
-       * Make sure to update the versions of Minecraft, the mappings and the loader - all of which can be queried through [[https://modmuss50.me/fabric.html|this website]] - to match the versions you wish to target.+       * Make sure to update the versions of Minecraft, the mappingsthe loader and the loom - all of which can be queried through https://fabricmc.net/develop/ - to match the versions you wish to target.
        * Add any other dependencies you plan to use in ''build.gradle''.        * Add any other dependencies you plan to use in ''build.gradle''.
-   - Import the build.gradle file to your IDE. You may refer to next section for specific IDE's.+   - Import the build.gradle file to your IDE. You may refer to the next section for specific IDE's.
    - Happy modding!    - Happy modding!
  
-You can generate the Minecraft sources for reference (since IDEA already has a decompiler this is only useful for searching through the code) : +=== Fabric Mod ID Change === 
- Run the ''genSources'' Gradle task. If your IDE doesn't have Gradle integrationthen run the following command in the terminal: ''gradlew genSources'' (or ''.gradlew genSources'' on Linux/MacOS)+As of Minecraft 1.19.2, Fabric API's mod ID has changed from ''fabric'' to ''fabric-api''. When backporting from 1.19.2 to earlier versionsyou must alter the ''depends'' section of your ''fabric.mod.json'' to expect ''fabric''
-    + 
-==== IntelliJ IDEA ====+=== IntelliJ IDEA ===
 If you are using IntelliJ IDEA by JetBrains, please follow these steps: If you are using IntelliJ IDEA by JetBrains, please follow these steps:
-    - In order to run/debug your projectgo to menu ''Run -> Edit Configurations...''In ''Run/Debug Configuration'' dialogfind ''Application Minecraft Client'' and change ''Use classpath of module'' form ''[ProjectName]'' to ''[ProjectName].main'', then change for ''Application > Minecraft Server'' as well. +    - In the IDEA main menuselect 'Import Project(or File -> Open... if you already have a project open). 
-    - Happy Modding!+    - Select the project's build.gradle file to import the project. 
 +    - After Gradle is done setting upclose (File -Close Project) and re-open the project to fix run configurations not displaying correctly. 
 +    - (If the run configurations still don't show uptry reimporting the Gradle project from the Gradle tab in IDEA.)
  
-==== Eclipse ==== +//Optional, but recommended//: 
-If you are using Eclipse and you would like to have the IDE run configs you can run ''gradlew eclipse''.+By default, IntelliJ delegates to Gradle to build the project. This is unnecessary for Fabric and causes longer build times and hotswapping related weirdness, among other problems. To make it use the builtin compiler: 
 +    - Open the 'Gradle Settings' dialog from the Gradle tab. 
 +    - Change the 'Build and run usingand 'Run tests using' fields to 'IntelliJ IDEA'.
  
-==== Visual Studio Code ==== +Unfortunately, it is currently impossible to set an IDE-wide default for the 'Build and run using' and 'Run tests using' options, so these steps have to be repeated for every new project. 
-If you are using VSCode by Microsoft, please follow [[tutorial:vscode_setup|these instructions]]+ 
 +**NOTE:** Don't run the ''idea'' gradle task. It is known to break development environment. 
 + 
 +If you are using IntelliJ IDEA you can use the [[https://plugins.jetbrains.com/plugin/8327|MinecraftDev plugin]]. 
 +This plugin adds support for automatically generating Fabric projects as well as some mixin related features like inspections, 
 +generating accessors/shadow fields, and copying Mixin Target References (JVM Descriptors). 
 +You can install it using IntelliJ's internal plugin browser by navigating to File → Settings → Plugins, 
 +then clicking the Marketplace tab and searching for Minecraft. 
 + 
 +**NOTE:** The default template in the mcdev plugin blindly uses the latest unstable version of the loom. Use with caution. 
 + 
 +=== Eclipse === 
 +If you are using Eclipse and you would like to have the IDE run configs you can run ''gradlew eclipse''. The project can then be imported as a normal (non-gradle) Eclipse project into your workspace using the 'File' - 'Import...' menu, then 'General' -> 'Existing Projects into Workspace'
 + 
 +=== Visual Studio Code === 
 +If you are using VSCode, please follow [[tutorial:setup:vscode|these instructions]]
 + 
 +===== Generating Minecraft Sources ===== 
 +Reading the Minecraft source is an essential part of modding. 
 +Unfortunately, we can't publish the Minecraft source because it violates the Minecraft EULA. 
 +You need to generate the Minecraft source yourself. 
 + 
 +To generate the Minecraft source. run the ''genSources'' gradle task. 
 +If your IDE doesn't have gradle integration, run the following command in the terminal: ''gradlew genSources'' (or ''./gradlew genSources'' on Linux/macOS). 
 +It can take a while depending on your computer power. 
 +You may need to refresh gradle after running the task. 
 + 
 +See [[tutorial:reading_mc_code|Reading the Minecraft source]] for how to read the source.
  
 ===== Getting started ===== ===== Getting started =====
 Try [[tutorial:items|adding an item]] or [[tutorial:blocks|a block]]. It's also a good idea to visit [[tutorial:applychanges|Applying changes without restarting Minecraft]]. Try [[tutorial:items|adding an item]] or [[tutorial:blocks|a block]]. It's also a good idea to visit [[tutorial:applychanges|Applying changes without restarting Minecraft]].
-===== Advice ===== 
  
-  * While Fabric API is not strictly necessary for developing mods, its primary goal is to provide cross-compatibility and hooks where the game engine does not, and as such it is highly recommended! +===== Advice ===== 
-  * As Fabric is in early development, occasionally, with development of fabric-loom (our Gradle build plugin) issues may crop up which require a manual clearing (deletingof the cache (which can be found in ''.gradle/caches/fabric-loom'')Those will generally be announced as they are identified.+  * While Fabric API is not strictly necessary for developing mods, its primary goal is to provide cross-compatibility and hooks where the game engine does not, and as such it is highly recommended! Even some of the tutorials on the wiki implicitly require Fabric API. 
 +  * Occasionally, with development of fabric-loom (our Gradle build plugin) issues may crop up which require resetting the cache files. This can be done by running ''gradlew cleanloom''. Running ''gradlew %%--%%stop'' can also help with few rare issues. 
 +  * Keep up with the latest Loom version (which is defined in ''build.gradle''and the Fabric Loader and Fabric API version for your mod (which is defined in ''build.gradle'' or ''gradle.properties''). Latest version can be found in [[https://fabricmc.net/develop/]]. Even the old version Minecraft is supported by latest Loom and latest Fabric Loader. 
 +  * Keep up with the latest Gradle version, which can be defined in ''gradle/wrapper/gradle-wrapper.properties''Old version Minecraft is supported by latest Gradle. 
 +    * Different Gradle versions require different Java versions. Usually latest Gradle supports the recommended Java version 17. 
 +  * If you're developing mods for old version Minecraft, besides changing ''gradle.properties'', you may also need to change the Java compatibility version in ''build.gradle'' and the mixin config.
   * Don't hesitate to ask questions! We're here to help you and work with you to make your dream mod a reality.   * Don't hesitate to ask questions! We're here to help you and work with you to make your dream mod a reality.
  
 ===== Troubleshooting ===== ===== Troubleshooting =====
  
-==== Missing sounds ====+==== "no usages" on every method ==== 
 +After running the ''genSources'' gradle task in IntelliJ IDEA, check if the sources are attached properly. Open a Minecraft .class file and click on the "Choose Sources..." button on the top right of the screen. Select the jar with "-sources" at the end (e.g. ''.gradle\loom-cache\1.20.1\net.fabricmc.yarn.1_20_1.1.20.1+build.10-v2\minecraft-project-@-merged-named-sources.jar'')
  
 +==== Missing sounds ====
 Sometimes, when importing the Gradle project into an IDE, the assets might not download correctly. In this case, run the ''downloadAssets'' task manually - either using IDE's built-in menu or by simply running ''gradlew downloadAssets''. Sometimes, when importing the Gradle project into an IDE, the assets might not download correctly. In this case, run the ''downloadAssets'' task manually - either using IDE's built-in menu or by simply running ''gradlew downloadAssets''.
  
 +==== Could not find or load class net.fabricmc.devlaunchinjector.Main: java.lang.ClassNotFoundException / "no JDK module specified" in the run config  ====
 +It seems to be a bug of Intellij IDEA since a recent update 2023.2. To fix, just delete the `.idea` folder entirely and then restart Intellij IDEA. The module will be reconstructed. You may need to specify Java versions again. If after restarting there is no run config, you can run `gradle ideaSyncTask` then check it again.
 +
 +==== java.lang.ClassNotFoundException: net.fabricmc.loader.impl.launch.knot.KnotClient / java.lang.TypeNotPresentException: Type net/minecraft/util/Identifier not present / java.lang.RuntimeException: Minecraft game provider couldn't locate the game! The game may be absent from the class path, lacks some expected files, suffers from jar corruption or is of an unsupported variety/version. ====
 +This may be because the project path contains non-ASCII characters that may cause incompatibility. Try move the project to paths without non-ASCII characters, or in the run config of "Minecraft Client" and "Minecraft Server", set "Shorten Command Line" from "@argfile (Java 9+)" to "none".
 +===== What's Next?  =====
 +Create your first [[tutorial:items|item]].
tutorial/setup.1582283637.txt.gz · Last modified: 2020/02/21 11:13 by mkpoli