Sengoku Lost Infantry
Version 1
日本語説明: 織田信長＋歩兵1体MOD

【MODの概要】
Steam版『Sid Meier's Civilization V: Brave New World』用のシングルプレイヤーMODです。
人間プレイヤーが日本文明（織田信長）を選んで新規ゲームを開始すると、
通常の初期ユニットを残したまま、ゲーム既存の歩兵（UNIT_INFANTRY）を1体だけ追加します。

古代世界へ現代の歩兵部隊が迷い込んだ、強力ですが補充不能なプレイを楽しむためのMODです。
AIが操作する日本文明や、日本以外の文明には適用されません。

【ゲームバランス上の仕様】
・追加される歩兵は1ゲームにつき対象プレイヤーへ1体だけです。
・歩兵を生産する技術は解禁しません。
・戦略資源、ゴールド、文化、科学力は追加しません。
・独自の昇進や特殊能力は付けません。
・日本文明が本来持つ開拓者や戦士などは削除・変更しません。
・追加歩兵が戦死しても再出現しません。
・特別な補充、再配置、アップグレード機能はありません。

【対象ゲーム】
・Sid Meier's Civilization V Steam版
・拡張パック Brave New Worldが必要
・シングルプレイヤー用
・マルチプレイヤーの動作は保証しません

【対応OS】
Windows / macOS / Linux

同一のMODフォルダを各OSで使用できます。OS別の差し替えファイルはありません。
Linuxでの大文字・小文字の違いに備え、実行に関係するフォルダ名、.modinfo名、
Lua名、.modinfo内部のLua参照名を小文字で完全一致させています。
README.txtだけは指定された配布名を使用しており、Luaから参照されない説明書です。

【フォルダ構成】
sengoku-lost-infantry
├─ sengoku-lost-infantry.modinfo
├─ sengokulostinfantry.lua
└─ README.txt

【導入方法】
1. Civilization Vを終了します。
2. sengoku-lost-infantryフォルダを、フォルダごとCiv VのMODSフォルダへコピーします。
3. フォルダが二重にならず、上記3ファイルがsengoku-lost-infantry直下にあることを確認します。
4. ファイル名を変更せず、そのまま使用してください。

Windowsの標準的な格納先:
C:\Users\ユーザー名\Documents\My Games\Sid Meier's Civilization 5\MODS

OneDriveでDocumentsを同期している環境では、次の場合があります:
C:\Users\ユーザー名\OneDrive\Documents\My Games\Sid Meier's Civilization 5\MODS

macOSの代表的な格納先:
~/Documents/Aspyr/Sid Meier's Civilization 5/MODS

Linuxの代表的な格納先:
~/.local/share/Aspyr/Sid Meier's Civilization 5/MODS

Steam Play / Protonでは、Steamライブラリ内のcompatdata/8930配下にある
Windows互換環境のMODSフォルダを使用する場合があります。
実際に存在するCiv Vユーザーデータ内のMODSフォルダを確認してください。

【有効化方法】
1. Civ Vを起動し、メインメニューの「MOD」へ進みます。
2. 「Sengoku Lost Infantry」にチェックを入れます。
3. 「次へ」からMOD用シングルプレイヤー設定画面へ進みます。
4. 日本文明・織田信長を選び、新規ゲームを開始します。

MODを有効にした後、通常の「シングルプレイヤー」メニューへ戻って開始しないでください。
必ずMODSメニューを経由して新規ゲームを開始してください。

【歩兵の出現位置】
次の順で基準位置を決めます。
1. 日本文明の初期開拓者
2. 開拓者を取得できない場合は、ほかの初期ユニット
3. 初期ユニットも取得できない場合は、プレイヤーの開始地点

基準タイルから半径8までを近い順に探します。
初期開拓者のタイルに友軍民間ユニットだけがいる場合は、Civ V標準の
「軍事ユニット1体＋民間ユニット1体」のスタックを利用して歩兵を配置します。
戦闘ユニット、外国ユニット、海洋、山岳、通行不能地形がある場合は別の候補を探します。

【一度だけ実行する仕組み】
新規ゲームの最初のターンだけ処理します。
Events.SequenceGameInitCompleteを使用し、初期ユニットの準備が間に合わない場合に備えて、
最初のターン中だけGameEvents.PlayerDoTurnでも予備処理を行います。
最初のターン終了後は予備イベントを解除します。

プレイヤーごとの付与済み状態をModding.OpenSaveData()へ保存します。
初期化イベントの重複、画面再読み込み、セーブデータの再開があっても再付与しません。
歩兵が戦死した場合も、保存済みの付与状態は変わらないため再出現しません。

【Lua.logの確認】
Windowsでは通常、Civ Vユーザーデータ内のconfig.iniで次を設定し、ゲームを再起動します。
  LoggingEnabled = 1
  EnableLuaDebugLibrary = 1

ログの代表的な場所:
Documents\My Games\Sid Meier's Civilization 5\Logs\Lua.log

Lua.log内で次の文字列を検索してください。
  [Sengoku Lost Infantry]

主なログ:
  Sengoku Lost Infantry loaded
  Checking player: プレイヤーID
  Infantry granted to human Japan player

対象外の理由、基準位置、配置座標、生成失敗、付与済みスキップも記録します。
毎ターン継続して全プレイヤーを走査する処理はありません。

【セーブデータへの影響】
このMODはModding.OpenSaveData()へ歩兵付与済み情報を保存します。
新規ゲームでの使用を推奨します。
このMODを有効にして開始したセーブデータは、原則として同じMODを有効にしてロードしてください。
MODを無効化しても、すでに追加された歩兵はセーブデータから自動削除されません。

【アンインストール方法】
1. ゲーム内のMOD一覧で本MODのチェックを外します。
2. Civ Vを終了します。
3. MODS内のsengoku-lost-infantryフォルダを削除します。

Civ V本体のデータや日本文明の定義は変更していません。
MODを無効化して開始する新規ゲームでは通常状態へ戻ります。

【既知の制限】
・日本文明の判定にはGameInfoTypes.CIVILIZATION_JAPANを使用します。
・追加ユニットにはGameInfoTypes.UNIT_INFANTRYを直接使用します。
・UNIT_INFANTRYや日本文明、初期ユニット、開始地点を変更する他MODとは競合する可能性があります。
・半径8以内に配置候補がない場合、歩兵は追加されません。
・画面通知は初版では実装していません。歩兵付与処理の安定性とLua.logを優先しています。
・新規グラフィック、独自ユニット、独自昇進は追加しません。
・すべてのゲーム構成、シナリオ、他MODとの組み合わせ、OS環境での動作を保証するものではありません。

【ほかのMODとの同時利用】
Civ V本体のユニット定義や日本文明データを上書きせず、独立したInGameUIAddinとして動作します。
「Five Settlers at Dawn」「Bonus Worker on City Founding」とはMOD ID、Luaファイル、
保存キー、ログ接頭辞を分離しており、同時に有効化できる構成です。

【クレジット】
企画・制作者: 非月刊エーアイマガジン　ソフト開発部
配布元: エーマガパブリッシング
MOD情報上の作者表記: A-Maga Publishing / 楢葉なおよしn
contact@amaga-pub.com

【免責】
利用は自己責任です。重要なセーブデータは事前にバックアップしてください。
本MODはすべての環境での動作を保証するものではありません。
