# FC6 整合包加装 mod 报告：矿物高亮 + 下界床不爆炸

日期：2026-11-04 10:55（北京时间）
整合包：Farming Crossing 6 / Minecraft 1.21.1 / NeoForge 21.1.218 / 服务端 209 jar、客户端包 214 jar
结论：**两个 mod 都找到原生 1.21.1 NeoForge 版本，静态校验 + 临时实例真机加载全部通过。**
客户端渲染效果（矿石发光画面）无法在这台无头机器上验证，见「已知局限」。

---

## 一、选了什么

### 1. 矿物高亮 → Glowing Emissive Ores Definitive Edition（简称 GEODE）

| 项 | 值 |
|---|---|
| Modrinth slug | `glowing-emissive-ores-definitive-edition` |
| 项目 ID | `U8Iw4AfP` |
| 版本号 | 1.0.4（`1.0.4-rp1.117.0`，release） |
| 构建号 / 版本 ID | `Kc5khGR3`，内部资源包版本 RP 1.117.0 |
| modId | `geo_mod` |
| 文件名 | `GEODE-v1.0.4-RP1.117.0-mc1.18-26.3.jar`（10.4 MB） |
| 发布日期 | 2026-10-31（发布 2026-06-26，仍在活跃更新） |
| 下载量 | 191,071 |
| 支持版本 | 1.18 ~ 26.3 全量，NeoForge / Forge / Fabric 同一 jar |
| 端 | 客户端必需，服务端官方标记 unsupported（纯客户端效果） |
| 下载地址 | https://cdn.modrinth.com/data/U8Iw4AfP/versions/Kc5khGR3/GEODE-v1.0.4-RP1.117.0-mc1.18-26.3.jar |
| 项目页 | https://modrinth.com/mod/glowing-emissive-ores-definitive-edition |
| SHA256 | `ca4be2705d17a51e3ceb84d2249b09ed0fba8f3a688e20d85d3eae942e679a11` |

为什么选它：
- 三个候选里唯一**维护中**（2026-10-31 还在更新，三天前）、下载量 19 万；其余两个：`Glore` 1.4.1 停在 2024-09，`Mini's Universal Glowing Ores` 是 0.0.2 alpha 只有 587 下载。
- 它给**原版 + 300 多个模组的矿石**都做自发光贴图，我们这个包有 advancednetherite、create、biomeswevegone 等一堆自定义矿石，正好吃得上；`Glore` 只覆盖原版矿。
- 运行时按已装 mod 只加载用得到的那部分资源，作者说是比等效资源包快约 30 秒左右的加载时间。
- 自带游戏内配置界面（发光亮度滑块 + 开关按键），不用手改 json。

### 2. 下界床不爆炸 → Beds Don't Explode

| 项 | 值 |
|---|---|
| Modrinth slug | `beds-dont-explode` |
| 项目 ID | `EBYq63uy` |
| 版本号 | 1.0（`1.0`，release） |
| 构建号 / 版本 ID | `rGIddzLo` |
| modId | `bedsdontexplode` |
| 文件名 | `bedsdontexplode-neoforge-1.21-1.0.jar`（13 KB） |
| 发布日期 | 2026-07-05 |
| 下载量 | 4,137 |
| 支持版本 | 1.21 / 1.21.1，loader 仅 neoforge |
| 端 | 客户端 + 服务端都要（爆炸判定在服务端） |
| 下载地址 | https://cdn.modrinth.com/data/EBYq63uy/versions/rGIddzLo/bedsdontexplode-neoforge-1.21-1.0.jar |
| 项目页 / 源码 | https://modrinth.com/mod/beds-dont-explode ／ https://github.com/jodlodi/BedDontExplode |
| SHA256 | `aa542f2695f0ea42c8828a51b83d55f8919854e5cd89bf267c9bcef6e4291c19` |

为什么选它：
- 行为正好对上需求：下界/末地用床不再爆炸，只弹一句"你不能在这里睡觉"的提示（和白天睡觉同一句），**人不会被炸死、地面不会炸出坑**。
- 注入点很窄，风险低（见下节 bytecode 分析），不会影响主世界正常睡觉。
- 有 GitHub 仓库和 issue 区，LGPL-2.1 许可，2026-07 发布。

搜索里排除掉的：
- `Better Safe Bed`（110 万下载）：解决的是"周围有怪睡不着"，不是防爆炸，147 万下载也对不上需求，且 1.21.1 版本停在 2024-07。
- `Glore`：见上，2024-09 停更。
- 其余"safe bed / sleep in nether"关键词搜出来的都是改睡眠人数、睡眠过夜机制（Sleep / Seamless Sleep / Sleep Tight 等），不防爆炸。
- 明确没有 1.21.1 NeoForge 版本的：CurseForge 上几个老的 "Beds Don't Explode"（1.12/1.16 Forge 版）没拿来做近似凑数。

---

## 二、静态校验（解包读 `META-INF/neoforge.mods.toml`）

### 版本范围与依赖

| mod | 声明的 minecraft range | 覆盖 1.21.1 | 其他依赖 | 现装是否都有 |
|---|---|---|---|---|
| `geo_mod` 1.0.4 | `[1.21,1.21.2)` | ✅ | 只依赖 minecraft；对 `modernfix` 是可选集成（`client_entrypoint`） | modernfix 在 209 个里 ✅ |
| `bedsdontexplode` 1.0 | `[1.21.0, 1.22)` | ✅ | `neoforge [2,)` + `minecraft` | NeoForge 21.1.218 满足 ✅ |

两个 mod 都**没有** required 的第三方前置，不需要额外装 lib。

### modId 重名排查

扫描服务端 `mods/` 全部 209 个 jar，解析出 **253 个 modId**（有 jar-in-jar 内嵌），`geo_mod` / `glore` / `bedsdontexplode` / `geode` **均不冲突**。

### mixin 冲突分析（这步比看 toml 更关键）

- `bedsdontexplode` 的 `MixinBedBlock` 注入 `BedBlock#useWithoutItem`，`@At(INVOKE, target = Level.removeBlock(BlockPos,Z), ordinal = 0)`，cancellable —— 也就是只掐掉"床不生效→删方块→爆炸"这一条分支，主世界正常睡觉完全不受影响。
- 现装 `betterbeds-1.4.0` 也有个 `MixinBedBlock`，但它注入的是 `getRenderShape`（渲染），且在 `client` 列表里。两者目标方法不同，**不打架**。
- `geo_mod` 的服务端 mixin 配置里 `client` 数组已把 `PackSelectionModelMixin` / `LegacyForgeEmissiveQuadLightingMixin` 排除，专属 `GeoLoaderMixinConfigPlugin_neoforge` 做端侧判定。

### 打包形态注意

GEODE 是 **Forgix 多版本合包**（外层只有 locator + `META-INF/forgix/multiversion/*` 里各 MC 版本的内层 jar）。1.21.1 命中内层 `GEO-v1.0.4-mc1.21.jar`（`minecraft [1.21,1.21.2)`）。这种包在 NeoForge 21.1.218 上能否被识别，光看 toml 是判不出来的，必须真机加载——见下节，实测通过。

---

## 三、真机加载测试（临时实例，生产服与存档未动）

前提确认：`minecraft-fc6.service` 状态 = **inactive**，`latest.log` 最后没有 `joined the game`，无人在玩。

测试实例配置：

| 项 | 值 |
|---|---|
| 目录 | `/mnt/ssd/minecraft/test-addition`（从生产 server 目录 rsync，**排除 `world*` / logs / crash-reports**） |
| jar 数 | 211（209 原有 + 2 新增） |
| 端口 | 25599（生产 25565 未占用/未启动） |
| 世界 | `testworld`，全新生成，与生产 `world` 完全隔离 |
| 内存 | `-Xms1G -Xmx3G`（G1GC），全程单 JVM |
| 用时 | 启动 10:49:0x → `Done` 10:50:08 |

关键日志行（`/tmp/test-addition.log`）：

```
303|        Balm 21.0.56 (balm)
305|        Beds Don't Explode 1.0 (bedsdontexplode)          ← 新增 mod 进加载清单
391|        Glowing Emissive Ores Definitive Edition 1.0.4 (geo_mod)   ← 新增 mod 进加载清单
667|[10:49:35] [modloading-worker-0/INFO] [geo_mod/]: Initializing Glowing Emissive Ores Definitive Edition 1.0.4 on NEOFORGE
2126|[10:50:08] [Server thread/INFO] [minecraft/DedicatedServer]: Done (11.706s)! For help, type "help"
```

判定项：

| 检查 | 结果 |
|---|---|
| 跑到 `Done (xx.xxxs)!` | ✅ `Done (11.706s)!` |
| `Missing or unsupported mandatory dependencies` | ✅ 0 条 |
| mod 加载异常 / 拒绝加载（`rejected` / `Failed to create mod file` / `incompatible mod set`） | ✅ 0 条 |
| `/FATAL`、崩溃报告、`Encountered an unexpected exception` | ✅ 0 条 |
| Forgix 多版本合包被正确识别 | ✅ 内层 1.21 载荷载入，`geo_mod` 初始化成功 |
| `bedsdontexplode` mixin 应用 | ✅ 唯一相关提示是 `refmap.json could not be read`（开发环境专用提示，无害） |

日志里另有若干 warn/error，**均为整合包原有问题**，已比对生产 `logs/latest.log` 确认同一批存在，不是本次加的 mod 引起：
- `biomeswevegone` 相关 `create:` 配方解析失败（生产日志 12 条，测试实例同款）
- `@Mixin target net.minecraft.client.renderer.Sheets was not found ... from mod shouldersurfing`（生产日志第 638~639 行同款）
- `recipeessentials` / `modernfix` 的 `@Redirect conflict`（两者早就共存）

测完处理：`kill -TERM` 停掉临时 JVM（2 秒退出，无残留 java 进程），内存回到可用 5.9G；测试目录 `/mnt/ssd/minecraft/test-addition` 已删除（日志已留存到 `reports/FC6-mod测试日志-20261104.log`）。生产 `world*` 全程未碰，`minecraft-fc6.service` 全程未启动/未重启。

---

## 四、怎么装进整合包

**不需要改任何配置，放 `mods/` 就行。**

客户端包（`我的世界·农场生存-解压即玩-v4.zip`）解压后的目录：

```
农场生存-解压即玩\.minecraft\mods\
        ├─ 原有 214 个 jar
        ├─ GEODE-v1.0.4-RP1.117.0-mc1.18-26.3.jar      ← 放这里（纯客户端，服务器不用装）
        └─ bedsdontexplode-neoforge-1.21-1.0.jar       ← 放这里（客户端也放，两边一致）
```

服务端（如果要让下界床防爆全服生效）：

```
/mnt/ssd/minecraft/server/mods/bedsdontexplode-neoforge-1.21-1.0.jar
```

- 服务端加 mod 必须停机，按下 `systemctl restart minecraft-fc6`（约 28 秒，实测 `Done (0.967s)`）。**本次没有动它**，等你确认没人在线再装。
- GEODE 官方标记服务端 unsupported，**建议只放客户端**；实测塞进服务端也能正常起（不会崩），但没必要。
- GEODE 装完进游戏：Esc → 选项 → 控制 里能搜到它的按键；配置界面有"发光亮度"滑块和总开关。

---

## 五、已知局限

1. **客户端画面没验证。** 这是纯客户端渲染效果（矿石发光），这台机器无桌面、且当时内存可用只有 ~5.9G：生产服务端本体 3.3G、Windows VM 占 4G、swap 已用 7.5/8G，再起一个 214 mod 的 MC 客户端（还得 Xvfb + 软件 OpenGL 跑 Sodium/Iris，稳定性和耗时都不可控）会直接拖死正在跑的服务。按你的要求"不够就别硬上"，所以**没有跑客户端渲染截图**。
   - 能证明的是：jar 在 1.21.1 + NeoForge 21.1.218 上被正确识别、`geo_mod` 初始化成功、没有崩、没有补丁冲突。
   - 不能证明的是：进游戏后矿石真的发光、亮度/观感如何、和你装的 Iris 光影（`iris-neoforge-1.8.12`）叠一起是什么效果。
2. **下界床防爆是服务端逻辑**，测试实例里只验证了 mod 加载与 mixin 应用，**没有真人进下界放床真炸一次来对比**（临时世界没人操作，也没有 RCON 可以派命令）。要拿到"真不炸"的实锤，得等装到生产服后由真人试一次（或者你让我用 VM 起客户端进测试服试）。
3. **GEODE 许可是 All Rights Reserved**：自己玩、自己整合包加装没问题；如果你要把这两个 jar 一起打包分发给朋友，建议让玩家自己去 Modrinth 点下载（我们这边给的 drop-in 包只解决"你自己这台/你的整合包"）。
4. `bedsdontexplode` 下载量只有 4 千，作者单人项目，属于小 mod；行为单一、代码 13KB，风险可控但生态验证不如大 mod。

---

## 六、产物

| 文件 | 路径 | 大小 |
|---|---|---|
| 矿石高亮 | `/mnt/ssd/minecraft/downloads/mods-addition/GEODE-v1.0.4-RP1.117.0-mc1.18-26.3.jar` | 10 MB |
| 下界床防爆 | `/mnt/ssd/minecraft/downloads/mods-addition/bedsdontexplode-neoforge-1.21-1.0.jar` | 13 KB |
| 安装说明 | `/mnt/ssd/minecraft/downloads/mods-addition/安装说明.txt` | 1.6 KB |
| 打包好的拖入包 | `/mnt/ssd/minecraft/downloads/mods-addition/FC6加装mod-矿物高亮与地狱床.zip` | 9.9 MB |
| 测试实例日志 | `/tmp/test-addition.log`（临时，需要的话我挪到 reports/ 存一份） | — |
