RaishxCore

RaishxCore 是 Minecraft 1.21.1 / NeoForge 平台上面向 AE2 的高级附属模组所共享的基础库。 它并非独立的内容模组：当其他模组（例如 UFO Future）需要它时，请安装它。

RaishxCore 0.1.0 处于公开测试阶段。 其稳定契约已可供使用方使用；被明确标记为实验性的 API 在 1.0 之前可能仍会发生变化。

✨ 提供的内容

• 精确的高量级数值，使用 BigInteger，并针对超出常规整数限制的数值提供安全序列化和人性化格式化。
• 多方块契约，用于不可变结构、等级定义、朝向、运行时状态、视觉特效和验证。
• 事务性端口，用于物品、流体、化学品、能量和冷却液：可模拟、规划、提交或回滚，而不会复制或丢失资源。
• 可复用的 AE2 风格 UI 组件，用于附属模组的菜单和客户端控件。
• 受保护的机器网络通信，带有服务端验证和按玩家计算的操作频率限制。
• AE2 合成支持，用于共享 CPU 容量、合成基础设施、修订版本以及协作式图捕获流水线。

🧠 协作式 AE2 规划

RaishxCore 可以将迭代式规划器与 AE2 集成。图捕获被拆分为有界的服务端线程时间片和共享的每 tick 预算，因此大型网络不会独占一个 tick。该规划器具有取消、背压、按网格熔断、诊断功能，以及一个配置开关，可将新请求交还给 AE2 内置的规划器。

此功能面向需要极端合成规模基础设施的附属模组作者和整合包——并非宣称可替代所有 AE2 规划工作负载。

📦 要求

依赖项	所需版本
Minecraft	1.21.1
NeoForge	21.1.216+
Applied Energistics 2	19.2.17–19.x

将 RaishxCore 的 JAR 文件与需要它的附属模组一同放入 mods/ 文件夹。UFO Future 3.0.0-beta.1 需要 RaishxCore 0.1.0-beta.1 或兼容的后续 0.1.x 版本。

🧩 面向附属模组开发者

公共 API 按领域组织：

• api.amount — 精确的非负数值和有理数速率
• api.multiblock — 结构、角色、扫描/运行时结果和视觉效果
• api.port — 确定性的物品、流体、化学品、能量和冷却液端口
• api.transaction — 模拟/规划/提交传输契约
• api.tier — 等级定义和验证
• api.crafting — 共享合成容量和规划器集成
• client.gui.widget — 可复用的仅客户端组件

有关设置、配置和 API 详细信息，请参阅使用方集成指南和源代码仓库。

📜 许可证

RaishxCore 采用 LGPL-3.0-or-later 许可证。

由 Raishxn 构建。