ゲージ付きのオリジナルパラメータを追加できるプラグイン - HTN_GaugeParam.js

シェア用テキスト：

▼ゲージ付きのオリジナルパラメータを追加できるプラグイン（ハトネコエ様作） - HTN_GaugeParam.js
https://plugin-mz.fungamemake.com/archives/8942
アクター（プレイヤーキャラ）に、HP/MP/TPに並ぶ、もう１つのオリジナルパラメータを追加できるプラグインです。 独自パラメータのゲージ（バー）は戦闘画面・メニュー画面・ステータス画面に表示することが可能です。ゲージが満タンになるか０になるかのときにコモンイベントを呼び出せるので、 このオリジナルのパラメータが満タンになったらイベント発生→ステート（状態異常）の付与をするなど、 戦闘に彩りを添えることができます。詳しい使い方や、最新版のダウンロードは「解説ページ」のURLからお願いします。

ふりがな：げーじつきの おりじなる ぱらめーたを ついかできる ぷらぐいん

機能概要： アクター（プレイヤーキャラ）に、HP/MP/TPに並ぶ、もう１つのオリジナルパラメータを追加できるプラグインです。 独自パラメータのゲージ（バー）は戦闘画面・メニュー画面・ステータス画面に表示することが可能です。ゲージが満タンになるか０になるかのときにコモンイベントを呼び出せるので、 このオリジナルのパラメータが満タンになったらイベント発生→ステート（状態異常）の付与をするなど、 戦闘に彩りを添えることができます。詳しい使い方や、最新版のダウンロードは「解説ページ」のURLからお願いします。

利用規約（ライセンス）：
・詳細はダウンロードページ・プラグイン内を確認

作者：ハトネコエ

作者サイト：https://x.com/nekonenene

解説ページ：https://github.com/nekonenene/RPG-Maker-MZ-plugins/tree…

ファイル名：HTN_GaugeParam.js

プラグインのヘルプ：

/*:ja
 * @target MZ
 * @plugindesc アクターにゲージ付きの独自パラメータを追加 (v1.0.0)
 * @author ハトネコエ - https://hato-neko.x0.com
 * @url https://github.com/nekonenene/RPG-Maker-MZ-plugins/tree/main/my_plugins/HTN_GaugeParam
 *
 * @param MaxValue
 * @text 最大値
 * @desc 独自パラメータの最大値
 * @default 100
 * @type number
 * @min 1
 *
 * @param InitialValue
 * @text 初期値
 * @desc ゲーム開始時に各アクターへ設定されるパラメータの初期値
 * @default 0
 * @type number
 * @min 0
 *
 * @param ResetOnRecoverAll
 * @text 全回復時に初期値にリセット
 * @desc 全回復（宿屋・イベントコマンドなど）が発生したとき、パラメータ値を初期値に戻す
 * @default true
 * @type boolean
 *
 * @param ParameterName
 * @text パラメータ名
 * @desc 戦闘中のメッセージで使用される独自パラメータの名称
 * @default EP
 * @type string
 *
 * @param GaugeLabel
 * @text ゲージラベル
 * @desc ゲージ内に表示する短いラベル文字
 * @default EP
 * @type string
 *
 * @param IncreaseMessage
 * @text 増加メッセージ
 * @desc パラメータが増加したときに表示するメッセージ。空欄にすると非表示
 * @default %1の%2が %3 増えた！
 * @type string
 *
 * @param DecreaseMessage
 * @text 減少メッセージ
 * @desc パラメータが減少したときに表示するメッセージ。空欄にすると非表示
 * @default %1の%2が %3 減った！
 * @type string
 *
 * @param RecoverySoundTrigger
 * @text 戦闘中の回復音
 * @desc 戦闘中に回復音を鳴らす条件
 * @default increase
 * @type select
 * @option パラメータ増加時
 * @value increase
 * @option パラメータ減少時
 * @value decrease
 * @option 鳴らさない
 * @value none
 *
 * @param MinCommonEvent
 * @text 最小値でのコモンイベント
 * @desc 値が0に達したときに呼び出すコモンイベントID（0で無効）
 * @default 0
 * @type common_event
 *
 * @param MaxCommonEvent
 * @text 最大値でのコモンイベント
 * @desc 値が最大値に達したときに呼び出すコモンイベントID（0で無効）
 * @default 0
 * @type common_event
 *
 * @param CommonEventActorVariableId
 * @text 発動アクター格納変数
 * @desc コモンイベントが発動したとき、発動のきっかけとなったアクターIDをこの変数に格納する（0で無効）
 * @default 0
 * @type variable
 *
 * @param ShowGaugeInStatus
 * @text ステータス画面に表示
 * @desc ステータス画面にゲージを表示する
 * @default true
 * @type boolean
 *
 * @param PriorityOverTP
 * @text ステータス画面でTPより優先
 * @desc 「ステータス画面にゲージを表示」がオンで、TP表示もオンのとき、TPゲージでなくこのゲージを表示する
 * @default true
 * @type boolean
 *
 * @param ShowGaugeInBattle
 * @text 戦闘画面に表示
 * @desc 戦闘画面のバトルステータスにゲージを表示する。HP/MP/TPの後に4本目として表示される
 * @default true
 * @type boolean
 *
 * @param GaugeColor1
 * @text ゲージ左端カラー
 * @desc ゲージのグラデーション左端の色（HTMLカラーコード）
 * @default #ff80b0
 * @type string
 *
 * @param GaugeColor2
 * @text ゲージ右端カラー
 * @desc ゲージのグラデーション右端の色（HTMLカラーコード）
 * @default #ff0060
 * @type string
 *
 * @command ChangeValue
 * @text 値を変化させる
 * @desc アクターのパラメータ値を指定した量だけ変化させます（正の数で増加、負の数で減少）
 *
 * @arg actorId
 * @text アクターID
 * @desc 対象のアクターID（ゲーム変数を参照する場合は「テキスト」から v[1] のように入力）
 * @default 1
 * @type actor
 *
 * @arg amount
 * @text 変化量
 * @desc 変化量（正の数で増加、負の数で減少）
 * @default 0
 * @type number
 * @min -9999
 * @max 9999
 *
 * @command SetValue
 * @text 値を設定する
 * @desc アクターのパラメータ値を指定した値に設定します
 *
 * @arg actorId
 * @text アクターID
 * @desc 対象のアクターID（ゲーム変数を参照する場合は「テキスト」から v[1] のように入力）
 * @default 1
 * @type actor
 *
 * @arg value
 * @text 設定値
 * @desc 設定するパラメータ値
 * @default 0
 * @type number
 * @min 0
 * @max 9999
 *
 * @command GetValue
 * @text 値を取得する
 * @desc アクターのパラメータ値をゲーム変数に格納します
 *
 * @arg actorId
 * @text アクターID
 * @desc 対象のアクターID（ゲーム変数を参照する場合は「テキスト」から v[1] のように入力）
 * @default 1
 * @type actor
 *
 * @arg variableId
 * @text 変数ID
 * @desc パラメータ値を格納するゲーム変数のID
 * @default 1
 * @type variable
 *
 * @command InitValue
 * @text 値を初期値に戻す
 * @desc アクターのパラメータ値を初期値に戻します
 *
 * @arg actorId
 * @text アクターID
 * @desc 対象のアクターID（ゲーム変数を参照する場合は「テキスト」から v[1] のように入力）
 * @default 1
 * @type actor
 *
 * @help
 * アクターにゲージ付きの独自パラメータを追加します。
 * 値は０〜設定した最大値の範囲で変動します。
 *
 * ■ スキル・アイテムのメモ欄タグ
 * スキルやアイテムの「メモ」欄に、対象のパラメータ値を変化させる量を記述します。
 * Increase が「増加」、Decrease が「減少」の意味です。
 *     対象の値を増やします
 *     対象の値を減らします
 *
 * ■ ステートのメモ欄タグ（毒などのように毎ターン効果を適用）
 * ステートの「メモ」欄に記述すると、そのステートを持つアクターのターン終了時に変動します。
 *     毎ターン値を増やします
 *     毎ターン値を減らします
 *
 * 数式内で使用できる変数：
 *   a = 行動の主体（スキル・アイテムの使用者、ステートの持ち主）
 *   b = 対象
 *   v = ゲーム変数（例えば v[1] でゲーム変数ID 0001 の値）
 *
 * 記述例：
 *   
 *   
 *   
 *   
 *
 * ■ 境界値トリガー
 * 値が最大値に遷移した瞬間に MaxCommonEvent のコモンイベントが呼び出されます。
 * 値が0に遷移した瞬間に MinCommonEvent のコモンイベントが呼び出されます。
 * いずれも、すでに境界値の状態からさらに変化しても再発動しません。
 *
 * ■ 他プラグインからの利用
 * このプラグインを先に読み込んでいるとき、
 * グローバルクラス HTN_GaugeParam を通じてパラメータの値にアクセスできます：
 *   HTN_GaugeParam.getValue(actor)           値の取得
 *   HTN_GaugeParam.initValue(actor)          初期値に戻す
 *   HTN_GaugeParam.setValue(actor, value)    第２引数の値に設定
 *   HTN_GaugeParam.changeValue(actor, delta) 第２引数の値で増減
 */