Carpet-Hao-Addition

**Carpet-Hao-Addition** is a Fabric Carpet extension that bundles a set of toggleable Carpet rules — **all disabled by default** — covering Minecraft **1.21 through 26.2**. It deliberately depends on nothing but **Fabric Loader + Carpet** (no fabric-api), so it works on a pure server.

• **Rules**: zone guard (disable observers in a configured region), golden-carrot composting, snowy calcite, end-portal teleport whitelist, terracotta un-dyeing, mineable bedrock, wither-skeleton drop reduction — toggled in game with /carpet <rule> <value> (category **Hao**).

• **Download**: pick the jar matching your exact Minecraft version — each jar targets a single version (1.21, 1.21.1, 1.21.2, 1.21.4, 1.21.6, 1.21.8, 1.21.10, 1.21.11, 26.1.2, 26.2).

• **Requirements**: Fabric Loader ≥ 0.16.10 and the matching Carpet release. Java 21+ for 1.21.x, **Java 25** for 26.x.

• **Source**: https://github.com/xiao-hao-ovo/Carpet-Hao-Addition

---

中文说明

Carpet-Hao-Addition

一个基于 Fabric 的 Carpet 多版本扩展模组，为技术生存与原版友好玩法提供少量实用、可配置的地毯规则。

• 所有规则**默认关闭**，只有在 /carpet 中手动开启后才生效；默认配置下不改变原版行为。

• 只依赖 **Carpet + Fabric Loader**（刻意不依赖 fabric-api），可纯服务端使用。

• 全部规则注册在 Carpet 默认管理器，分类 **Hao（游戏内显示“昊”）**，文案支持中英双语（en_us / zh_cn）。

支持版本与依赖

| Minecraft | Yarn mappings | Fabric Loader | Carpet |

|---|---|---|---|

| 1.21 | 1.21+build.9 | 0.19.5（要求 ≥0.16.10） | 1.21-1.4.147+v240613 |

| 1.21.1 | 1.21.1+build.3 | 0.19.5（要求 ≥0.16.10） | 1.21-1.4.147+v240613（上游无专用 1.21.1,该版本声明 minecraft ">1.20.1"） |

| 1.21.2 | 1.21.2+build.1 | 0.19.5（要求 ≥0.16.10） | 1.21.2-1.4.158+v241022 |

| 1.21.4 | 1.21.4+build.8 | 0.19.5（要求 ≥0.16.10） | 1.21.4-1.4.161+v241203 |

| 1.21.6 | 1.21.6+build.1 | 0.19.5（要求 ≥0.16.10） | 1.21.6-1.4.176+v250617 |

| 1.21.8 | 1.21.8+build.1 | 0.19.5（要求 ≥0.16.10） | 1.21.7-1.4.177+v250630 |

| 1.21.10 | 1.21.10+build.3 | 0.19.5（要求 ≥0.16.10） | 1.21.10-1.4.188+v251016 |

| 1.21.11 | 1.21.11+build.6 | 0.19.5（要求 ≥0.16.10） | 1.21.11-1.4.194+v260107 |

| 26.1.2 | 无（26.x 起 Mojang 取消混淆，Fabric 停用 yarn） | 0.19.5+ | 26.1+v260401 |

| 26.2 | 无（26.x 起 Mojang 取消混淆，Fabric 停用 yarn） | 0.19.5+ | 26.2+v260616 |

• Java：21+

• 模组 id：carpet-hao-addition；Loom：1.17.20

规则列表

游戏内用 /carpet <规则> <值> 查看/切换（也可在 Carpet 的规则界面里操作）。

布尔规则

| 规则 | 默认 | 说明 |

|---|---|---|

| zoneguard | false | 在 /zoneguard 配置的立方区域内禁用侦测器（观察者）行为；关闭规则会恢复区域内侦测器 |

| goldenCarrotCompost | false | 手持金胡萝卜右键堆肥桶可 100% 堆肥（消耗与满桶流程同普通可堆肥物品） |

| snowyCalcite | false | 雪地刷石机产出方解石（雪/水与岩浆相接时生成方解石） |

| noEndPortalTeleport | false | 末地传送门传送控制：配合 /playerNoEndPortalTeleport 的名单与 globalMode 决定哪些玩家不被传送 |

| terracottaUncolor | false | 切石机把染色陶瓦 / 染色釉陶瓦还原为普通陶瓦；启用时自动向世界部署数据包配方并随规则启停 |

| haoBedrockMines | false | 基岩可被挖掘：默认按黑曜石硬度，掉落 1 块基岩；与 Carpet-AMS-Addition 的 commandCustomBlockHardness 同时开启时遵循其对 minecraft:bedrock 的自定义硬度 |

选项规则

| 规则 | 可选值 | 说明 |

|---|---|---|

| witherSkeletonDropReduction | false | bone | coal | skull | sword | all | 自定义去除凋零骷髅掉落：骨头 / 煤炭 / 凋零骷髅头颅 / 掉落的手持石剑；all 为全部去除 |

示例规则

扩展自带的模板规则（归类 haoaddition，可用 /haoaddition 命令管理）：exampleBoolean、exampleString，仅作示例，可按需删除。

命令

/zoneguard

• /zoneguard set <id> <from> <to> — 新增/覆盖一个立方区域（id 为整数，from/to 为方块坐标）

• /zoneguard view — 查看已配置区域

• /zoneguard clear <id> — 删除指定区域

• /zoneguard op add|remove|list <player> — 管理 ZoneGuard 权限（允许操作该命令的玩家）

• /zoneguard help — 帮助

> 规则关闭时命令不可见（切换规则后会向在线玩家重新推送命令树）。

/playerNoEndPortalTeleport

• /playerNoEndPortalTeleport add|remove <player> — 名单增删

• /playerNoEndPortalTeleport list / clear — 查看 / 清空名单

• /playerNoEndPortalTeleport globalMode [true|false] — 查看 / 设置全局模式（true = 所有玩家都不被末地门传送）

• /playerNoEndPortalTeleport help — 帮助

构建

需要 JDK 21+（本仓库用 Java 21 目标，实测 Java 25 也可构建）：

.\gradlew.bat build

26.x 使用**独立子工程** modern/26.2/（新版 Loom 插件 net.fabricmc.fabric-loom、不声明 mappings、Java 25）：

cd modern.2

.\gradlew.bat build

1.21.x 产物汇总在根 build/libs/（每个受支持版本一个 jar）：

build/libs/carpet-hao-addition-0.1.2+1.21.jar

build/libs/carpet-hao-addition-0.1.2+1.21.1.jar

build/libs/carpet-hao-addition-0.1.2+1.21.2.jar

build/libs/carpet-hao-addition-0.1.2+1.21.4.jar

build/libs/carpet-hao-addition-0.1.2+1.21.6.jar

build/libs/carpet-hao-addition-0.1.2+1.21.8.jar

build/libs/carpet-hao-addition-0.1.2+1.21.10.jar

build/libs/carpet-hao-addition-0.1.2+1.21.11.jar

26.x 为独立子工程，需在各自目录构建，产物在 modern/<mc>/build/libs/：

cd modern/26.2

.\gradlew.bat build

各版本独立构建也可用 :versions:<mc>:build。

开发运行

首次运行需在 versions/<mc>/run/eula.txt 写入 eula=true：

.\gradlew.bat :versions:1.21.8:runServer

.\gradlew.bat :versions:1.21.8:runClient

项目结构

• src/main/java/carpet_hao_addition/

• CarpetHaoAdditionExtension.java — 扩展入口（ModInitializer + CarpetExtension），解析各规则类、注册命令、处理规则变更回调

• *Settings.java — 共享规则定义（仅依赖 carpet API，不引用 Minecraft 版本类型）

• portal/ — 末地门传送名单（PlayerNoEndPortalTeleportList）

• src/main/resources/

• fabric.mod.json — 模组元数据与依赖

• assets/carpet-hao-addition/lang/{en_us,zh_cn}.json — 全部用户可见文案（规则名/描述/命令消息）

• versions/1.21.8/、versions/1.21.10/

• gradle.properties — 该版本的 minecraft / yarn / loader / carpet 版本

• src/main/java/carpet_hao_addition/ — 版本专用实现：mixin、zoneguard/、portal/、RecipeDeployHooks 等

• src/main/resources/carpet-hao-addition.mixins.json — 该版本的 mixin 列表

根 build.gradle 汇总各版本子模块，版本层代码与共享层一起合并进对应版本的 jar。

开发注意事项

• **规则开关的权威读取**：使用各 *Settings.isEnabled() / value()（读取 Carpet 默认管理器中的规则值），不要直接读 @Rule 静态字段（carpet 新规则系统不保证回写字段）。

• **文案**：所有用户可见文本放 assets/carpet-hao-addition/lang/*.json（中英成对），Java 内零硬编码；聊天/命令消息在服务端渲染，兼容纯服务端与未装本模组的客户端。

• **Mixin 兼容性**：避免使用 @Redirect（旧版 mixinextras 0.5.4 会因 FactoryRedirectWrapperMixinTransformer 抛 ClassCastException 而崩溃），优先 @ModifyArg / @WrapOperation / @Inject。

• **版本 API 漂移按各自 jar 字节码确认**，例如：1.21.10 死亡掉落改走 LivingEntity.generateLoot(...)（而非 1.21.8 的 dropLoot 内直接调用）、1.21.10 的 EndPortalBlock.onEntityCollision 多一个 boolean 形参。

• 与其它 Carpet 扩展**同名规则会互相覆盖**（Carpet 默认管理器按规则名索引），新增规则请使用本模组自有命名（如 haoBedrockMines）。

致谢

• 基于 fabric-carpet-extension-example-mod 改造。

• 部分规则思路参考社区扩展：Carpet-AMS-Addition、Carpet-FGA-Addition 等。