戦闘中にステート一覧やバトラーの情報を表示 (v1.0.2) - KEN_BattleStateInformation.js

シェア用テキスト：

▼戦闘中にステート一覧やバトラーの情報を表示 (v1.0.2)（KEN様作） - KEN_BattleStateInformation.js
https://plugin-mz.fungamemake.com/archives/8006
戦闘中にステート一覧やバトラーの情報を表示 (v1.0.2)

ふりがな：せんとうちゅうにすてーといちらんやばとらーのじょうほうをひょうじ (v1.0.2)

機能概要： 戦闘中にステート一覧やバトラーの情報を表示 (v1.0.2)

利用規約（ライセンス）： MITライセンス

作者：KEN

作者サイト：https://github.com/t-kendama/RPGMakerMZ/blob/master/KEN_BattleStateInformation.js

解説ページ：https://raw.githubusercontent.com/t-kendama/RPGMakerMZ/…

ダウンロードページ：https://raw.githubusercontent.com/t-kendama/RPGMakerMZ/…

ファイル名：KEN_BattleStateInformation.js

プラグインのヘルプ：

@help
 *
 * -------------------------    概要    -------------------------
 * 戦闘中に敵味方のステータス情報を表示するウィンドウ機能を提供します。
 * ステートの内容や任意のステータス情報を表示することが可能です。
 * 
 * ステート情報ウィンドウはパーティコマンドもしくは
 * アクターコマンド選択中にショートカットキーを押すことで表示できます。
 * 
 * 【表示内容】
 * 表示する内容は主に上下２つの領域に分かれています。
 * 
 * ・バトラー表示エリア（上）
 * バトラーの情報を表示します。左右キーを押すとバトラーが切り替わります。
 * 
 * 左側はバトラーの画像（アクターの場合は顔グラフィック）を表示し、
 * 右側はバトラーのステータス情報を表示します。
 * 表示する項目はカスタマイズ可能です。
 * 
 * ・ステート一覧（下）
 * バトラーに付与されているステートの一覧を表示します。
 * ※プラグインパラメータに未登録のステートは一覧に表示されません。
 * 
 * -------------------------    使い方    -------------------------
 * 本プラグインはプラグインパラメータ上で設定します。
 * 
 * 【バトラー情報エリア設定】
 * バトラー情報エリアに表示する内容を設定します。
 * 表示する項目や位置（行および列）などを設定します。
 * （設定方法は複雑なので、デフォルト値を参考にカスタマイズください）
 * 
 * 表示パラメータ補足：
 * 表示する値は評価式(スクリプト)で記述します。
 * ※不正な式の場合「error」が表示されます。
 * 記述例．
 * battler.name() … バトラーの名前
 * battler.param(数値) … 最大HPや攻撃力など通常能力値
 * battler.xparam(数値) … 命中率や回避率など追加能力値
 * battler.sparam(数値) … 狙われ率など特殊能力値
 * 
 * 特殊な表記法：
 * 以下の値を指定すると表示内容が変わります。
 * hpGauge ... HPゲージ
 * mpGauge ... MPゲージ
 * tpGauge ... TPゲージ
 * Index ... 表示する項目のインデックス（何番目のバトラーか）を描画
 *           (n/m) の形式で表示します
 * 
 * 【ステート一覧設定】
 * ステート一覧の描画に関する設定を行います。
 * ステートの説明は２行目以降に表示されます。
 * ※プラグインパラメータに未登録のステートは表示されません
 * 
 * 【プラグイン連携機能】
 * 累積ステートプラグイン（KEN_StackState.js）を導入することで
 * スタックの値をアイコン上に描画できます。
 * 
 * またステート説明文に ￥￥stack[ステートID] と記述することで、
 * 表示中のバトラーのスタック数を表記できます。
 * 
 * ！注意！
 * KEN_StackState.jsのバージョンは必ず「v1.0.4」以降を使用ください。
 * 
 * 
 * 【ステートの説明について（上級者向け）】
 * ・制御文字が使用可能です（￥V[0] など）
 * ・￥js<XXX>と表記するとjavascriptの実行結果に置き換わります。
 * また battlerを表記すると表示しているバトラーを取得できます。
 * 例．
 * ￥js<battler.atk>　:バトラーの攻撃力 
 * ￥js<battler.level> :バトラーのレベル
 * 
 * 
 * 【データベースのメモ欄設定】
 * <EnemyOffsetX: オフセット値>
 * 記述欄：敵キャラ
 * 敵画像の描画位置X座標を調整します。
 * 値が大きいほど左にずれます。
 * 
 * <EnemyOffsetY: オフセット値>
 * 記述欄：敵キャラ
 * 敵画像の描画位置X座標を調整します。
 * 値が大きいほど下にずれます。
 * 
 * @orderAfter KEN_StackState
 * 
 * @param states
 * @type struct<StateConfig>[]
 * @text ステート一覧
 * @desc ステートの説明を登録します。ステートは重複して設定しないでください。
 * @default []
 * 
 * @param displayKey
 * @type combo
 * @text ショートカットキー
 * @desc ウィンドウ表示のショートカットキーです。空欄にすると無効化します。
 * @default shift
 * @option shift
 * @option control
 * @option tab
 * 
 * @param addPartyCommand
 * @type boolean
 * @text パーティコマンドに追加
 * @desc パーティコマンドにステート情報の表示コマンドを追加します。
 * @default true
 * 
 * @param partyCommandText
 * @type string
 * @text パーティコマンド名
 * @desc パーティコマンドの名称を設定します。
 * @default ステート情報
 * 
 * @param hideDeadEnemy
 * @type boolean
 * @text 戦闘不能エネミー除外
 * @desc 戦闘不能となったエネミーの情報を非表示にします。
 * @default false
 * 
 * @param WindowConfig
 * @text ウィンドウ設定
 * @desc ステート情報ウィンドウ全体の設定です。この項目は使用しません。
 * 
 * @param windowWidth
 * @type number
 * @text ウィンドウ幅
 * @desc ウィンドウの横幅を設定します。
 * @default 800
 * @parent WindowConfig
 * 
 * @param windowX
 * @type combo
 * @text ウィンドウX座標
 * @desc ウィンドウのX座標を設定します(ウィンドウ幅: WindowWidth)
 * @default (Graphics.boxWidth - WindowWidth) / 2
 * @option (Graphics.boxWidth - WindowWidth) / 2
 * @parent WindowConfig
 * 
 * @param windowY
 * @type combo
 * @text ウィンドウY座標
 * @desc ウィンドウのY座標を設定します(ウィンドウ高さ: WindowHeight)
 * @default (Graphics.boxHeight - WindowHeight) / 2
 * @option (Graphics.boxHeight - WindowHeight) / 2
 * @parent WindowConfig
 * 
 * @param BattlerDisplayConfig
 * @text バトラー情報エリア設定
 * @desc ウィンドウ上部に表示するバトラー情報の設定です。この項目は使用しません。
 * 
 * @param battlerGraphicWidth
 * @type number
 * @text バトラー画像横幅
 * @desc バトラー画像を表示する領域の横幅です。横幅が大きいほど右側の領域が狭くなります。
 * @default 240
 * @parent BattlerDisplayConfig
 * 
 * @param battlerAreaRows
 * @type number
 * @text 行数
 * @desc バトラー情報エリアに表示する行数です。
 * @default 3
 * @min 1
 * @parent BattlerDisplayConfig
 * 
 * @param battlerAreaColumn
 * @type number
 * @text 列数
 * @desc バトラー情報エリアに表示する列数です。
 * @default 3
 * @parent BattlerDisplayConfig
 * 
 * @param battlerAreaPadding
 * @type number
 * @text 項目間サイズ
 * @desc 項目間の余白を設定します。大きいほど左右の間隔が大きくなります。
 * @default 16
 * @parent BattlerDisplayConfig
 * 
 * @param battlerAreaConfig
 * @type struct<BattlerAreaConfig>[]
 * @text 表示項目詳細
 * @desc バトラー情報エリアに表示する項目を設定します。
 * @parent BattlerDisplayConfig
 * @default ["{￥"itemText￥":￥"￥"，￥"itemTextColor￥":￥"0￥"，￥"itemValue￥":￥"battler.name()￥"，￥"aline￥":￥"left￥"，￥"row￥":￥"1￥"，￥"column￥":￥"1￥"，￥"hideEnemy￥":￥"false￥"}"，"{￥"itemText￥":￥"￥"，￥"itemTextColor￥":￥"0￥"，￥"itemValue￥":￥"hpGauge￥"，￥"aline￥":￥"center￥"，￥"row￥":￥"1￥"，￥"column￥":￥"2￥"，￥"hideEnemy￥":￥"true￥"}"，"{￥"itemText￥":￥"￥"，￥"itemTextColor￥":￥"0￥"，￥"itemValue￥":￥"Index￥"，￥"aline￥":￥"right￥"，￥"row￥":￥"1￥"，￥"column￥":￥"3￥"，￥"hideEnemy￥":￥"false￥"}"，"{￥"itemText￥":￥"攻撃力￥"，￥"itemTextColor￥":￥"16￥"，￥"itemValue￥":￥"battler.param(2)￥"，￥"aline￥":￥"right￥"，￥"row￥":￥"2￥"，￥"column￥":￥"1￥"}"，"{￥"itemText￥":￥"防御力￥"，￥"itemTextColor￥":￥"16￥"，￥"itemValue￥":￥"battler.param(3)￥"，￥"aline￥":￥"right￥"，￥"row￥":￥"2￥"，￥"column￥":￥"2￥"}"，"{￥"itemText￥":￥"魔法力￥"，￥"itemTextColor￥":￥"16￥"，￥"itemValue￥":￥"battler.param(4)￥"，￥"aline￥":￥"right￥"，￥"row￥":￥"2￥"，￥"column￥":￥"3￥"}"，"{￥"itemText￥":￥"魔法防御￥"，￥"itemTextColor￥":￥"16￥"，￥"itemValue￥":￥"battler.param(5)￥"，￥"aline￥":￥"right￥"，￥"row￥":￥"3￥"，￥"column￥":￥"1￥"}"，"{￥"itemText￥":￥"敏捷性￥"，￥"itemTextColor￥":￥"16￥"，￥"itemValue￥":￥"battler.param(6)￥"，￥"aline￥":￥"right￥"，￥"row￥":￥"3￥"，￥"column￥":￥"2￥"}"，"{￥"itemText￥":￥"運￥"，￥"itemTextColor￥":￥"16￥"，￥"itemValue￥":￥"battler.param(7)￥"，￥"aline￥":￥"right￥"，￥"row￥":￥"3￥"，￥"column￥":￥"3￥"}"]
 * 
 * @param StateDisplayConfig
 * @text ステート一覧設定
 * @desc ステートの一覧の表示設定です。この項目は使用しません。
 * 
 * @param showTurn
 * @type boolean
 * @text ターン数を表示
 * @desc ステートの残りターン数を描画します
 * @default true
 * @parent StateDisplayConfig
 * 
 * @param turnText
 * @type string
 * @text ターン数描画文字列
 * @desc ステートの残りターン数の表記（%1: ターン数）
 * @default 残り%1ターン
 * @parent StateDisplayConfig
 * 
 * @param stateNothingText
 * @type string
 * @text ステート無しのテキスト
 * @desc ステートが付与されていない場合の表示テキストです。
 * @default ステートはありません
 * @parent StateDisplayConfig
 * 
 * @param maxRows
 * @type number
 * @text ステート表示数
 * @desc 表示するステートの個数を設定します。
 * @default 5
 * @min 1
 * @parent StateDisplayConfig
 * 
 * @param stateLineNum
 * @type number
 * @text ステート説明文行数
 * @desc ステート説明文の行数を設定します。
 * @default 1
 * @min 1
 * @parent StateDisplayConfig
 * 
 * @param StackStateConfig
 * @type string
 * @text 累積ステート設定（要: KEN_StackState.js）
 * @desc 累積ステートの表示設定です。この項目は使用しません。
 * @parent StateDisplayConfig
 * 
 * @param showStackState
 * @type boolean
 * @text 累積ステート表示
 * @desc 累積ステートをステートアイコンに表示します。KEN_StackState.jsの導入が必要です。
 * @default false
 * @parent StackStateConfig
 * 
 * @param stackFontSize
 * @text フォントサイズ
 * @desc スタック数のフォントサイズ
 * @type number
 * @default 20
 * @parent StackStateConfig
 * 
 * @param stackAxisX
 * @text スタックX座標
 * @desc 表示するスタック数のX座標
 * @type number
 * @default 4
 * @parent StackStateConfig
 * 
 * @param stackAxisY
 * @text スタックY座標
 * @desc 表示するスタック数のY座標
 * @type number
 * @default 4
 * @parent StackStateConfig
 *