Applied KubeJS

Applied KJS（AE2 × KubeJS 桥接）

一款功能强大的 AE2 ↔ KubeJS 桥接模组，专为整合包开发者打造，提供可脚本化的 AE2 配方、网络监控、存储/合成事件、设备检查，以及可选的 ME 合成任务自动化功能。

Applied KJS是一款连接Applied Energistics 2 (AE2)与KubeJS的桥接模组，让整合包开发者能够通过脚本深入访问 AE2 系统，无需为每个整合包单独编写 Java 附属模组。

如果你想通过 KubeJS 构建以 AE2 为核心的进度系统、自动化、诊断、警报或配方改造，这款模组正是为此工作流程打造的。

Wiki 页面可在此处查看！（页面即将推出，你可以在此处查看我的拉取请求，也可以在此处查看 Wiki 页面的原始代码。）

---

本模组新增内容

✅ KubeJS 的 AE2 配方脚本辅助工具

通过脚本创建和管理 AE2 配方 JSON，并提供常见 AE2 配方类型的辅助工具，例如：

• 充能器配方
• 压印器配方（包括模具式配置）
• 转化配方
• 熵变配方（加热/冷却行为）
• 物质炮弹药行为条目

还包括以下实用工具：

• 安全地构建配方 JSON
• 验证并转换配方 JSON 为字符串
• 通过 KubeJS 添加/移除 AE2 配方
• 按输出物品、类型或 JSON 匹配模式移除配方（适用于大型整合包改造）

---

✅ 向 JS 暴露 AE2 Key 封装对象（物品/流体）

在 KubeJS 友好的对象中使用 AE2 风格的物品/流体 Key。

这让你能够更轻松地：

• 解析 AE2 物品/流体标识符
• 比较 Key（精确/模糊匹配）
• 读取 ID、模组 ID 和显示名称
• 以类似 AE2 的方式格式化数量
• 将 Key 数据序列化为 JSON，用于日志、界面或调试

非常适合需要以清晰方式读取 AE2 存储/合成数据的脚本。

---

✅ ME 网络（网格）监控 API

通过脚本检查和追踪 AE2 网络。

桥接模组可提供网格摘要和网络状态，方便你围绕以下内容构建自定义逻辑：

• 网络在线/离线状态
• 能量存储与使用情况
• 控制器/通道状态
• 节点数量
• CPU 数量
• 请求/合成数量
• 存储摘要信息

特别适用于：

• 进度系统
• 自定义任务
• 服务器诊断
• 自动化触发器
• 管理工具和警报

---

✅ KubeJS 的 AE2 活动事件（服务端）

在脚本中直接响应 AE2 事件。

事件类别示例包括：

网络生命周期/状态

• 网络创建/移除
• 网络变更
• 网络能量状态变化

存储追踪

• 存储量变化（物品/流体数量变动）
• 阈值越界事件（自定义监控触发器）

合成生命周期

• 合成请求
• 合成任务开始/完成/停止
• 卡住的合成检测事件

玩家互动/进度系统钩子

• 终端打开事件
• 玩家里程碑事件（用于教程/任务进度）

这样即可实现高度动态的整合包逻辑，例如：

• ME 系统断电时向玩家发出警告
• 库存达到阈值时触发任务
• CPU 卡住时记录日志或通知管理员
• 玩家首次与 AE2 终端互动时解锁指南章节

---

✅ 存储阈值监控

为指定 AE2 物品/流体注册监控（可选限定特定网格），并在存储量越过阈值时触发响应。

非常适用于：

• 低库存警报
• 自动化进度检查
• 轻量自动化触发器
• 整合包健康状态监控/仪表盘

---

✅ 可选的脚本化 AE2 合成请求 API（高级）

通过脚本规划并可选择提交 AE2 合成任务。

可用于：

• 模拟/规划 ME 合成请求
• 检查所需字节数和任务详情
• 查看计划中的缺少、已使用和产出物品
• 在提供有效请求者上下文时提交任务
• 跟踪/取消已提交的任务

这是一项强大的功能，适用于希望实现由脚本控制 AE2 自动化逻辑的高级整合包。

重要提示：出于安全和控制考虑，合成请求 API 在服务器配置中默认处于禁用状态。整合包开发者必须手动启用。

---

✅ AE2 设备检查辅助功能

检查指定位置的 AE2 相关方块实体/设备，并读取可供脚本或管理工具使用的实用状态信息。

根据设备不同，信息可能包括：

• 类/类型名称
• 位置/维度
• 活动/供电状态
• 驱动器/箱子的存储摘要信息
• 已连接的网络摘要

适用于：

• 调试命令
• 管理脚本
• 任务验证
• 游戏内诊断工具

---

✅ 进度里程碑钩子（支持 AE2）

此桥接模组包含面向玩家进度和教程流程的里程碑式钩子。

可轻松构建整合包的新手引导逻辑，例如：

• 首次登录里程碑
• 首次 AE2 合成里程碑
• 合成控制器里程碑
• 合成终端/分子装配室里程碑
• 其他 AE2 进度检查点

非常适合：

• FTB Quests / 自定义任务书
• 游戏内教程系统
• 基于解锁机制的进度整合包

---

✅ 调试命令和数据转储

提供可选的管理/调试命令支持（服务端、权限控制），用于收集统计数据、网络摘要和诊断转储。

非常适用于：

• 整合包开发
• 多人游戏故障排查
• 分析脚本化配置中的 AE2 行为

---

整合包开发者为何可能需要此功能

Applied KJS可帮助你构建通常需要编写自定义 Java 集成模组才能实现的系统，例如：

• 支持 AE2 的进度脚本
• 动态配方平衡调整
• 库存监控和警报
• 脚本化自动化控制
• 自定义诊断仪表板
• 管理支持工具
• 与 ME 活动关联的事件驱动玩法

如果你已经大量使用KubeJS，此功能能让你以更深入的方式将AE2集成到整合包逻辑中。

---

使用示例

• 任务解锁：检测玩家首次打开终端，并解锁教程章节。
• 自动化安全：当 ME 网络断电或合成 CPU 卡住时提醒管理员。
• 资源管理：当 Certus Quartz 库存低于阈值时触发事件。
• 配方重制整合包：完全通过 KubeJS 替换/调整 AE2 机器配方。
• 进度整合包：合成关键 AE2 组件时授予里程碑。

---

配置（服务端）

此桥接模组支持配置，以满足整合包/服务器需求。
常见选项包括针对以下项目的开关和限制：

• 网络事件
• 存储事件
• 合成事件
• 终端事件
• 进度钩子
• 调试命令
• 合成请求 API
• 扫描间隔/跟踪限制
• 事件刷屏保护/节流
• 日志详细程度
• 维度筛选/允许列表

建议：先使用默认设置，仅在脚本需要时再启用高级功能（尤其是合成请求 API）。

---

要求/兼容性

• Minecraft：1.20.1（此处展示的是 Forge 构建版本）
• 需要：应用能源2（AE2）
• 需要：KubeJS
• 加载器：Forge（此项目页面/构建目标）

请务必查看文件选项卡和更新日志，确认整合包所需的正确模组版本和依赖版本。

---

脚本作者须知

此模组主要面向服务端整合包逻辑和整合包开发者的脚本工作流。

一般来说：

• 如有需要，可使用启动脚本注册可重复使用的辅助函数/常量
• 使用服务端脚本处理 AE2 事件、监控、阈值和自动化逻辑
• 仅当你使用的构建版本提供了面向客户端的特定集成时，才使用客户端脚本

---

权限与整合包使用

你可以在整合包中加入此模组，但须遵守项目的许可证/权限条款。
具体使用权限请参阅项目的代码仓库/许可证页面。

---

问题反馈

反馈问题时，请提供：

• Minecraft 版本
• 加载器/版本（Forge）
• AE2 版本
• KubeJS 版本
• Applied KJS 版本
• 日志和复现步骤
• 相关的 KubeJS 脚本（如适用）

这些信息能大幅加快集成问题的排查。

---

简而言之

Applied KJS可将 AE2 转变为由 KubeJS 驱动的整合包中的可脚本化系统，让你能够构建配方、响应 ME 事件、监控网络、检查设备，并可选择自动化 AE2 合成流程，大幅减少编写自定义 Java 代码的需求。