- 插件名稱 / Plugin Name / プラグイン名: NNNN_SRPGSubstitute.js
- 版本 / Version / バージョン: v1.0.0
- 作者 / Author / 作者: NeNeNeNeTai
- 類型 / Type / タイプ: SRPG Enhancement Plugin / SRPG強化插件 / SRPG強化プラグイン
- 相容性 / Compatibility / 互換性: RPG Maker MZ
- 授權 / License / ライセンス: MIT License
繁體中文： 這是一個為SRPG模式添加完整替身系統支持的插件，讓原生替身狀態在戰術地圖上生效。當單位被單體攻擊時，範圍內具有替身能力的友方單位可以代替承受攻擊，並根據設定進行位置交換。
English： This plugin adds complete substitute system support for SRPG mode, making native substitute states effective on tactical maps. When a unit is targeted by single attacks, friendly units with substitute abilities within range can take the attack instead, with optional position swapping.
日本語： これはSRPGモードに完全な替身システムサポートを追加するプラグインで、ネイティブの替身ステートが戦術マップで有効になります。ユニットが単体攻撃を受ける際、範囲内の替身能力を持つ友軍ユニットが代わりに攻撃を受け、設定に応じて位置交換を行います。
- 繁體中文：自動檢測範圍內的替身者，支援多個替身者的優先級判定
- English：Automatically detects substitutes within range, supports priority determination among multiple substitutes
- 日本語：範囲内の替身者を自動検出、複数替身者の優先順位判定をサポート
- 繁體中文：替身執行後可選擇與被替身者交換位置
- English：Optional position swapping between substitute and original target after substitution
- 日本語：替身実行後に被替身者との位置交換を選択可能
- 繁體中文：支援範圍、攻擊類型、次數限制等多項設定
- English：Supports range, attack type, count limits and other settings
- 日本語：範囲、攻撃タイプ、回数制限などの複数設定をサポート
| 參數名稱 / Parameter | 說明 / Description | 預設值 / Default |
|---|---|---|
| 替身後交換位置 / Swap Position | 替身者執行替身後是否與被替身者交換位置 | true |
| 預設替身範圍 / Default Range | 替身者的預設援護範圍（格數半徑） | 2 |
| 每回合最大替身次數 / Max Substitute Per Turn | 每個替身者每回合最多可以替身的次數 | 3 |
| 預設每回合刷新 / Default Refresh | 替身次數是否每回合刷新（預設值） | true |
在狀態備註欄中使用 / Use in State Notes / ステートのメモ欄で使用：
<SUBSTITUTE_RANGE:3> <!-- 設定替身範圍為3格 -->
<SUBSTITUTE_HIT_TYPE:all> <!-- 可應對的攻擊類型 (physical/magical/certain/all) -->
<SUBSTITUTE_MAX_COUNT:5> <!-- 每回合最大替身次數 -->
<SUBSTITUTE_REFRESH:false> <!-- 是否每回合刷新次數 (true/false) -->在技能備註欄中使用 / Use in Skill Notes / スキルのメモ欄で使用：
<SUBSTITUTE_RANGE:2> <!-- 技能提供的替身範圍 -->
<SUBSTITUTE_HIT_TYPE:magical> <!-- 只能替身魔法攻擊 -->
<SUBSTITUTE_MAX_COUNT:1> <!-- 每回合1次替身 -->| 類型 / Type | 說明 / Description |
|---|---|
| physical | 只能替身物理攻擊 / Only substitutes physical attacks / 物理攻撃のみ替身 |
| magical | 只能替身魔法攻擊 / Only substitutes magical attacks / 魔法攻撃のみ替身 |
| certain | 只能替身必中攻擊 / Only substitutes certain attacks / 必中攻撃のみ替身 |
| all | 可以替身所有類型攻擊（預設） / Substitutes all attack types (default) / 全攻撃タイプを替身（デフォルト） |
繁體中文：
- 確保已安裝並啟用 SRPG_core_MZ 插件
- 將 NNNN_SRPGSubstitute.js 放置在 SRPG_core_MZ 之後
- 在插件管理器中啟用插件
- 創建具有替身能力的狀態或技能
- 為角色添加相應的狀態或技能
English：
- Ensure SRPG_core_MZ plugin is installed and enabled
- Place NNNN_SRPGSubstitute.js after SRPG_core_MZ
- Enable the plugin in Plugin Manager
- Create states or skills with substitute abilities
- Add corresponding states or skills to characters
日本語：
- SRPG_core_MZプラグインがインストールされ有効化されていることを確認
- NNNN_SRPGSubstitute.jsをSRPG_core_MZの後に配置
- プラグインマネージャーでプラグインを有効化
- 替身能力を持つステートまたはスキルを作成
- キャラクターに対応するステートまたはスキルを追加
繁體中文：
狀態：護衛
備註欄：
<SUBSTITUTE_RANGE:2>
<SUBSTITUTE_HIT_TYPE:physical>
<SUBSTITUTE_MAX_COUNT:2>
效果：可在2格範圍內替身物理攻擊，每回合最多2次
English：
State: Guardian
Notes:
<SUBSTITUTE_RANGE:2>
<SUBSTITUTE_HIT_TYPE:physical>
<SUBSTITUTE_MAX_COUNT:2>
Effect: Can substitute physical attacks within 2 tiles, max 2 times per turn
繁體中文：
技能：魔法護盾
備註欄：
<SUBSTITUTE_RANGE:3>
<SUBSTITUTE_HIT_TYPE:magical>
<SUBSTITUTE_MAX_COUNT:1>
效果：可在3格範圍內替身魔法攻擊，每回合1次
繁體中文：
- AGI最高者優先 - 敏捷度高的單位優先替身
- 距離最近者優先 - 距離目標最近的單位優先
- Y座標較小者優先 - 地圖上方的單位優先
- X座標較小者優先 - 地圖左方的單位優先
English：
- Highest AGI Priority - Units with higher agility substitute first
- Closest Distance Priority - Units closest to target substitute first
- Smaller Y Coordinate Priority - Units higher on map substitute first
- Smaller X Coordinate Priority - Units further left on map substitute first
日本語：
- AGI最高者優先 - 敏捷性の高いユニットが優先的に替身
- 距離最近者優先 - 目標に最も近いユニットが優先
- Y座標小者優先 - マップ上方のユニットが優先
- X座標小者優先 - マップ左方のユニットが優先
繁體中文：
-
替身觸發測試：
- 創建具有替身狀態的角色A
- 讓敵人對角色B進行單體攻擊
- 確認角色A在範圍內時會替身
-
位置交換測試：
- 啟用位置交換功能
- 觸發替身
- 確認替身者與被替身者交換位置
-
次數限制測試：
- 設定每回合替身次數限制
- 讓同一角色多次嘗試替身
- 確認超過次數後不再觸發
English：
-
Substitute Trigger Test：
- Create character A with substitute state
- Have enemy perform single attack on character B
- Confirm character A substitutes when in range
-
Position Swap Test：
- Enable position swap function
- Trigger substitute
- Confirm substitute and target swap positions
-
Count Limit Test：
- Set per-turn substitute count limit
- Have same character attempt multiple substitutions
- Confirm no trigger after exceeding limit
// 測試角色設置
護衛騎士: AGI 20, 替身範圍2, 物理攻擊
魔法師: AGI 15, 替身範圍3, 魔法攻擊
普通戰士: 無替身能力
// 測試敵人
弓箭手: 物理遠程攻擊
法師: 魔法遠程攻擊
刺客: 物理近戰攻擊繁體中文：
- 只有單體攻擊會觸發替身，AOE攻擊不會觸發
- 只有同類型單位才能互相替身（友方替友方，敵方替敵方）
- 需要配合SRPG Core插件使用
- 替身者必須在指定範圍內且未行動
English：
- Only single-target attacks trigger substitution, AOE attacks do not
- Only same-type units can substitute for each other (ally for ally, enemy for enemy)
- Requires SRPG Core plugin
- Substitute must be within specified range and not yet acted
日本語：
- 単体攻撃のみ替身を発動、AOE攻撃は発動しない
- 同種類ユニットのみ相互替身可能（味方は味方、敵は敵）
- SRPG Coreプラグインが必要
- 替身者は指定範囲内かつ未行動である必要
- RPG Maker MZ: 1.0.0 以上
- 必需插件 / Required Plugins: SRPG_core_MZ
- 檔案大小 / File Size: 19KB
- 行數 / Lines of Code: 505 lines
- v1.0.0: 初始版本，完整的替身系統 / Initial version with complete substitute system / 完全な替身システムの初版
MIT License - Copyright (c) 2024 NeNeNeNeTai
- GitHub: NeNeNeNeTaiPlugin
- 作者 / Author: NeNeNeNeTai