主要有两种新建 Fabric 模组开发环境的方法:你可以手动下载 fabric-example-mod(示例模组模板)并自行配置,也可以使用一些工具来自动设置。
部分地区的用户可能会发现,由于网速原因,构建 Gradle 速度可能比较慢。对于中国内地用户,可参考加快 Fabric 模组构建速度的教程和加速 Fabric 模组依赖拉取以及环境搭建教程。 如果你已经打开代理,但是下载速度仍然比较慢,可以检查一下 IDE 的网络代理设置是否处于关闭状态。对于 IntelliJ IDEA ,你可以在 File → Settings → Appearance & Behavior → System Settings → HTTP Proxy 找到该设置选项卡,如果勾选的是 “No proxy” ,要切换至 “Auto-detect proxy settings” 。
LICENSE
(许可证)及 README.md
(简介)文件,因为它们只应用于模板自身,而非你的模组。gradle.properties
:archives_base_name
和 maven_group
设为你喜欢的值。build.gradle
中使用的其他依赖。build.gradle
导入到你的 IDE 中(各 IDE 操作各有不同,具体见下)
如有需要,可以在 gradle.properties
中设置镜像源。镜像源可能有时不可用,或者内容更新滞后,如需使用官方源,可暂时将相关内容注释掉即可。BMCLAPI 镜像缓慢时,可使用官方源,或参考校园网联合镜像站。
loom_libraries_base=https://bmclapi2.bangbang93.com/maven/ loom_resources_base=https://bmclapi2.bangbang93.com/assets/ loom_version_manifests=https://bmclapi2.bangbang93.com/mc/game/version_manifest.json loom_experimental_versions=https://maven.fabricmc.net/net/minecraft/experimental_versions.json loom_fabric_repository=https://repository.hanbings.io/proxy/
从 1.19.2 开始,Fabric API 的模组ID由 fabric
变为 fabric-api
。如果需要将 1.19.2 的项目向后移植到旧的版本,需要在 fabric.mod.json
的 depends
部分进行相应变更。
如果你使用的是 JetBrains 的 IntelliJ IDEA,请遵循以下步骤(注:中文文本可能会因为 IDEA 或中文插件的版本不同而不同):
build.gradle
文件以导入项目。可选,但推荐做的一件事: IDEA 默认使用 Gradle 来构建你的项目,而这在 Fabric 是不必要的,而且会导致构建时间变长以及热交换(hotswapping)相关的种种问题。以下是让 IDEA 使用默认编译器的步骤:
不幸的是,目前还不能给“使用此工具构建和运行”和“使用此工具运行测试”设置一个全 IDE 内的默认值,所以这些每创建一个新项目都得重复上述步骤。
注:不要运行 idea
的 gradle 任务,已知它会破坏开发环境。
如果你使用 IntelliJ IDEA,你可以使用 MinecraftDev 插件。该插件支持自动生成 Fabric 项目以及一些与 Mixin 有关的功能,如检查、生成访问器(accessor)和影子(shadow)字段、复制 Mixin 目标参考(JVM 描述符)。你可以在文件(File) → 设置(Settings) → 插件(Plugins)中打开内部插件浏览器,找到并安装这个插件,只需要在搜索框里搜索“Minecraft”,选择第一个结果安装即可。
注:MCDev 插件中的模板会直接使用 loom 的最新不稳定版本,请小心使用。
如果你使用的是 Eclipse,并且想要生成 IDE 的运行设置,请运行 gradlew eclipse
。然后,项目就可以作为普通的(非 gradle)的 Eclipse 项目导入你的工作区内,方法就是“文件” — “导入…”菜单,然后“通用” → “已存在的项目导入工作区”。
如果你使用的是 Visual Studio Code,请参照这篇教程。
阅读 Minecraft 源代码是编写模组时的重要一部分。但是,我们不能发布 Minecraft 的源代码,因为这违反了 Minecraft 的最终用户许可协议(EULA)。你需要自己生成 Minecraft 源代码。
要生成 Minecrat 源代码,运行 gradle 任务 genSources
。如果你的 IDE 没有嵌入 gradle,在终端内运行以下命令:./gradlew genSources
。反编译可能需要一段时间,取决于计算机的能力。你可能需要在运行任务之后刷新 gradle。
如何阅读源代码,可参考阅读 Minecraft 源代码。
入门可以先尝试添加一些物品和方块。另外,建议了解一下如何在不重启 Minecraft 的情况下应用更改,以便调试。
gradlew cleanloom
便能清理缓存,而 gradlew --stop
则能帮助你解决一些其他疑难杂症。build.gradle
中定义的),以及 Fabric Loader 和 Fabric API 的版本(这是在 build.gradle
或者 gradle.properties
中定义的)。最新的版本可以在 https://fabricmc.net/develop/ 中找到。即使是旧的 Minecraft 版本,最新的 Loom 和 Fabric Loader 也会支持。gradle/wrapper/gradle-wrapper.properties
中定义的。最新的 Gradle 也可以用于开发旧的 Minecraft 版本。gradle.properties
外,你还需要修改 build.gradle
和 mixin 配置中更改 Java 兼容性版本。
在运行 Intellij IDEA 的 genSources
gradle 任务后,检查源代码是否被正确添加。打开一个 Minecraft .class 文件,点击屏幕右上方的“选择源……”按钮。选择在结尾有“-sources”的jar。
有时当 IDE 在导入 Gradle 项目的时候有些游戏素材不会正常下载。如果遇到这种情况则要手动运行 downloadAssets
任务——既可以使用 IDE 的自带菜单也可以直接执行 gradlew downloadAssets
。
这可能是 Intellij IDEA 自近期更新 2023.2 后的一个 bug。要修复这个问题,删除整个 `.idea` 文件夹然后重启 Intellij IDEA 即可。模块会重新构建。你可能需要再次指定 Java 版本。如果重启之后没有运行配置,你可以运行 `gradle ideaSyncTask` 然后再检查一下。
这可能是因为项目路径有中文字符或其他可能造成编码不兼容的字符造成的。可以尝试将项目移到不含中文的路径中,或者在启动参数中(编辑配置),将“Minecraft Client”和“Minecraft Server”启动配置的“缩短命令行”(Shorten command line)由“@argfile (Java 9+)”设为“无”。
另一个可能的解决办法,是在 Windows 的设置或控制面板中找到“区域设置”,并勾选“Beta 版:使用 Unicode UTF-8 提供全球语言支持”,然后重启。
部分地区的用户在下载 Gradle 时,可能遇到 Connection Reset 的问题。这种情况下可以使用镜像源下载 Gradle。例如,在 gradle/wrapper/gradle-wrapper.properties
文件中,将 distributionUrl
的值设置为镜像地址,例如:
# 修改前 distributionUrl=https://services.gradle.org/distributions/gradle-8.7-bin.zip # 修改后 distributionUrl=https://mirrors.cloud.tencent.com/gradle/gradle-8.7-bin.zip
注:Gradle 的镜像不止腾讯。
创建你的第一个物品。