ark-unpacker

Ark-Unpacker は『アークナイツ』のゲームリソースを一括展開するためのツールで、Python で書かれており、BSD-3 オープンソースライセンスを採用しています。現在のバージョンは v5.2 で、作者はより機能が充実した ArkStudio プラットフォームへの段階的な移行を予告しており、本プロジェクトは移行完了後に更新を終了します。 主な機能 1. 『アークナイツ』の Unity AssetBundle（AB）ファイルに含まれるゲームリソースオブジェクトの一括展開。ゲームバージョン v2.5.04 以降の特殊な解凍アルゴリズムに対応。展開時に基地ちびキャラ、動的立ち絵、戦闘ちびキャラの Spine モデルファイルを区別可能。元の AB ファイル名ごとにディレクトリを分けて出力結果を保存できます。 2. RGB チャンネル画像と Alpha チャンネル画像の一括統合。 3. FlatBuffers データファイルの一括デコード。 4. 対話型コマンドラインインターフェースと直接コマンドライン呼び出しの両方の操作方法を提供。 対応するエクスポートリソースタイプ：Sprite（PNG）、Texture2D（PNG）、AudioClip（WAV）、TextAsset（テキストまたはバイトデータ）、Mesh（OBJ）、TypeTree（JSON）。 使用手順 使用前にゲームリソースファイルを取得する必要があります。Android 版リソースはインストールパッケージ内の assets/AB/Android ディレクトリとホットアップデートで生成される Bundles ディレクトリの 2 つに分かれており、統合して上書きすると完全なリソースになります。PC 版は Hypergryph ランチャーのインストールディレクトリにある Arknights_Data から StreamingAssets/AB/Windows の初期リソースと PersistentData/Bundles のホットアップデートリソースを取得します。リポジトリにはリソース検索ガイドドキュメントが用意されており、特定のリソースがどの AB ファイルにあるかを特定するのに役立ちます。 プログラムは Windows 64 ビット実行ファイルを提供しており、Releases ページからダウンロードできます。展開対象フォルダとプログラムを同じディレクトリに置いて実行すると、対話型インターフェースに入ります。 動作モード - ワンクリック実行：プログラムがあるディレクトリ内のファイルを展開して画像統合を実行し、Unpacked_xxxx と Combined_xxxx フォルダに出力します。ドキュメントでは、ゲームリソースディレクトリ全体の展開には時間がかかりすぎ、リソースを消費しすぎるため、これを使用しないよう注意を促しています。 - カスタムリソース展開：入出力パスを指定し、リソースタイプを選択します。 - カスタム画像統合：指定パス内の RGB 画像と Alpha 画像を統合します。 - カスタムテキストデータデコード：指定ディレクトリ内のデータファイルをデコードします。 - カスタム Spine モデル出力：Spine アニメーションちびキャラモデルを出力します。 - カスタム Criware USM 音声・動画抽出：USM ファイルから音声と動画を抽出します。 - ArkModels と ArkVoice 抽出仕分けツール：カスタム機能。専用ドキュメントを参照する必要があります。 コマンドラインの使い方 プログラムは引数による直接呼び出しに対応しています。モード引数 -m は ab（展開）、cb（画像統合）、fb（FlatBuffers デコード）、sp（Spine 解析）、cu（USM 解析）を選択できます。入出力は -i と -o で指定します。-d で既存の出力ディレクトリを先に削除できます。展開モードでは --image、--text、--audio、--spine、--mesh、--typetree でエクスポートタイプを選択でき、-g で元の AB ファイル名ごとにグループ化します。USM モードでは --no-video、--no-audio で該当処理をスキップできます。-l でログレベルを設定します（0 から 4）。mode 引数なしで実行すると対話型インターフェースに入ります。 注意事項 ワンクリック実行モードはプログラムディレクトリ直下にある AB ファイルを展開せず、サブフォルダ内のファイルのみを処理します。プログラムは CPU コア数に応じてマルチプロセス戦略を自動調整し、CPU とハードディスク性能に一定の要件があります。低スペックのデバイスでは動作が遅くなる可能性があります。実行後、作業ディレクトリに設定ファイル ArkUnpackerConfig.json とログファイル ArkUnpackerLogs.log が生成されます。リポジトリには設定ファイルガイド、必須知識（RGB チャンネル画像と A チャンネル画像、Spine アニメーションちびキャラ）、開発者ガイドなどのドキュメントも用意されています。