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](https://github.com/gnembon/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 也可构建）：

“`powershell

.\gradlew.bat build

“`

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

“`powershell

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/`：

“`powershell

cd modern/26.2

.\gradlew.bat build

“`

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

### 开发运行

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

“`powershell

.\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](https://github.com/gnembon/fabric-carpet-extension-example-mod) 改造。

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