# MC数据包 - 可再生资源综合增强

## 基本信患

- **平台**: Minecraft Java Edition only（基岩版不兼容）
- **兼容版本**: 1.21.1
- **数据包名称**: `renewable-resources`（命名空间: `renewable`）
- **文件总数**: 45 个文件
- **安装**: 放入 `saves/<世界>/datapacks/`，进游戏 `/reload`

## 功能清单（4大模块）

> 附魔、世界生成模块因 1.21.1 API 大幅变更已暂时移除，后续可单独适配。

### 1. 配方 (35个) — `data/renewable/recipe/`

**可再生资源 (14个):**
- 砂砾烧炼→沙子、4沙+红染料→4红沙
- 羊毛+粘液球→海绵
- 4珊瑚扇→珊瑚块（5色各一）
- 9冰→浮冰、9浮冰→蓝冰
- 砂岩+末影珍珠+紫颂果→末地石
- 圆石烧炼→下界岩
- 闪长岩+骨粉→方解石、砂砾+圆石→凝灰岩

**已移除/无法合成配方 (13个):**
- 附魔金苹果（8金块+1苹果，1.9被删的原版配方）
- 鞘翅（6幻翼膜+1钻石，翼形排列）
- 鞍（5皮革+3铁锭，1.6.1被删的原版配方）
- 马铠×3（铁/金/钻石，M形排列）
- 命名牌（铁锭+纸+线无序合成）
- 锁链盔甲×4（铁粒合成，约为铁甲1/9成本）
- 三叉戟（海晶碎片+海洋之心+木棍）
- 钟（金锭+木棍）

**废石转换 (6个):**
- 8圆石+砂砾→8安山岩、8圆石+骨粉→8闪长岩、8圆石+红砖→8花岗岩
- 安山岩/闪长岩/花岗岩 烧炼→石头

**其他 (2个):**
- 紫水晶母岩（8方解石+1紫水晶块）
- 海洋之心（8鹦鹉螺壳+1钻石）

### 2. 战利品表 (5个) — `data/minecraft/loot_table/`

**尸壳掉落:** 新增0~2沙子掉落（保留原版腐肉+稀有掉落）

**钓鱼重做 (4个文件):**
- 概率: 鱼60% / 垃圾25% / 宝藏15%（原版85/10/5）
- 垃圾扩增至26种（铁粒、金粒、海晶碎片/砂粒、幻翼膜、粘液球、紫水晶碎片等）
- 宝藏扩增至17种（钻石、绿宝石、海洋之心、回响碎片、三叉戟、附魔金苹果、鞘翅、钻石马铠等）
- 海之眷顾(LotS)加成保留

### 3. 流浪商人 (88个交易) — `data/minecraft/trades/`

完全覆盖原版流浪商人，价格从1绿宝石到20绿宝石，涵盖：
- 不可再生矿物：远古残骸(8)、下界合金碎片(8)
- 结构限定：回响碎片(6)、幽匿催发体(8)、幽匿尖啸体(5)、沉重核心(10)
- 生物群系限定：孢子花(2)、珊瑚扇(2)、菌丝(2)、灰化土(2)
- 极难量产：下界之星(15)、信标(20)、龙首(12)、鞘翅(10)
- 唱片5种、旗帜图案4种、蛛网、枯灌木、嗅探兽蛋 等

### 4. 自动加载 — `data/minecraft/tags/function/` + `data/renewable/function/`

- `load.json` 标签在每次 `/reload` 时运行，发送通知

## 目录树

```
renewable-resources/
├── pack.mcmeta                              # min_format: 48, max_format: 94 (1.21.1)
├── data/
│   ├── renewable/
│   │   ├── advancement/recipes.json          # 配方自动解锁
│   │   ├── function/load.mcfunction
│   │   └── recipe/                           # 35个配方
│   └── minecraft/
│       ├── trades/wandering_trader.json     # 88个交易
│       ├── loot_table/
│       │   ├── entities/husk.json           # 尸壳掉沙
│       │   └── gameplay/
│       │       ├── fishing.json             # 钓鱼主表
│       │       └── fishing/
│       │           ├── fish.json
│       │           ├── junk.json            # 26种垃圾
│       │           └── treasure.json        # 17种宝藏
│       └── tags/function/load.json
```

## 数据包能力速查

| 能 | 不能（需要Mod） |
|----|----------------|
| 合成/烧炼/锻造配方 | 新方块/新实体 |
| 实体掉落/钓鱼/箱子战利品 | 方块交互逻辑（铁砧砸、右键等） |
| 流浪商人/村民交易 | 闪电/实体转化检测 |
| 进度/谓词/标签 | 渲染/粒子/模型 |
| Tick/Load自动函数 | GUI/网络协议 |
| — | 注册新方块实体 |
| — | AI行为修改 |

## 参考来源

- MC百科 数据包教程: https://www.mcmod.cn/post/3014.html
- 香草图书馆: https://vanillalibrary.mcfpp.top/datapack-index
- Minecraft Wiki: https://zh.minecraft.wiki/w/Tutorial:制作数据包
- Carpet Mod: https://github.com/gnembon/fabric-carpet
- Carpet Extra: https://github.com/gnembon/carpet-extra

## 测试方法

1. 将 `renewable-resources/` 放入 `.minecraft/saves/<世界>/datapacks/`
2. 进游戏，执行 `/datapack list` 确认加载
3. 执行 `/reload` 重载
4. 配方进游戏自动解锁，工作台/熔炉直接查看
5. 钓鱼概率修改直接生效
6. 流浪商人下次刷新时使用新交易
7. 尸壳击杀掉落沙子直接生效
8. 错误日志: `logs/latest.log`