HELL Blackhawk Seat and Hoist

# HELL Blackhawk Seat and Hoist Fix — 試作版 0.1

添付 data(9).pak のスクリプトとPrefabを基に作成した、Blackhawk Tweaks by Awenzj向け依存パッチです。
**Workbenchでのコンパイル・ゲーム内動作は未検証です。完成済みの配信用PAKではありません。**

## 修正内容

- SOAR UH60、HH-60G、HH-60W（HH-60Gから継承）、HH-60W GAU21の一般席：左右のキャビン入口に通常の搭乗アクションを接続。左右のキャビンドアを使用可能に設定。
- SOAR UH60の中央席：元Prefabで無効だったRegisterActionsとRegisterCompartmentsを有効化。中央席側の操作範囲を拡大し、階層をまたいだ操作を許可。
- ホイスト：上限到達時に巻き上げラッチが解除されても、自動取り込みを元の2.5秒間隔で再試行。
- ホイストのハーネス利用者／バスケットのPJ：最上部かつドア付近では「Unclip into cabin」で自分だけ空席へ移動可能。地上では元の「Unclip」を使用。
- 座席移動の完了判定：同じエンティティ階層だけでなく、指定された座席に着いたことを確認。

パイロット席と射撃手席には搭乗設定の変更を加えていません。ホイスト用スクリプトの変更は、元のAwenzjホイストシステムを使う機体全体に適用されます。DAPの専用乗員席は搭乗設定変更の対象外です。

## 導入と確認

1. PCのArma Reforger Toolsと、元MODおよびその依存MODを用意します。
2. ZIPを展開し、Workbench Launcherからこのフォルダのaddon.gprojを既存プロジェクトとして開きます。
3. 元MODの依存IDは689910D4936BDF6Cです。依存MODが見つからない場合は、それぞれのプロジェクトをLauncherへ登録してください。
4. スクリプトをコンパイルします。エラーが出た場合は、そのログを確認してから先に進んでください。このパッチは元MODの既存クラス・protectedメンバーを拡張します。元MODの更新で互換性が変わる可能性があります。
5. Prefab Editorで一般席のParentContextListがHELL_CabinEntryLeft / Right、DoorInfoListが2 / 3になっていることを確認します。
6. SOARのSeat_CargoでRegisterActions / RegisterCompartmentsが有効なことを確認します。
7. 下記のテストを実施し、成功後にWorkbenchからビルド・Workshop公開してください。PS5を含む参加者へ配布する場合も、通常のWorkshop経由で導入してください。

addon.gprojのGUIDはこの試作プロジェクト用の値です。Workshop公開済みMODのIDではありません。既存のご自身の修正MODへ組み込む場合は、そのプロジェクトのID/GUIDを維持し、scriptsとPrefabsのみを取り込んで依存を追加します。

.metaには添付MOD内の参照から確認した元リソースGUIDを設定しています。もしWorkbenchがメタデータの更新を要求した場合は、GUIDがoverride_manifest.jsonと同じであることを確認してください。新しいGUIDでの重複作成では元機体を修正できません。必要な場合は元Prefabの「Override in...」から作り直し、対応する差分内容を反映してください。

元PAKを直接書き換えたり、元MODのモデル・テクスチャを再配布したりする必要はありません。

## 必須の実機テスト

| 項目 | 確認する動作 |
|---|---|
| 一般席 | 各対象機体の左右から、通常のインタラクトで搭乗・降車できること |
| 中央席 | SOAR UH60の中央席を順に埋められ、座席変更・降車も可能なこと |
| 元の乗員席 | パイロット2席・射撃手・Hoist Operatorの搭乗と操作が維持されること |
| ハーネス | 1人・複数人を最上部まで上げて自動取り込みされること |
| 一時的な満席 | 最上部で空席がなくても、空席ができた後に再度巻き上げず取り込まれること |
| 本人操作 | 最上部のUnclip into cabinで機内へ移り、中間高度では解除が許可されないこと |
| バスケット | PJと患者がいる状態で取り込み・格納・再展開・地上解除できること |
| ネットワーク | 専用サーバー＋別PCクライアントで転送・座席予約が正常なこと。PS5でも操作が表示されること |
| 複数人・満席 | 同じ席に重複転送されず、空席がないときに空中へ放出されないこと |

満席時には空席が必要です。空中にそのまま切り離す機能は追加していません。バスケットの患者本人からの任意解除も追加していません。元MODの座席移動処理自体がクライアント側で失敗する場合は、コンパイルログと専用サーバー／クライアント双方のログで追加調査が必要です。

## 調査根拠と検証範囲

- 添付PAKの779エントリを解析し、対象テキストの展開サイズを照合。
- 一般席でParentContextListが空の箇所、SOAR中央席の登録無効、通常解除の地上制限、自動取り込みが負の巻き上げ指令に依存する実装を確認。
- 4件のPrefab override GUIDと、変更するコンポーネント・座席・アクションIDを添付ファイル内の参照に照合。
- ソース構造の検査を実施。Enfusionコンパイラ・Workbench・ゲーム本体はこの作業環境にないため、コンパイルと実機動作は未検証。
- 動作不良の原因がこれらだけであることは未確定です。試作パッチでの再現試験が必要です。

元MOD: https://reforger.armaplatform.com/workshop/689910D4936BDF6C
公式override仕様: https://community.bistudio.com/wiki/Arma_Reforger:Data_Modding_Basics
公式プロジェクト例: https://github.com/BohemiaInteractive/Arma-Reforger-Samples/tree/main/SampleMod_ModdedCar

原作者: awenzj。元MODに依存する非公式パッチです。独自に記述した差分のみを収録しています。