Applied Enhancements

Applied Enhancements

Applied Enhancements 是一款面向应用能源2的 NeoForge 附属模组，专注于更安全地处理大型合成订单、提供可选的高性能规划、更完善的样板管理流程，以及切实提升 AE2 网络性能。

该模组不会添加方块或物品，而是增强现有的 AE2 系统，并与热门 AE2 附属模组集成。

运行环境：客户端和服务器
Minecraft 版本：1.21.1
加载器：NeoForge

功能

安全处理大数量合成

• 在受支持的 AE2 合成流程中，全程使用有符号 64 位 long 数量。
• 扩展数量输入、网络数据包、材料汇总、模拟库存、合成计划和 CPU 执行功能。
• 在溢出发生前检查加法、乘法、汇总产物、容器返还物品以及计划边界。
• 拒绝不安全的请求，避免出现负数或损坏的合成计划。
• 支持将订单上限配置为最高 Long.MAX_VALUE。

长数量支持默认启用，但每个订单的默认上限仍为 Integer.MAX_VALUE（2,147,483,647）。整合包作者可在需要处理更大订单时调高上限。

可选的 MAX_FAST 合成规划器

MAX_FAST 是一款可选的高性能规划器，适用于大型确定性合成图。

• 将重复的配方请求汇总为有界的事务操作。
• 支持精确替代输入、确定性耐久工具、多个工具池以及不变的可重复使用催化剂。
• 能够处理多层级配方：即使反复使用同一催化剂，也不会发出无界数量的原生子请求。
• 可安全回滚；若无法证明配方边界安全，则交由 AE2 处理。
• 将未经验证的原生操作限制在每个边界 8,192 个逻辑物品以内。
• 提供公开 API，供其他模组直接调用 MAX_FAST。

自动拦截并使用 MAX_FAST 默认处于关闭状态，以免与其他合成规划器集成产生冲突。启用后，也会激活手动计划的库存预留系统。

合成进度与计划信息

AE2 合成确认界面可显示：

• 排队与准备
• MAX_FAST 编译与执行
• AE2 原生计算与回退处理
• 计划构建、完成、取消与失败
• 已完成结果所使用的规划器路径

进度显示和增强材料汇总均为可选功能，可分别配置。

重复样板查找器

为受支持的样板终端添加简洁的重复产物模式。

• 查找当前终端中主要产物至少重复出现两次的已编码样板。
• 比较完整的 AEKey，但忽略产物数量。
• 将匹配的产物归为一组，并以浅蓝色槽位背景突出显示。
• 在重复结果中仍可使用终端原有的搜索框。
• 在每个匹配的样板上显示来源机器标记。
• 悬停在样板上时，显示来源机器、同名机器编号以及原机器槽位。
• 悬停在重复产物组标题上时，汇总显示所有来源机器。

支持的终端：

• AE2 样板访问终端
• AE2WTLib 无线样板访问终端
• ExtendedAE 扩展样板访问终端
• ExtendedAE 无线扩展样板访问终端

快速移动样板

• 拖动选择可见样板，或点击单个样板切换选中状态。
• 通过 AE 风格的上下文菜单剪切选中的样板。
• 粘贴到空样板槽，或粘贴到整个兼容的机器组。
• 在终端机器组标题中使用紧凑的单机器剪切和粘贴操作。
• 在服务器端验证所有来源、目标、槽位和容量条件。
• 以原子方式提交整个操作；如果失败，不会留下部分移动的结果。

复制输出模式与快速移动模式互斥，以确保终端交互行为可预测。

AE2 网络物品上下文菜单

在受支持的 AE2 存储终端中右键点击已同步的物品，即可使用常见操作：

• 提取一个物品
• 提取一组物品
• 提取指定的自定义数量
• 开始可用的 ME 自动合成
• 复制本地化物品名称
• 复制注册表 ID
• 搜索来自同一模组的物品

服务器会根据当前菜单、已同步的网络条目、连接、电力、存储以及玩家背包的可用空间，重新验证自定义提取操作。

可选的 JEI 上下文菜单集成

安装兼容版本的 JEI 后，配方列表和书签条目也可使用相同的上下文菜单工作流：

• 显示配方或用途
• 复制名称或注册表 ID
• 在 JEI 中搜索来自同一模组的物品
• 从已打开的 ME 终端搜索、提取或自动合成匹配的物品
• 在作弊模式和权限允许时，使用 JEI 自带的已同步给予物品操作

Applied Enhancements 不会绕过 JEI 或服务器权限。

存储与输入/输出性能优化

• 存储总线会在 AE2 现有的外部物品栏扫描过程中建立候选槽位索引。
• 提取前会重新验证缓存的候选槽位。
• 如果索引提取不完整，则回退到 AE2 原本的完整扫描。
• 输入总线会优先尝试刚刚枚举过的槽位，然后再使用原生回退方案。
• 输出总线会在模拟插入与实际提交插入之间复用有界的弱目标槽位提示。
• 批量移动样板时只对空目标槽位建立一次索引，并使用位集预留槽位。

所有存储和输入/输出优化都会保留验证机制与原生回退路径。

无限存储兼容性

Applied Enhancements 可通过以下方式识别无限存储：

• AE2 创造模式存储元件
• 受支持的 ExtendedAE 无限存储元件
• #appliedenhancements:infinite_storage_cells 物品标签
• 公开的 Java 标记 API

可选设置可以将识别到的无限物品数量列为 Long.MAX_VALUE，并以 9.2E 的紧凑格式显示。此选项默认关闭，因此存储元件通常会保留其原始实现报告的数量。

此标记仅用于识别本身已无限的存储，不会将有限存储变为无限来源。

默认配置

• 远距离合成支持：已启用
• 最大合成订单：2,147,483,647
• 合成进度显示：已禁用
• 增强型材料计算：已禁用
• 自动拦截 MAX_FAST：已禁用
• MAX_FAST 诊断：已禁用
• 样板缓存：已启用
• 存储总线槽位索引：已启用
• 输入/输出槽位路由：已启用
• 绕过无限存储列表上限：已禁用

需求

必需

• Minecraft 1.21.1
• Java 21
• NeoForge 21.1.220 或更高版本
• Applied Energistics 2 19.2.17 或更高版本

可选集成

• ExtendedAE 1.21-2.2.32-neoforge 或更新版本
• AE2WTLib 19.5.1 或更新版本
• JEI 19.27.0 或更新版本

面向整合包作者和开发者

Applied Enhancements 提供以下公共 API：

• MAX_FAST 规划会话与进度回调
• 均衡的样板供应器调度批次
• 无限存储元件标记
• 重复样板输出解析器
• 兼容样板终端注册
• 原子样板批量移动
• 客户端快速移动会话
• AE2 网络物品上下文菜单扩展

完整的 API 名称、生命周期要求和示例请参阅项目 README 和 API 集成指南。