RaishxCore

RaishxCore 是 Minecraft 1.21.1 / NeoForge 上高级 AE2 扩展模组共用的基础前置库。它不是独立内容模组：如果其他模组（例如 UFO Future）需要它，请一并安装。

RaishxCore 0.1.0 目前处于公开 Beta 阶段。其稳定接口已可供使用者调用；明确标记为实验性的 API 在 1.0 发布前仍可能变更。

✨ 提供的功能

• 超大数值精确表示，使用 BigInteger，支持安全序列化，并能以便于阅读的格式显示超出常规整数范围的数值。
• 多方块结构接口，适用于不可变结构、等级定义、朝向、运行时状态、视觉效果和验证。
• 事务型接口，适用于物品、流体、化学品、能量和冷却液：可模拟、规划、提交或回滚传输，避免资源重复或丢失。
• 可复用的 AE2 风格 UI 控件，供扩展模组菜单和客户端控件使用。
• 带防护的机器网络，包含服务端验证和按玩家设置的操作频率限制。
• AE2 合成支持，涵盖共享 CPU 容量、合成基础设施、修订版本管理和协作式图捕获流程。

🧠 AE2 协作式规划

RaishxCore 可将迭代规划器接入 AE2。图捕获会拆分为有上限的服务端线程分段，并共享每刻预算，避免大型网络独占一个游戏刻。规划器支持取消、背压、按网络熔断、诊断信息，以及配置项形式的紧急停用开关；启用后，新请求将交回 AE2 内置规划器处理。

此功能面向需要超大规模合成基础设施的扩展模组作者和整合包；并不意味着它要取代 AE2 的所有规划工作负载。

📦 依赖要求

将 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 制作。