Great People Die Twice
Version 2
日本語紹介名: 偉人は二度死ぬ

【MODの概要】
Steam版『Sid Meier's Civilization V: Brave New World』用のシングルプレイヤーMODです。
人間プレイヤーの対応済み偉人が指定能力を使って消費されたとき、同じ種類の偉人が
一定確率で復活します。復活するたびに、同じ系譜の次回復活確率は低下します。
偉人を消費した際、抽選に成功すると偉人が生き残り、再び能力を使用できます。
生存に成功するたび、次回の生存確率は低下します。大預言者は対象外です。

1回目の対象能力使用: 1/2
2回目の対象能力使用: 1/3
3回目の対象能力使用: 1/4
4回目の対象能力使用: 1/5
以後も「1 /（対象能力使用回数＋1）」です。

抽選に失敗すると、その偉人の系譜は完全に終了します。
別に誕生した同種偉人は新しい系譜として1/2から始まります。

【重要：対応範囲】
標準BNWのLuaイベントでは、すべての偉人能力を同じ精度で区別できません。
誤って対象外能力や削除を復活条件にしないことを優先し、初版は次の5種類だけに対応します。

対応済み:
・大科学者（UNIT_SCIENTIST）: 科学力獲得
・大技術者（UNIT_ENGINEER）: 都市の生産加速
・大商人（UNIT_MERCHANT）: 都市国家での通商任務
・大将軍（UNIT_GREAT_GENERAL）: 城塞建設
・大提督（UNIT_GREAT_ADMIRAL）: 艦隊修復

初版では対象外:
・大著述家（UNIT_WRITER）: 政治論文と傑作文学を安全に区別できないため
・大芸術家（UNIT_ARTIST）: 黄金時代と傑作芸術を安全に区別できないため
・大音楽家（UNIT_MUSICIAN）: コンサートツアーと傑作音楽を安全に区別できないため
・大預言者（UNIT_PROPHET）: 企画仕様により全面的に対象外
・ヴェニスの商人など、標準8種類とは別IDの文明固有偉人
・別MODが追加した独自偉人と独自能力

【対象能力と除外能力】
大科学者:
・科学力獲得は対象
・アカデミー建設は対象外

大技術者:
・都市の生産加速は対象
・製造所建設は対象外

大商人:
・都市国家での通商任務は対象
・税関建設は対象外

大将軍:
・城塞が実際に完成した消費だけが対象

大提督:
・標準大提督の艦隊修復による消費が対象

戦死、捕獲、削除、贈与、所有権変更、別MODによる削除、セーブ読み込みだけでは復活しません。
AIプレイヤーの偉人には適用しません。

【能力判定方法】
標準BNWのGameEvents.GreatPersonExpendedは、プレイヤーIDと偉人のユニット種類を通知しますが、
個体のユニットID、座標、実行能力の種類は通知しません。

本MODでは次の標準イベントを組み合わせます。
・GameEvents.GreatPersonExpended: 人間プレイヤーの偉人消費開始を検知
・GameEvents.UnitPrekill: 消費直前のユニットID、種類、座標を取得

大科学者、大技術者、大商人は、消費座標にそれぞれアカデミー、製造所、税関が完成している場合を
対象外能力として除外します。大将軍は消費座標に城塞が完成していることを必須条件とします。
大提督は標準大提督の消費能力を艦隊修復として扱います。

このイベント順と改善完成状態は実機での重点確認事項です。改善状態を安全に取得できない場合は
復活させない側へ倒す設計ですが、各OSとゲーム版で対象能力・除外能力を必ず確認してください。

【系譜管理】
各偉人の系譜をプレイヤーIDとMOD独自の連番で識別します。
通常発生した偉人は、最初の対象能力使用時に新しい系譜として登録されます。

保存する主な情報:
・プレイヤーID
・系譜ID
・現在のユニットID
・偉人のユニット種類
・対象能力使用回数
・処理済みイベントキー

復活するとゲーム内ユニットIDは変わりますが、新しいユニットIDへ同じ系譜IDと使用回数を
引き継ぎます。同じ種類の偉人を複数所有していても、それぞれ別系譜として管理します。

抽選失敗、配置不能、生成失敗では系譜を終了します。
同じイベントの重複通知、Lua再読み込み、セーブロードでは再抽選しません。

【抽選方法】
Civ5標準のゲーム内乱数を使用します。
  Game.Rand(使用回数 + 1, "Great People Die Twice")

結果が0の場合だけ復活成功です。Lua標準のmath.randomは使用しません。
セーブ直前から再試行した場合に結果が変化するかは、ゲーム側の乱数状態に依存するため
実機確認事項です。

【復活場所】
陸上偉人:
1. 能力を使用した元のタイル
2. 元のタイルから半径2以内の安全な陸地
3. 最寄りの自都市とその周辺
4. 首都とその周辺

大提督:
1. 艦隊修復を使用した海上タイル
2. 元のタイルから半径2以内の安全な海上
3. 最寄りの沿岸都市に近い海上

海、山岳、通行不能、外国ユニット、別の民間ユニットがいるマスは避けます。
消費前イベント中は元の偉人がまだ存在するため、通常は隣接する安全なタイルへ復活します。
有効な配置場所がなければゲームを停止せず、復活を中止してLua.logへ記録します。

【人物名】
Version 2では、元の人物名を新ユニットへ明示的に設定しません。
Civ5が新しく生成した同種偉人へ別の人物名を割り当てる可能性があります。
正しい種類、所有者、系譜、確率の継承を人物名より優先しています。

【ゲーム本来の処理】
本MODは偉人能力の効果、偉人ポイント、誕生コスト、文明特性、社会制度、遺産、
ユニット能力値を変更しません。対象能力の本来の効果が完了する際に復活抽選を追加するだけです。
復活した偉人には独自昇進や能力値変更を加えません。

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

【対応OS】
Windows / macOS / Linux

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

【フォルダ構成】
great-people-die-twice
├─ great-people-die-twice.modinfo
├─ greatpeopledietwice.lua
└─ README.txt

【導入方法】
1. Civilization Vを終了します。
2. great-people-die-twiceフォルダを、フォルダごとMODSフォルダへコピーします。
3. 上記3ファイルがgreat-people-die-twice直下にあることを確認します。
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ではcompatdata/8930配下のWindows互換環境を使用する場合があります。

【有効化方法】
1. Civ Vを起動し、メインメニューの「MOD」へ進みます。
2. 「Great People Die Twice」にチェックを入れます。
3. 「次へ」からMOD用シングルプレイヤー設定画面へ進みます。
4. 新規ゲームを開始します。

必ずMODSメニューを経由してください。通常のシングルプレイヤーメニューへ戻って開始しないでください。

【Lua.log】
config.iniで通常は次を有効にします。
  LoggingEnabled = 1
  EnableLuaDebugLibrary = 1

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

検索文字列:
  [Great People Die Twice]

主なログ:
  Great People Die Twice loaded
  GPDT lineage registered
  GPDT ability detected
  GPDT revival roll
  GPDT revival succeeded
  GPDT revival failed
  GPDT removal ignored
  GPDT prophet ignored
  GPDT duplicate event ignored

【セーブデータへの影響】
Modding.OpenSaveData()へ系譜、使用回数、現在ユニットID、処理済み情報を保存します。
旧名称版のセーブデータとの互換性を維持するため、内部保存キーの接頭辞GPND_は変更していません。
これはゲーム内表示やLua.logの略称ではなく、保存済み系譜を読み継ぐための内部識別子です。
このMODを有効にして開始したセーブは、原則として同じMODを有効にしてロードしてください。
MODを無効化しても、すでに復活した偉人はセーブデータから自動削除されません。

【通知】
Version 2では画面通知を実装していません。
能力判定、重複防止、系譜保存、配置処理の安定性を優先し、Lua.logで結果を確認します。

【既知の制限】
・対応偉人は大科学者、大技術者、大商人、大将軍、大提督の5種類です。
・大著述家、大芸術家、大音楽家は対象能力と傑作作成を安全に区別できず、未対応です。
・大預言者は仕様により対象外です。
・文明固有偉人と別MODの独自偉人は対象外です。
・人物名が復活前後で変わる可能性があります。
・GreatPersonExpendedとUnitPrekillの発火順、改善完成状態、大提督の艦隊修復判定は
  実機検証が必要です。
・すべてのシナリオ、他MOD、ゲーム版、OS環境での動作を保証するものではありません。

【ほかのMODとの同時利用】
Civ V本体データを上書きせず、独立したInGameUIAddinとして動作します。
次のMODとはUUID、Lua、保存キー、ログ接頭辞を分離しています。
・Five Settlers at Dawn
・Bonus Worker on City Founding
・Sengoku Lost Infantry
・Barbarian Camp Rescue

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

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

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