前言

你好，想做 Mod 而不想学习 Java？没错，这是一个允许通过 YAML 语法向游戏内添加自定义内容的 Mod（包括物品，方块），而且还支持热注册热更改。

介绍

• 为玩家提供使用 YAML 语法向 Minecraft 添加拓展内容的工具，当前版本支持添加物品、可触发物品、合成配方、村民、植物、农作物、武器、盔甲、附魔、食物、工具、方块、药水、药水效果、传送门、添加到物品组和游戏规则，并且这些扩展内容可以设置自己独特的“命名空间:ID”功能；

• 通过启用配置文件的 FEATURE_ENABLE（默认启用），将之前 Minecraft 版本的内容和愚人节更新内容添加到游戏中；

• 允许在单机游戏中使用服务器命令（局域网内可以使用 /op、/ban、/whitelist 等命令）；

• 大大扩展了结构方块的存储范围；

• 允许玩家在任何地方输入“§”；

• Mod 中所有物件都会自动创建对应的模型和 BlockStates 还能导出，这大大地节省写 JSON 的时间；

• 联动 PolyMc 和 Polymer，允许没有对应 Mod 和拓展包的客户端玩家加入游戏并且可修改显示；

• 支持游戏内注册内容热更改/热修改。

目前支持添加的内容

• 自定义物品；

• 自定义方块（包括门、台阶、楼梯等，还能自定义方块声音）；

• 自定义农作物（包括种子和农作物方块一共 7 个阶段）；

• 自定义武器、工具、盔甲和雪球；

• 自定义合成配方（有序工作台合成、无序工作台合成、熔炉烧制、高炉烧炼、烟熏炉烹饪、锻造台锻造、药水合成）；

• 自定义物品组；

• 自定义游戏规则；

• 自定义植物（包括一格高植物和两格高植物）；

• 自定义村民；

• 自定义命令映射；

• 自定义画；

• 自定义附魔；

• 自定义药水效果；

• 自定义药水；

• 自定义事件；

• 魔改原版内容；

常见问题

• 问：为什么我进行一些更改后游戏无法开始？

  答：检查配置文件中的 int 类型是否使用了小数，请尝试相加或转换为整数，如 1.0→1 和 1→1.0（下载示例包或看维基即可了解变量是什么类型）；

• 问：我可以在 Forge 上使用 CoreExtensions 吗？

  答：由于 CoreExtensions 使用了 Mixins 和 customportals-api，Sinytra Connector 目前无法工作；

• 问：我的服务器安装了 PolyMc，但是我服务器玩家就算也安装了对应的 Mod 和附属拓展包也不能进入服务器怎么办？

  答：请确保玩家跟服务器的 Mod 能对上后加入 PolyPuck 即可不经过 PolyMc 转发数据包。确保 Mod 不要出现差异！

• 问：我制作的拓展包知识产权属于谁？

  答：您的拓展包知识产权属于您，您可以使用 Fabric-Loom Gradle 将拓展包打包成 Mod 上传至 Curseforge 或 Modrinth 等 Minecraft Mod 平台作为附属 Mod。本 Mod 支持读取 mods 内的 JAR 文件。

• 问：有困难，想反馈漏洞或想提建议？

  答：那就来 GitHub Issues 或本条目下面短评区反馈吧。

• 问：为什么我热重载注册表后刷新资源包出现材质丢失和方块消失的情况？

  答：这个目前暂时修不了，其实这些热重载前的内容都还存在游戏内，解决方案是重新进入地图即可。

未来计划

• 考虑和其他 Mod 联动；

• 支持可控更多新内容。