GTA5 Police Bodyguard v1.1
==========================

概要
----

GTA5 Police Bodyguard は、GTA V PC版シングルプレイ用の ScriptHookVDotNet v3 Mod です。
F5キーでプレイヤーの近くにNPC護衛部隊を呼び出せます。

護衛は Police または Merryweather の外見で出現し、徒歩や地上車両でプレイヤーを追従し、敵対が確認できたNPCと戦います。
部隊は Green、Pink、Yellow、Orange の最大4部隊に対応しています。
各部隊は1人から4人まで設定できます。

このビルドは GTA V 1.0.3788.0 と ScriptHookVDotNet v3.7.0-nightly.153 向けです。

重要:
このModはシングルプレイ専用です。GTA Onlineでは使用しないでください。


v1.1 の変更点
--------------

- 部隊車両が破壊された場合、自動で新しい車両を生成します。
- 部隊車両が追従ワープした場合、隊員は自動で車両に乗った状態になります。
- 護衛の攻撃が敵対警察NPCに当たった場合、少し遅れて倒れる挙動になります。
- 武器変更は Squad Members 設定だけで行います。
- Police Settings と Merryweather Settings から武器設定を外しました。


必要なもの
----------

- GTA V PC版
- Script Hook V
- ScriptHookVDotNet v3.7.0-nightly.153

現在のGTA Vでは ScriptHookVDotNet v3.6.0 へ戻さないでください。
公式の v3.6.0 リリースページでも、GTA V 1.0.3258.0 以降は
nightly.89 以降を使うよう注意されています。

GTA V本体フォルダには、少なくとも次のファイルが必要です。

- dinput8.dll
- ScriptHookV.dll
- ScriptHookVDotNet.asi
- ScriptHookVDotNet3.dll


インストール
------------

1. Script Hook V を GTA V 本体フォルダに入れます。
2. ScriptHookVDotNet v3.7.0-nightly.153 を GTA V 本体フォルダに入れます。
3. GTA V 本体フォルダに scripts フォルダがない場合は作成します。
4. ZIP内の scripts フォルダを GTA V 本体フォルダへコピーします。

配置例:

Grand Theft Auto V\scripts\Gta5PoliceBodyguard.dll
Grand Theft Auto V\scripts\PoliceBodyguard.ini


操作
----

F5:
  現在選択中の護衛部隊を呼び出します。

F6:
  護衛メニューを開閉します。

F7:
  Defense / Combat モードを切り替えます。

Num 8 / Num 2:
  メニュー選択を上下に移動します。

Num 5:
  選択中の項目を決定します。

Num 6:
  サブメニューを開きます。

Num 4 / Num 0 / Escape:
  戻る、またはメニューを閉じます。


護衛モード
----------

Defense:
  プレイヤーの護衛と追従を優先します。

Combat:
  敵対が確認できたNPCの制圧を優先します。
  戦闘中は射線確保や追撃のため、プレイヤーから少し離れて行動する場合があります。


F6 メニュー
-----------

メインメニュー:

- Spawn bodyguard
- Delete bodyguard
- Change bodyguard
- Strength
- Settings

Change bodyguard:

- Police
- Merryweather

Strength:
  護衛の命中率、射撃頻度、ダメージ調整を変更します。

Settings:

- General Settings
- Police Settings
- Merryweather Settings
- Squad Members


General Settings
----------------

Blips:
  護衛のミニマップ表示を切り替えます。

Blip Mode:
  All、LeaderOnly、Team を切り替えます。

Mode:
  Defense / Combat を切り替えます。


Police Settings
---------------

Arrival:
  Police護衛の出現方法を変更します。

  Direct:
    徒歩で直接スポーンします。

  PatrolCar:
    警察車両に乗った状態でスポーンします。

Squads:
  Police部隊数を1から4で設定します。
  次回スポーンから反映されます。

Units:
  Police、SWAT、Mixed を切り替えます。

Vehicle:
  Policeの地上車両モデルを変更します。
  選択肢: NONE、POLICE、POLICE2、POLICE3、POLICE4、FBI、RIOT。


Merryweather Settings
---------------------

Vehicle:
  Merryweatherの地上車両モデルを変更します。
  選択肢: NONE、MESA3、DUBSTA、GRANGER。

Squads:
  Merryweather部隊数を1から4で設定します。
  次回スポーンから反映されます。


Squad Members
-------------

Green、Pink、Yellow、Orange の各部隊を設定できます。

Members per Squad:
  選択中の部隊人数を1から4で設定します。
  次回スポーンから反映されます。

Weapon Mode:

  Shared from Member 1:
    部隊全員が Member 1 の武器設定を使います。

  Custom per Member:
    隊員ごとに個別の武器を設定できます。

Member 1 から Member 4:
  各隊員の武器を変更します。
  Pink、Yellow、Orange では Member 1 が部隊リーダーです。
  Green はプレイヤーを基準にするため、別のGreenリーダーNPCは置かれません。


配布ZIP用の初期設定
-------------------

v1.1 の初期INIは、車両機能をすぐ試せるように次の設定にしています。

- PoliceArrivalMode=PatrolCar
- PoliceTeamCount=1
- PoliceMembersPerTeam=1
- PoliceVehicleModel=POLICE
- MerryweatherMembersPerTeam=1
- MerryweatherVehicleModel=GRANGER
- UseSharedWeapons=true
- GreenMembers=1
- PinkMembers=1
- YellowMembers=1
- OrangeMembers=1
- Member1Weapon=WEAPON_COMBATPISTOL

UseSharedWeapons=true の場合、各部隊は Member 1 の武器を共有します。


INI 設定
--------

設定ファイル:

Grand Theft Auto V\scripts\PoliceBodyguard.ini

[General]
  ブリップ表示、ブリップモード、モード切替キー。

[Follow]
  追従距離。

[Police]
  出現方法、部隊数、ユニット種別、地上車両モデル。

[Merryweather]
  部隊数、人数、地上車両モデル。

[VehicleTeleport]
  車両追従ワープ設定。

[Squads]
  部隊別人数、共有武器モード、Member1Weapon から Member16Weapon。

[Modes]
  初期モードと Combat / Defense の距離設定。


車両
----

車両スポーンが有効な場合、部隊は割り当て車両に乗った状態で出現します。
プレイヤーが車両に乗っている場合、部隊車両は距離を保ちながら追従します。

部隊車両が大きく離れた場合、道路上へ再配置されることがあります。
その再配置時、隊員は自動で割り当て車両に乗った状態になります。

部隊車両が破壊された場合、Modが新しい割り当て車両を生成し、部隊を乗車させます。


戦闘仕様
--------

- 護衛は敵対チェックを通過したNPCを攻撃します。
- 味方NPC、護衛、保護対象のミッション味方は攻撃対象にしないようにしています。
- 手配中に敵対している警察は攻撃対象になる場合があります。
- 警察系ターゲットは護衛の攻撃が当たった後、少し遅れて倒れます。
- ギャングなど警察以外のNPCは、プレイヤーや護衛を攻撃している証拠がある場合に攻撃対象になります。
- 武器を持っているだけの一般NPCは、誤射防止のため攻撃対象にしません。


ログ
----

護衛Modのデバッグログ:

Grand Theft Auto V\scripts\Gta5PoliceBodyguard.log

読み込み問題がある場合は、GTA V本体フォルダの次のログも確認してください。

Grand Theft Auto V\ScriptHookVDotNet.log


配布ZIPの中身
-------------

scripts\Gta5PoliceBodyguard.dll
scripts\PoliceBodyguard.ini
README_ENGLISH.txt
README_JAPANESE.txt
GTA5_MODS_DESCRIPTION.txt

ソースコード、プロジェクトファイル、PDBファイルは配布ZIPに含めません。


注意
----

このModは開発中のAI護衛Modです。
GTA VのミッションNPC、警察AI、車両AIは状況によって特殊な挙動をするため、すべての場面で完全に安定するとは限りません。

GTA Onlineでは使用しないでください。
