tutorial:setup
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
tutorial:setup [2019/10/22 16:55] – fudge | tutorial:setup [2023/09/09 18:03] – andrew6rant | ||
---|---|---|---|
Line 2: | Line 2: | ||
===== Prerequisites ===== | ===== Prerequisites ===== | ||
+ | * A Java Development Kit (JDK) for Java 17 (recommended) or newer. Visit [[https:// | ||
+ | * If you are professional, | ||
+ | * Any Java IDE, for example [[https:// | ||
+ | * 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:// | + | ===== Mod Setup ===== |
- | * Any IDE, for example [[https:// | + | ==== Manual |
- | + | - Copy the starting files from [[https:// | |
- | ===== Steps ===== | + | |
- | + | ||
- | - Copy the starting files from [[https:// | + | |
- Edit '' | - Edit '' | ||
* Make sure to set '' | * Make sure to set '' | ||
- | * Make sure to update the versions of Minecraft, the mappings | + | * Make sure to update the versions of Minecraft, the mappings, the loader |
* Add any other dependencies you plan to use in '' | * Add any other dependencies you plan to use in '' | ||
- | - Import the project | + | - Import the build.gradle file to your IDE. You may refer to the next section for specific |
- | - For Eclipse, If you would like to have the IDE run configs you can run '' | + | |
- Happy modding! | - Happy modding! | ||
- | You can generate the Minecraft | + | === Fabric Mod ID Change === |
- | Run the '' | + | As of Minecraft |
+ | === IntelliJ IDEA === | ||
+ | If you are using IntelliJ IDEA by JetBrains, please follow these steps: | ||
+ | - In the IDEA main menu, select ' | ||
+ | - Select the project' | ||
+ | - After Gradle is done setting up, close (File -> Close Project) and re-open the project to fix run configurations not displaying correctly. | ||
+ | - (If the run configurations still don't show up, try reimporting the Gradle project from the Gradle tab in IDEA.) | ||
+ | |||
+ | //Optional, but recommended//: | ||
+ | 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 ' | ||
+ | - Change the 'Build and run using' and 'Run tests using' fields to ' | ||
+ | |||
+ | Unfortunately, | ||
+ | |||
+ | **NOTE:** Don't run the '' | ||
+ | |||
+ | If you are using IntelliJ IDEA you can use the [[https:// | ||
+ | This plugin adds support for automatically generating Fabric projects as well as some mixin related features like inspections, | ||
+ | generating accessors/ | ||
+ | You can install it using IntelliJ' | ||
+ | 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 '' | ||
+ | |||
+ | === Visual Studio Code === | ||
+ | If you are using VSCode, please follow [[tutorial: | ||
+ | |||
+ | ===== Generating Minecraft Sources ===== | ||
+ | Reading the Minecraft source is an essential part of modding. | ||
+ | Unfortunately, | ||
+ | You need to generate the Minecraft source yourself. | ||
+ | |||
+ | To generate the Minecraft source. run the '' | ||
+ | If your IDE doesn' | ||
+ | It can take a while depending on your computer power. | ||
+ | You may need to refresh gradle after running the task. | ||
+ | |||
+ | See [[tutorial: | ||
===== Getting started ===== | ===== Getting started ===== | ||
- | Try [[tutorial: | + | Try [[tutorial: |
- | ===== Advice ===== | + | |
- | | + | ===== Advice ===== |
- | * As Fabric is in early development, | + | |
+ | * Occasionally, with development of fabric-loom (our Gradle build plugin) issues may crop up which require | ||
+ | * Keep up with the latest Loom version | ||
+ | * Keep up with the latest Gradle version, which can be defined | ||
+ | * 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 '' | ||
* 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" |
+ | After running the '' | ||
+ | ==== Missing sounds ==== | ||
Sometimes, when importing the Gradle project into an IDE, the assets might not download correctly. In this case, run the '' | Sometimes, when importing the Gradle project into an IDE, the assets might not download correctly. In this case, run the '' | ||
+ | ==== Could not find or load class net.fabricmc.devlaunchinjector.Main: | ||
+ | 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: | ||
+ | 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 " | ||
+ | ===== What's Next? ===== | ||
+ | Create your first [[tutorial: |
tutorial/setup.txt · Last modified: 2024/04/15 00:35 by solidblock