AE2 Crafting Priority

AE2 Crafting Priority 0.2.0 (NeoForge 1.21.1)

AE2(Applied Energistics 2)の自動クラフトに、ジョブ単位の実行優先度を追加するアドオンMODです。今回のBeta版では、他MODから優先度制御と連携できる公開APIを新規に追加したほか、AdvancedAE連携時の不具合を修正しました。

今回の変更点(0.2.0): 他MOD連携用の公開APIを追加

パッケージ com.yuuhamu.ae2craftpriority.api として、他MODから優先度制御と連携できる公開APIを新規に追加しました。

• CraftPriorityApi(静的ファサード): 優先度の取得・設定、CPUの列挙、優先度変更イベントの購読などをまとめて提供します。
  • getPriority / getStoredPriority / getEffectivePriority: 保存されている優先度と、他MOD由来の補正を反映した実効優先度を分けて取得
  • setPriority(サーバースレッド専用): 優先度を直接設定
  • withPriority(int) → PriorityScope、runWithPriority / callWithPriority: クラフトジョブ投入時に一時的な優先度を適用するスコープAPI(AutoCloseable・ネスト可)
  • registerResolver(PriorityResolver, order): 保存値やAPI設定値を書き換えずに、他MOD(例: AE2PriorityRequester)が基準優先度を加算・補正できるフック
  • registerAdapter(PriorityAdapter): AdvancedAEなど、AE2純正以外のクラフトCPUクラスタ型をこのMODの優先度制御に対応させるための拡張ポイント
  • addPriorityChangeListener / removePriorityChangeListener: 優先度変更(GUI操作・API経由・ジョブ投入・ジョブ完了リセット・NBTロード等)を検知するイベント購読(PriorityChangeEvent)
  • getCpusByPriority(grid) / snapshot(grid): グリッド内CPUの優先度順一覧・読み取り専用スナップショット(CpuSnapshot)取得
  • isSupported / apiVersion() / MOD_ID 等のユーティリティ
• PriorityAdapter: markDirty / listCpus / isBusy / getName のデフォルトメソッドを追加し、サードパーティMODが独自のCPUクラスタ型をこのMODへ統合しやすくしました。
• API設計方針: (1) AE2・Minecraft固有の型を一切露出させずObject型のみで受け渡しするため、apiパッケージはForge 1.12.2〜NeoForge 1.21.1まで全ブランチでバイト同一のソースを共有可能、(2) Java 8構文のみで実装、(3)「保存された優先度」と「実効優先度」を明確に分離、(4) 副作用を伴うAPIはサーバースレッド専用でfail-closed設計、(5) 未対応環境でも例外を投げず安全に機能を無効化します。

不具合修正

• AdvancedAEのQuantum Computer(AdvCraftingCPUPart)使用時に、Mixinメソッドシグネチャの不一致によりInvalidInjectionException警告が発生していた不具合を修正しました。NBT読み書き用インジェクタ(AdvCraftingCPUMixinのae2cp$onWriteToNBT / ae2cp$onReadFromNBT)へHolderLookup.Provider引数を正しく追加し、実サーバーでの起動ログにMixin関連の警告が出ないことを確認済みです。

主な機能(継続)

• AE2純正の「優先度」画面から、クラフトジョブごとに優先度(数値が高いほど優先)を設定可能
• 設定方法は3通り: クラフト開始時 / Crafting CPU画面 / 端末の「クラフト状況」タブ
• 優先度はジョブ単位。タスク終了時に自動的に0へリセット

対応アドオンMOD

• AdvancedAE: 専用対応コードあり。Quantum Computerを含む優先度UIの動作を確認済み

既知の制限

• 実際のクラフトジョブでの優先度制御そのもの(多数ジョブが競合する状況での動作)は、引き続き検証中です(Betaチャンネル)
• 公開APIはBeta版のため、今後のマイナーバージョンで破壊的変更が入る可能性があります