dwgx@blog:~$dwgx
> cd ../posts

Example-Wasted1 从零把 Fabric mod 工具链跑通

// created

Example-Wasted1 是个 Fabric mod 练手工程, 目的只有一个: 从零把 Minecraft 的 modloader、mapping、构建这套工具链完整跑通一遍。名字和那句描述是随手起的占位, 别当真, 代码才是重点。

Minecraft 的 Java 生态一直想认真摸一遍。写 mod 逻辑本身不难, 难的是环境和工具链。光看教程没用, 不如开个空项目, 从 example mod 模板一路踩过去。

工程是标准 Gradle 结构, 纯 Java。目录按 Fabric 习惯拆两块: src/main 放两端共用逻辑, src/client 放只在客户端跑的代码。包名留了模板默认的 com.example.mod, 没改。

最费劲的是环境。gradle.properties 里锁着 Minecraft、Yarn mapping、loader 和 API 的版本, 但凡对不上 genSources 就直接报错。第一次拉依赖慢得离谱, 配好镜像才顺。客户端和服务端的边界也得先想清楚, 客户端专属的调用塞进 common, 一上服务端就崩。

整个就是个草稿工程。该踩的坑踩完、手感有了就归档, 留着当个记号: 这套我确实从零跑通过一次。