MinecraftFabricMod编写Part1配置模组开发环境

前置

• JDK 17（推荐），安装包可参考 https://adoptium.net/releases.html
  • 专业用户可以从 http://jdk.java.net/ 获取JDK，需要手动解压并设置环境变量。
• 任意 IDE（集成开发环境）：如 IntelliJ IDEA 和 Eclipse，也可使用任何可编辑Java的文本编辑器，如 Visual Studio Code。
  • 如果对这些不熟悉，推荐使用 Intellij IDEA，绝大多数开发者都用这个编写模组。

MinecraftDev IntelliJ IDEA插件

如果你使用 IntelliJ IDEA，你可以使用 MinecraftDev 插件。该插件支持自动生成 Fabric 项目以及一些与 Mixin 有关的功能，如检查、生成存取器（accessor）和影子（shadow）字段，复制 Mixin 目标参考（JVM 描述符）。你可以在再文件（File） → 设置（Settings） → 插件（Plugins）中打开内部插件浏览器，找到并安装这个插件，只需要在搜索框里搜索“Minecraft”，选择第一个安装即可。

配置步骤

手动下载 fabric-example-mod（示例模组模板）并自行配置

由于网速原因，构建 Gradle 速度可能比较慢。

注意：mcdev 插件中的默认模板会盲目使用最新的不稳定的 loom 版本，请谨慎使用。

步骤

1. 下载 fabric-example-mod 中的文件
2. 编辑 gradle.properties:
   • 确保将 archives_base_name 和 maven_group 设为你的值，例如fish-mod，com.qig。
3. 将 build.gradle 导入到你的 IDE 中（各 IDE 操作各有不同，具体见下）

你也可以生成MC的源文件来作为参考： 运行 Gradle 任务 genSources，如果你的 IDE 不集成 Gradle 支持的话则需要在控制台/终端/命令提示符中输入 gradlew genSources

IntelliJ IDEA

如果你使用的是 IntelliJ IDEA：

1. 在 IDEA 的主菜单里选择“打开或导入…（Open或Import Project）”
2. 选择项目的 build.gradle 文件以导入项目。
3. 在 Gradle 配置完成后，关闭并重新加载项目，否则有些运行配置可能无法正常显示。

注：*千万* 不要运行 idea 的 gradle 任务，它会破坏开发环境。

Eclipse

如果你使用的是 Eclipse，并且想要生成IDE的运行设置，请运行 gradlew eclipse。然后在Eclipse中点击文件（File）导入(Import）将他作为常规的eclipse的项目导入

Visual Studio Code

如果你使用的是 Visual Studio Code，请查看官方文档。

生成 Minecraft 源代码

生成Minecraft源码。运行gradle任务genSources， 如果你的IDE没有gradle面板，请在控制台运行：gradlew genSources。

建议

• 虽然 Fabric API 并不是必要的，但其最首要的目标是提供MC游戏引擎所不提供的跨模组兼容性和 hooks，所以我们强烈推荐使用 Fabric API。许多教程也会默认使用 Fabric API。
• 随着 fabric-loom的开发和改动，有些时候你可能会遇上一些通过重置 Gradle 缓存才能解决的问题。使用 gradlew cleanloom 便能清理缓存，而 gradlew --stop 则能帮助你解决一些其他疑难杂症。

故障诊断

 

缺少声音

有时当 IDE 在导入 Gradle 项目的时候有些游戏素材不会正常下载。如果遇到这种情况则要手动运行 downloadAssets 任务——既可以使用 IDE 的自带菜单也可以直接执行 gradlew downloadAssets。