AE2合成优化器

AE2 Crafting Optimizer（ACO）是一款适用于 Applied Energistics 2 的 Forge 1.20.1 优化与大规模环境支持模组。

ACO 专为超大型自动化环境设计，在这些环境中，合成计算、样板供应器（Pattern Provider）执行、加工机械以及超大型合成 CPU 可能导致严重的 MSPT 或 TPS 峰值问题。

AE2 仍然是最终判断的唯一依据。ACO 不会改变配方、合成有效性、存储内容、网络拓扑结构或机械规则。

主要特性

• 对已在进行的相同合成计算进行去重。
• 缓存安全的、与计算无关的样板（Pattern）查找结果。
• 为 AQE 集成配置编译确定性的样板图谱（Pattern graph）。
• 使用经过检查的长整型（long）算术运算，仅在溢出后才提升为 BigInteger。
• 限制每个 CPU 和每个 ME 网格（ME Grid）每 tick 的合成执行工作量。
• 防止超大型合成 CPU 消耗整个服务器 tick。
• 保持显示的 CPU 容量和协处理器数量不变。
• 为 GTCEu 和 Mekanism 机械提供配方意图（recipe-intent）快速路径。
• 优化 Advanced AE 反应室（Reaction Chambers）中重复的配方搜索。
• 优化 ExtendedAE 的电路切割机（Circuit Cutters）和装配矩阵（Assembly Matrices）。
• 优化 AE2 Overclock 使用的反射和卡牌数量查找。
• 为缓慢的合成计算提供诊断信息。
• 包含针对样板访问终端（Pattern Access Terminal）中 Page Up/Down 滚动卡住问题的安全修复。

长合成订单

ACO 1.5.0 为数量大于 Integer.MAX_VALUE 的订单增加了一个独立的根订单输入路径。

• 从 1 到 Integer.MAX_VALUE 使用 AE2 原始的数据包和菜单路径。
• 从 Integer.MAX_VALUE + 1 到 Long.MAX_VALUE 使用 ACO 经过检查的 long 路径。
• 保留精确数量输入、重新规划、取消、返回和自动开始行为。
• 无效和溢出的值将被拒绝，而不会回绕成无关的数字。

此功能扩展了订单输入的边界。它并不会增加标准 AE2 合成 CPU 的容量。

BigInteger 与 AQE 集成

当同时安装了 Advanced AE 和 Advanced Quantum Engineering 时，ACO 可以启用其 AQE 专用的 BigInteger 配置。

超过有符号 long 限制的确定性合成计划将作为精确的 BigInteger 父作业保留。现有的 AE2 和机械 API 只会接收到经过验证适合有符号 long 限制的、针对特定配方的执行窗口。

ACO 提供：

• 精确的 BigInteger 合成核算。
• 经过检查的加、乘和除运算。
• 针对特定配方的执行窗口限制。
• 持久的多作业容量核算。
• 重启安全的作业元数据和指纹。
• 多个大型作业的公平执行。
• 为支持的 BigInteger 存储集成提供精确的库存辅助模块。
• 有界且带版本的状态同步。

实现上限为 10^16384 - 1。

普通的 AE2 和 Advanced AE CPU 不会自动转换为 BigInteger CPU。需要如 AQE 这样的显式集成 CPU 主机。

TPS 保护

大量的协处理器会增加样板的推送吞吐量，而不会提高合成计算速度。

ACO 会测量并限制每个 CPU 和每个 ME 网格在一个 tick 内执行的样板执行量。工作会在后续的 tick 中继续，而不会改变作业结果。

这使得超大型 CPU 在减少突发 MSPT 峰值的同时，仍然保持其用途。

机械优化

当样板供应器成功推送一个加工样板时，ACO 会记录一个短时的配方意图。

GTCEu 和 Mekanism 可以使用此意图，在执行其正常的配方搜索之前，测试一个小的索引候选列表。每个候选仍然会通过机械模组的原始验证。

如果 ACO 无法证明缓存的候选仍然有效，它会立即回退到原始的机械逻辑。

ACO 不会强制机械运行某个配方，也不会绕过电压、能量、洁净室、输入、输出、储罐、库存或配方条件检查。

安全性

ACO 明确不会：

• 修改配方或样板。
• 使无效的合成成功。
• 改变物品、流体或化学物质的内容。
• 替换正常的库存插入或提取。
• 更改输入总线或输出总线的过滤设置。
• 更改 AE2 网络拓扑结构。
• 增加标准 CPU 容量或协处理器数量。
• 修改 Advanced AE 多方块结构规则。
• 修改量子存储、加速器或数据缠结器。
• 默认启用原生 GTCEu 或 Mekanism 批处理。
• 用估计结果替换不明确或不支持的合成路径。

替代材料、可重复使用的工具、返回的容器、模糊输入、循环、发信器等以及其他不确定的路径将回退到 AE2 的原始求解器。

运行环境要求

• Minecraft 1.20.1
• Forge 47.4.18 或更新版本
• Java 17
• Applied Energistics 2 15.4.10 / 15.4.x

可选集成

• 高级AE（Advanced AE）
• 高级量子工程（Advanced Quantum Engineering）
• GTCEu Modern
• 通用机械（Mekanism）
• 应用机械（Applied Mekanistics）
• 扩展AE（ExtendedAE）
• AE2 超频（AE2 Overclock）
• Neo ECO AE 扩展 20.3.x
• 应用E（AppliedE）
• 应用E TPS 修复（AppliedE TPS Fix）
• 扩展AE 增强版（ExtendedAE Plus）
• EMI
• JEI
• KubeJS

只有 Applied Energistics 2 是必需的游戏性依赖。

安装

在专用服务器和每个客户端上安装相同的 ACO 1.5.0 JAR 文件。

配置文件：

config/ae2_crafting_optimizer-common.toml

服务器的游戏性行为使用服务器配置。客户端的显示行为使用客户端配置。请保持两个副本同步。

ACO 1.5.0 使用 Forge 网络协议 3，与旧版 ACO 不兼容网络。

许可证

AE2 Crafting Optimizer 仅根据 GNU 宽通用公共许可证 v3.0 发布。

源代码和问题追踪器： https://github.com/syarukasu/ae2-crafting-optimizer

请在向 AE2 或集成模组开发者报告问题之前，先尝试在不安装 ACO 的情况下复现问题。与 ACO 相关的问题应连同日志、配置和复现步骤一起报告到 ACO 的代码仓库。