AE2 Crafting Optimizer

AE2 Crafting Optimizer

English

AE2 Crafting Optimizer (ACO) is a Forge 1.20.1 optimization and scalability mod for Applied Energistics 2.

ACO is designed for extremely large automation environments where crafting calculations, Pattern Provider execution, processing machines, and oversized crafting CPUs can cause severe MSPT or TPS spikes.

AE2 remains the source of truth. ACO does not change recipes, crafting validity, storage contents, network topology, or machine rules.

Main Features

• Deduplicates identical crafting calculations already in progress.
• Caches safe, calculation-invariant Pattern lookups.
• Compiles deterministic Pattern graphs for the AQE integration profile.
• Uses checked long arithmetic and promotes calculations to BigInteger only after overflow.
• Limits crafting execution work per CPU and per ME Grid tick.
• Prevents extremely large crafting CPUs from consuming an entire server tick.
• Preserves the displayed CPU capacity and co-processor count.
• Provides recipe-intent fast paths for GTCEu and Mekanism machines.
• Optimizes repeated recipe searches in Advanced AE Reaction Chambers.
• Optimizes ExtendedAE Circuit Cutters and Assembly Matrices.
• Optimizes reflection and card-count lookups used by AE2 Overclock.
• Provides diagnostics for slow crafting calculations.
• Includes a safety fix for stuck Page Up/Down scrolling in the Pattern Access Terminal.

Long Crafting Orders

ACO 1.5.0 adds a separate root-order input path for quantities larger than Integer.MAX_VALUE.

• 1 through Integer.MAX_VALUE use AE2’s original packet and menu path.
• Integer.MAX_VALUE + 1 through Long.MAX_VALUE use ACO’s checked long path.
• Exact amount entry, replan, cancel, back, and automatic start behavior are preserved.
• Invalid and overflowing values are rejected instead of wrapping into unrelated numbers.

This feature extends the order-entry boundary. It does not increase the capacity of a standard AE2 Crafting CPU.

BigInteger and AQE Integration

When both Advanced AE and Advanced Quantum Engineering are installed, ACO can enable its AQE-specific BigInteger profile.

Deterministic crafting plans that exceed signed long limits are retained as exact BigInteger parent jobs. Existing AE2 and machine APIs receive only recipe-specific execution windows that have been verified to fit within signed long limits.

ACO provides:

• Exact BigInteger crafting accounting.
• Checked add, multiply, and division operations.
• Recipe-specific execution-window limits.
• Persistent multi-job capacity accounting.
• Restart-safe job metadata and fingerprints.
• Fair execution of multiple large jobs.
• Exact inventory sidecars for supported BigInteger storage integrations.
• Bounded and versioned status synchronization.

The implementation ceiling is 10^16384 - 1.

Normal AE2 and Advanced AE CPUs are not automatically converted into BigInteger CPUs. An explicitly integrated CPU host such as AQE is required.

TPS Protection

Large co-processor counts increase Pattern push throughput, not crafting-calculation speed.

ACO measures and limits the amount of Pattern execution performed by each CPU and each ME Grid during one tick. Work continues across later ticks without changing the job result.

This allows very large CPUs to remain useful while reducing sudden MSPT spikes.

Machine Optimization

ACO records short-lived recipe intent when a Pattern Provider successfully pushes a processing Pattern.

GTCEu and Mekanism can use this intent to test a small indexed candidate list before performing their normal recipe search. Every candidate still passes the machine mod’s original validation.

If ACO cannot prove that a cached candidate remains valid, it immediately falls back to the original machine logic.

ACO does not force a machine to run a recipe and does not bypass voltage, energy, cleanroom, input, output, tank, inventory, or recipe-condition checks.

Safety

ACO intentionally does not:

• Modify recipes or Patterns.
• Make an invalid craft succeed.
• Change item, fluid, or chemical contents.
• Replace normal inventory insertion or extraction.
• Change Import Bus or Export Bus filters.
• Change AE2 network topology.
• Increase standard CPU capacity or co-processor count.
• Modify Advanced AE multiblock structure rules.
• Modify Quantum Storage, Accelerators, or Data Entanglers.
• Enable native GTCEu or Mekanism batching by default.
• Replace ambiguous or unsupported crafting routes with an estimated result.

Alternative ingredients, reusable tools, returned containers, fuzzy inputs, cycles, emitters, and other uncertain routes fall back to AE2’s original solver.

Requirements

• Minecraft 1.20.1
• Forge 47.4.18 or newer
• Java 17
• Applied Energistics 2 15.4.10 / 15.4.x

Optional Integrations

• Advanced AE
• Advanced Quantum Engineering
• GTCEu Modern
• Mekanism
• Applied Mekanistics
• ExtendedAE
• AE2 Overclock
• Neo ECO AE Extension 20.3.x
• AppliedE
• AppliedE TPS Fix
• ExtendedAE Plus
• EMI
• JEI
• KubeJS

Only Applied Energistics 2 is a required gameplay dependency.

Installation

Install the same ACO 1.5.0 JAR on the dedicated server and every client.

Configuration file:

config/ae2_crafting_optimizer-common.toml

Server gameplay behavior uses the server configuration. Client display behavior uses the client configuration. Keep both copies aligned.

ACO 1.5.0 uses Forge network protocol 3 and is not network-compatible with older ACO versions.

License

AE2 Crafting Optimizer is licensed under GNU Lesser General Public License v3.0 only.

Source and issue tracker:
https://github.com/syarukasu/ae2-crafting-optimizer

Please reproduce problems without ACO before reporting them to AE2 or integration-mod developers. ACO-specific issues should be reported to the ACO repository with logs, configuration, and reproduction steps.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

日本語

AE2 Crafting Optimizer（ACO）は、Applied Energistics 2向けのMinecraft Forge 1.20.1用軽量化・大規模環境対応MODです。

巨大な自動クラフト計算、Pattern Provider、加工機械、大容量クラフトCPUによって発生するMSPTやTPSの急激な悪化を抑えることを目的としています。

クラフト可否の最終判断は引き続きAE2が担当します。ACOはレシピ、ストレージ内容、ネットワーク構造、機械の動作条件を変更しません。

主な機能

• 同一内容で実行中のクラフト計算を一本化します。
• 安全なPattern検索結果を世代単位で再利用します。
• AQE連携時に決定的なPatternグラフをコンパイルします。
• 通常はlongで計算し、overflowした場合だけBigIntegerへ昇格します。
• CPU単位とME Grid単位で1 tickのクラフト投入処理を制限します。
• 巨大CPUがサーバーの1 tickを占有することを防ぎます。
• CPU容量や表示上のコプロセッサ数は変更しません。
• GTCEuとMekanismへレシピ意図を渡し、候補検索を短縮します。
• Advanced AE反応室の重複レシピ検索を減らします。
• ExtendedAEの回路スライサーと組立マトリックスを最適化します。
• AE2 Overclockが使用するReflectionとカード数取得を最適化します。
• 重たいクラフト計算の診断ログを提供します。
• Pattern Access TerminalでPage Up/Down入力が止まらなくなる問題への安全弁を追加します。

longクラフト注文

ACO 1.5.0では、Integer.MAX_VALUEを超えるルートクラフト注文用の追加経路を実装しています。

• 1からInteger.MAX_VALUEまではAE2本来のPacketとMenuを使用します。
• Integer.MAX_VALUE + 1からLong.MAX_VALUEまではACOの検査済みlong経路を使用します。
• 正確な数量入力、再計算、キャンセル、戻る、Auto Startの動作を維持します。
• 不正値やoverflowする値は、別の数値へ折り返さず拒否します。

これは注文入力の上限を拡張する機能です。通常のAE2クラフトCPU容量を増やす機能ではありません。

BigIntegerとAQE連携

Advanced AEとAdvanced Quantum Engineeringが両方導入されている場合、AQE専用BigIntegerプロファイルを利用できます。

signed longを超える決定的なクラフト計画は、正確なBigInteger親ジョブとして保持されます。既存のAE2や機械MODへは、レシピごとにlong範囲へ収まることを検証した実行区間だけを渡します。

主なBigInteger機能:

• 正確なBigIntegerクラフト会計
• 加算、乗算、除算のoverflow検査
• レシピごとの安全な実行区間
• 複数ジョブの永続的な容量管理
• 再起動後に検証可能なジョブ情報
• 複数巨大ジョブの公平な実行
• 対応ストレージ向けの正確な在庫Sidecar
• 上限付き・バージョン付きの状態同期

実装上限は10^16384 - 1です。

通常のAE2またはAdvanced AE CPUが、自動的にBigInteger CPUへ変化することはありません。AQEなど、ACO APIへ明示連携したCPUが必要です。

TPS保護

コプロセッサ数はクラフト計算速度ではなく、Patternの投入頻度を増加させます。

ACOは各CPUとME Gridが1 tick内で使用した処理時間を測定し、安全な範囲でPattern投入を継続します。予算を使い切った処理は後続tickへ回されますが、クラフト結果は変更されません。

これにより、非常に大きなCPU性能を維持しながら、瞬間的なMSPT上昇を抑えます。

機械最適化

Pattern Providerが加工Patternを正常に投入すると、ACOは短時間のレシピ意図を記録します。

GTCEuとMekanismは、通常の全候補検索を行う前に、出力から索引化された少数の候補を検証できます。候補は必ず各機械MOD本来のレシピ判定を通過する必要があります。

キャッシュされた候補の正当性を証明できない場合は、直ちに元の機械処理へ戻ります。

電圧、電力、クリーンルーム、入力、出力、タンク、インベントリ、レシピ条件を無視して機械を動かすことはありません。

安全性

ACOは以下を変更しません。

• レシピやPattern
• クラフトの成功条件
• アイテム、液体、化学物質の在庫
• 通常の搬入出とRollback
• Import BusとExport Busのフィルター
• AE2ネットワーク構造
• 通常CPUの容量とコプロセッサ数
• Advanced AEマルチブロックの構造条件
• Quantum Storage、Accelerator、Data Entangler
• GTCEuとMekanismの機械条件

代替素材、再利用道具、返却容器、Fuzzy入力、循環レシピ、Emitterなどを含む安全性を証明できない経路は、AE2本来の計算へ戻します。

必須環境

• Minecraft 1.20.1
• Forge 47.4.18以上
• Java 17
• Applied Energistics 2 15.4.10 / 15.4.x

任意連携

• Advanced AE
• Advanced Quantum Engineering
• GTCEu Modern
• Mekanism
• Applied Mekanistics
• ExtendedAE
• AE2 Overclock
• Neo ECO AE Extension 20.3.x
• AppliedE
• AppliedE TPS Fix
• ExtendedAE Plus
• EMI
• JEI
• KubeJS

必須のゲーム内依存MODはApplied Energistics 2のみです。

導入

サーバーとすべてのクライアントへ、同じACO 1.5.0のJARを導入してください。

設定ファイル:

config/ae2_crafting_optimizer-common.toml

ゲーム進行に関係する処理はサーバー側Config、クライアント表示処理はクライアント側Configを使用します。双方の設定を揃えてください。

ACO 1.5.0ではForge通信プロトコルが3へ更新されています。以前のACOとは接続互換性がありません。

ライセンス

AE2 Crafting OptimizerはGNU Lesser General Public License v3.0 onlyで公開されています。

ソースコード・Issue:
https://github.com/syarukasu/ae2-crafting-optimizer

ACO導入時だけ発生する問題を、再現確認せずAE2や連携MODの作者へ報告しないでください。ログ、設定、再現手順を添えてACOリポジトリへ報告してください。