Carpet-Hao-Addition
- By
Toggleable Carpet rules for Minecraft 1.21–26.2: zone guard, golden carrot compost, snowy calcite, end portal whitelist, terracotta uncolor, mineable bedrock, wither skeleton drops.
**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 等。
The Carpet-Hao-Addition Team
