Five Settlers at Dawn
Version 3
作者: A-Maga Publishing / 楢葉なおよしn

【MOD概要】
Steam版 Sid Meier's Civilization V: Brave New World用のシングルプレイMODです。
新規ゲームの最初のターンに、人間が操作する存命中の主要文明へ追加ユニットを4体配布します。

通常文明:
・本来の開拓者1体を維持
・開拓者4体を追加
・開拓者合計5体で開始

ヴェネツィア（CIVILIZATION_VENICE）:
・本来のヴェネツィアの開拓者1体を維持
・斥候（UNIT_SCOUT）4体を追加
・その他の初期ユニットは変更しない

※ただし、海の都には開拓者ではなく四人の先遣隊が集った。

AI文明、都市国家、蛮族、無効なプレイヤー、滅亡文明には適用しません。

【対応ゲーム】
・Steam版 Sid Meier's Civilization V
・Brave New World（BNW）が必要
・シングルプレイ向け
・マルチプレイの動作は保証しません

【対応OS】
Windows / macOS / Linux

同一のMODフォルダを各OSで使用できます。OS別の差し替えファイルはありません。
Linux版での大文字・小文字の扱いに備え、フォルダ名、.modinfo名、Lua名、README名、
.modinfo内部の参照名を半角英数字の小文字へ統一しています。

【配布フォルダ構成】
five-settlers-at-dawn/
├─ five-settlers-at-dawn.modinfo
├─ fivesettlers.lua
└─ readme.txt

ZIPを利用する場合は、展開後に上記3ファイルがfive-settlers-at-dawnフォルダの
直下にあることを確認してください。

【導入方法】
1. Civilization Vを終了します。
2. five-settlers-at-dawnフォルダを、フォルダごとCiv VのMODSフォルダへコピーします。
3. フォルダやファイルの名前を変更せず、そのまま使用します。

Windowsの標準的な場所:
Documents\My Games\Sid Meier's Civilization 5\MODS

macOSの代表的な場所:
~/Documents/Aspyr/Sid Meier's Civilization 5/MODS
または
~/Library/Application Support/Sid Meier's Civilization 5/MODS

Linux Mint / Steam Play（Proton）の代表例:
steamapps/compatdata/8930/pfx/drive_c/users/steamuser/Documents/My Games/
Sid Meier's Civilization 5/MODS

Steamライブラリやユーザーデータの場所は環境により異なります。
実際に存在するCiv Vユーザーデータ内のMODSフォルダを使用してください。

【有効化方法】
1. Civ Vを起動し、メインメニューの「MOD」へ進みます。
2. 「Five Settlers at Dawn」にチェックを入れます。
3. 「次へ」からMOD用シングルプレイ設定画面へ進み、新規ゲームを開始します。
4. 通常の「シングルプレイ」メニューへ戻って開始しないでください。

【動作確認】
1. 通常文明で新規ゲームを開始し、本来の開拓者を含めて開拓者が合計5体いることを確認します。
2. ヴェネツィアで新規ゲームを開始し、開拓者1体と追加斥候4体になっていることを確認します。
3. AI文明には追加されていないことを確認します。
4. 追加ユニットが海、山岳、通行不能、都市、占有済みマスに置かれていないことを確認します。
5. 最初のターン中にセーブしてロードし、追加ユニットが再生成されないことを確認します。
6. 2ターン目以降に再生成されないことを確認します。

【実行タイミングと重複防止】
Events.SequenceGameInitCompleteで最初の処理を行い、元の開拓者をまだ取得できなかった場合に備えて、
最初のターンだけGameEvents.PlayerDoTurnでも再試行します。最初のターン終了後は予備イベントを解除します。

プレイヤー別の処理済み情報をModding.OpenSaveData()へ保存します。
SequenceGameInitCompleteとPlayerDoTurnの両方が呼ばれた場合やセーブロード後も再生成しません。
配置場所が不足して0体または一部しか生成できなかった場合も、その試行を完了済みとして保存します。

【配置方法】
本来の開拓者を中心に、半径1から最大8まで近い順で候補を探します。
陸地で、山岳・通行不能・都市ではなく、ほかのユニットが存在しないマスだけを使用します。
4か所未満しか見つからない場合は、配置可能な数だけ生成して処理を継続します。

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

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

Lua.log内で次を検索してください。
  [Five Settlers at Dawn]

Lua読み込み、対象プレイヤー、生成ユニット種別、配置座標、処理済みスキップ、
配置不足、生成失敗などを記録します。

【セーブデータへの影響】
このMODはセーブデータへ処理済み情報を保存します。
このMODを有効にして開始したセーブは、原則として同じMODを有効にしてロードしてください。
MODを無効化しても、すでに生成された開拓者や斥候はセーブデータから自動削除されません。

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

Civ V本体のファイルは変更していません。新規ゲームでは通常状態へ戻ります。

【MODが表示されない場合】
1. five-settlers-at-dawnフォルダが二重階層になっていないか確認します。
2. フォルダ名と3ファイルの名前がすべて小文字であることを確認します。
3. .modinfo内のfivesettlers.luaと実ファイル名が一致していることを確認します。
4. ゲーム終了後、Civ Vユーザーデータ内のcacheフォルダだけを退避または削除します。
5. Database.logとLua.logを確認します。

【既知の制限】
・追加ユニットはGameInfoTypes.UNIT_SETTLERまたはUNIT_SCOUTを直接使用します。
  UNITCLASS_SETTLERやUNITCLASS_SCOUTを文明固有ユニットへ置換するMODとは連携しません。
・元の基準ユニットには、最初に見つかったUNIT_SETTLERを使用します。
・開始時にUNIT_SETTLERが存在しないシナリオや特殊MODでは生成しません。
・空き陸地が不足する場合、追加数が4体未満になることがあります。
・初版の優先対象は、人間1人の通常シングルプレイです。

【他MODとの競合可能性】
Civ V本体データを上書きせず、独立したInGameUIAddinとして動作します。
初期ユニットを削除・置換・移動するMOD、開始ターンを変更するシナリオ、
UNIT_SETTLER、UNIT_SCOUT、ゲーム初期化を変更するMODとは競合する可能性があります。

【作者・クレジット】
A-Maga Publishing / 楢葉なおよしn

【免責】
利用は自己責任です。重要なセーブデータは事前にバックアップしてください。
