Fabric 提供了一种简单的方法来使用 Fabric 模板模组生成器来创建新的模组项目——如果你愿意,你可以使用示例模组代码仓库手动创建一个新项目,请参考 手动创建项目 章节。
生成项目
你可以使用 Fabric 模板模组生成器为你的模组生成一个新项目——你应该填写必要的字段,例如模组名称、包名以及你想开发的 Minecraft 版本。
包名应为小写,用点分隔,并保持唯一以避免与其他程序员的包冲突。 它通常被格式化为反向互联网域名,例如 com.example.example-mod。
重要
请记住你的模组 ID! 当你在这些文档中找到 example-mod ,尤其是在文件路径中时,你必须用你自己的替换它。
例如,如果你的模组 ID 是 my-cool-mod,则使用 resources/assets/my-cool-mod 而不是 resources/assets/example-mod。

如果你想使用 Kotlin 或 Fabric 的 Yarn 映射而不是默认的 Mojang 映射,或者想添加数据生成器,你可以在 Advanced Options 部分选择相应的选项。
INFO
本站提供的代码示例使用 Mojang 的官方名称。 如果你的模组使用的映射与这些文档编写的映射不同,你需要使用 mappings.dev 或 Linkie 等网站转换示例。

填写完所需字段后,单击 Generate 按钮,生成器将以 zip 文件的形式创建新项目供你使用。
你需要将这个 zip 文件解压到你想要的位置,然后在你的 IDE 中打开解压的文件夹。
TIP
在为你的项目选择路径时,你应该遵循以下规则:
- 避免云存储目录(例如 Microsoft OneDrive)
- 避免非 ASCII 字符(例如表情符号、重音字母、汉字)
- 避免空格
一个“良好”的路径示例可以是: C:\Projects\YourProjectName
手动创建项目
前置条件
你需要安装 Git 来克隆示例模组代码仓库。
如果不能使用 Fabric 模板模组生成器,可以按以下步骤手动创建新项目。
首先,使用 Git 克隆示例模组代码仓库:
sh
git clone https://github.com/FabricMC/fabric-example-mod/ example-mod1
这将把代码仓库克隆到一个名为 example-mod 的新文件夹中。
然后你应该从克隆的代码仓库中删除 .git 文件夹,并·打开项目。 如果找不到 .git 文件夹,你需要在你的文件资源管理器中启用显示隐藏文件。
一旦你在 IDE 中打开了项目,它应该会自动加载项目的 Gradle 配置并执行必要的设置任务。
强调一遍,如上所述,如果你收到一个关于 Gradle 构建脚本的通知,你应该点击 Import Gradle Project 按钮。
修改模板
导入项目后,你应该修改项目的详细信息以匹配你的模组的信息:
- 修改项目的
gradle.properties文件,把maven_group和archive_base_name修改为匹配你的模组的信息。 - 修改
fabric.mod.json文件,把id、name和description修改为匹配你的模组的信息。 - 确保更新 Minecraft、映射、Fabric Loader 和 Fabric Loom 的版本——所有这些都可以通过 https://fabricmc.net/develop/ 查询,以匹配你希望的目标版本。
你还可以修改包名和模组的主类来匹配你的模组的详细信息。




