锈蚀铁核

简介

一个专为 Minecraft MITE 设计的强大一体化库与实用模组，为模组开发者提供了海量的 API、事件钩子、世界生成、实体、合成配方、网络连接以及生活质量优化功能。

概述

RustedIron Core (RIC) 是一个专为 MITE Minecraft 模组开发环境打造的核心库模组。它整合了一套全面的事件系统、注册接口、世界生成工具、网络工具、实体逻辑钩子以及各种兼容性补丁。该模组大大降低了其他模组二次开发的难度，避免了重复编写 Mixin，修复了许多原版和 MITE 原生错误，并确保了多模组环境下的稳定运行。它是大量 MITE 生态模组的强制依赖模组。

核心特性

1. 丰富的事件与处理器系统

一个完整的事件总线与专用处理器几乎覆盖了所有游戏逻辑环节，支持前/后注册以控制执行优先级：

• 玩家相关：玩家生成、维度切换、死亡、属性修改（生命值、饥饿度、饱和度、等级上限、胰岛素抵抗）、营养值同步、客户端连接与按键绑定注册。
• 战斗系统：修改受到的伤害、护甲保护、近战伤害、方块/实体交互范围、挖掘速度、击退与摔落伤害。
• 实体与生成：实体事件监听、ServerPlayer 死亡事件、针对特定生物群系的自定义生物生成规则、实体追踪器与网络同步配置。
• 村民与交易：完整的村民职业与交易系统，可添加/删除/编辑交易条目，禁用特定职业，实时自动同步交易界面。
• 合成与烧炼：高级配方注册、自定义物品消耗规则、合成品保留特性、特殊熔炉配方、烧炼配方的热量值需求配置。
• 提示框与显示：在物品提示框的多个位置注入自定义内容，支持完整的物品堆信息。
• Tick 与渲染：独立的客户端/服务端 Tick 监听器、渲染 Tick 钩子，用于逐帧逻辑。

2. 世界与生物群系生成

强大的世界生成 API，无需复杂的 Mixin 即可自定义地形、矿石、结构和生物群系：

• 矿石生成：专用的矿石注册处理器，针对下界矿石有专属高度规则，支持注销现有矿石条目，修复了下界的崩溃和无效生成问题。
• 生物群系系统：修改可生成的生物群系，向指定生物群系添加生物生成，控制要塞生成，支持 Underworld 生物群系注册与装饰，移除 Underworld 中的无效平原。
• 结构与地图生成：新增的 MapGenHandler 用于结构和地图生成元素注册，重构了结构注册逻辑。
• 区块与世界信息：从 level.dat 读取/写入数据，区块加载/卸载监听器，Underworld 生成代理（默认启用）。

3. 物品、方块与模型支持

为各种物品、方块和模型简化注册与渲染方案：

• 统一物品接口：一站式配置燃料、可燃物品、宝石物品、桶材料、弓/箭材料、护甲材料和可保留的合成品。自动适配木碗和奶桶以修复 getPeer 崩溃。
• JSON 模型加载器：原生支持 JSON 方块/物品模型，自动从 blockstates 和 models 文件夹加载资源，兼容库存、掉落物和手持渲染。
• 战利品表：扩展原版战利品表，适用于沙漠神殿、丛林神殿、下界要塞、废弃矿井和要塞；自定义沙砾掉落规则，提供添加/移除战利品条目的功能。
• 特殊物品逻辑：针对特定物品的烧烤式直接烧炼功能，箭头、门、钓鱼竿和工作台的快速注册（无需额外 Mixin）。

4. 网络与数据包优化

稳定且扩展的网络系统，修复原版同步问题：

• 扩展的 PacketByteBuf 支持读写 short、long、double 等数据类型；暴露了内部 IO 流。
• 全局广播数据包方法，可向所有在线玩家发送消息。
• 修复了空数据包读取错误以及因字符串长度问题导致的玩家踢出。
• 优化了营养值与属性同步数据包（不进行每 Tick 发送，仅在指定时刻同步以减少网络负载）。
• 修复了玩家重生或维度传送后，客户端与服务端营养值不同步的问题。

5. 兼容性、Bug 修复与生活质量提升

• 跨版本与模组兼容性：完全兼容常规 MITE 和实验性 MITE 版本；优化了团队协作的 Gradle 构建脚本；规范了包名以避免 Mixin 冲突；修复了因中文键导致的配置解析错误。
• 主要 Bug 修复：解决了未注册的奶桶、重复的村民交易配方、缺失的生物纹理、沙砾战利品错误、熔炉配方忽略热量值等导致的崩溃问题。
• 可配置调整：切换核心模组启动公告（时长缩短至 30 秒，可完全禁用）；针对服务器在线模式的专用设置，可自动隐藏公告。
• 开发工具：平台信息查询工具、本地化枚举、用于独立日志文件的日志工具、Fabric 兼容工具以及开发者友好的 Javadoc 注释。