成長装備機能を実装します。 - GrowthEquip.js

シェア用テキスト：

▼成長装備機能を実装します。（Basu様作） - GrowthEquip.js
https://plugin-mz.fungamemake.com/archives/7917
成長装備機能を実装します。

ふりがな：せいちょうそうびきのうをじっそうします。

機能概要： 成長装備機能を実装します。

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

作者：Basu

作者サイト：https://github.com/basuka/RPGMZ/blob/main/GrowthEquip/GrowthEquip.js

解説ページ：https://raw.githubusercontent.com/basuka/RPGMZ/main/Gro…

ダウンロードページ：https://raw.githubusercontent.com/basuka/RPGMZ/main/Gro…

ファイル名：GrowthEquip.js

プラグインのヘルプ：

* @target MZ
 * @plugindesc 成長装備機能を実装します。
 * @author Basu
 * @url https://raw.githubusercontent.com/basuka/RPGMZ/main/GrowthEquip/GrowthEquip.js
 *
 *
 * @help パラメータの設定項目
 *
 * 【パラメータ】
 *
 * ■成長武器
 * 成長武器情報の設定を行います。
 *
 * 　・武器
 * 　成長武器にする武器の設定を行います。
 *
 * 　・装備可能アクター
 * 　成長武器を装備できるアクターの設定を行います。
 * 　装備可能なアクターは複数設定することはできません(専用装備となります)
 *
 * 　・レベル情報
 * 　成長武器のレベル情報の設定を行います。
 *
 * 　　・レベル
 * 　　成長武器のレベルの設定を行います。
 * 　　設定できる範囲はレベル2～レベル99となります。
 * 　　レベル１はデータベースに設定した能力値が設定されます。
 *
 * 　　・必要経験値
 * 　　このレベルに必要な経験値の設定を行います。
 *
 * 　　・習得スキル
 * 　　レベルアップ時に習得するスキルの設定を行います。
 *
 * 　　・攻撃力
 * 　　レベルアップ時に上昇する攻撃力の設定を行います。
 *
 * 　　・防御力
 * 　　レベルアップ時に上昇する防御力の設定を行います。
 *
 * 　　・魔法力
 * 　　レベルアップ時に上昇する魔法力の設定を行います。
 *
 * 　　・魔法防御
 * 　　レベルアップ時に上昇する魔法防御の設定を行います。
 *
 * 　　・敏捷性
 * 　　レベルアップ時に上昇する敏捷性の設定を行います。
 *
 * 　　・運
 * 　　レベルアップ時に上昇する運の設定を行います。
 *
 * 　　・最大HP
 * 　　レベルアップ時に上昇する最大HPの設定を行います。
 *
 * 　　・最大MP
 * 　　レベルアップ時に上昇する最大MPの設定を行います。
 *
 *
 * ■成長防具
 * 成長防具情報の設定を行います。
 *
 * 　・防具
 * 　成長防具にする防具の設定を行います。
 *
 * 　・装備可能アクター
 * 　成長防具を装備できるアクターの設定を行います。
 * 　装備可能なアクターは複数設定することはできません(専用装備となります)
 *
 * 　・レベル情報
 * 　成長防具のレベル情報の設定を行います。
 * 　※成長武器のレベル情報を参照
 *
 *
 * ■経験値割合(%)
 * 獲得経験値から成長装備が得られる経験値の割合の設定を行います。
 * 経験値の割合は1～100(%)の範囲で設定することができます。
 *
 * 例：獲得経験値が200、経験値割合が50(%)の場合
 * 成長装備が得られる経験値は獲得経験値の50(%)で100となります
 *
 *
 * ■有効スイッチ
 * 成長装備画面を有効化するスイッチの設定を行います。
 * スイッチがONの場合、アクターのステータス画面で成長装備画面と切り替えることができます。
 * ステータス画面と成長装備画面の切り替えは決定キーで切り替えることができます。
 *
 *
 * ■成長スキル使用タイプ
 * 成長スキルの使用タイプの設定を行います。
 *
 * いつでも：成長スキルを無条件で使用することができます。
 * 成長装備着用時：成長装備を装備していない場合、スキルを使用することができなくなります。
 *
 *
 * ■レベル単位
 * 成長装備画面に表示する成長装備のレベル単位の設定を行います。
 *
 *
 * ■レベル単位(テキスト)
 * メッセージ(テキスト)に表示する成長装備のレベル単位の設定を行います。
 *
 *
 * ■レベルアップメッセージ
 * 成長装備がレベルアップ時に表示されるメッセージの設定を行います。
 *
 * %1：成長装備名(武具名)
 * %2：レベル単位(テキスト)
 * %3：成長装備のレベル
 *
 *
 * ■獲得装備経験値取得(スクリプト)
 * GrowthEquipManager.gainExp()関数から獲得装備経験値の取得を行うことができます。
 *
 *
 * ■レベルアップ情報取得(スクリプト)
 * GrowthEquipManager.increaseParam(actor)関数からレベルアップ情報の取得を行うことができます。
 * 取得できる情報は以下の情報となります。
 *
 * actorId：アクターID
 * w_levelInfos[id].name：武器名
 * w_levelInfos[id].level：武器レベルの上昇値
 * a_levelInfos[id].name：防具名
 * a_levelInfos[id].level：防具レベルの上昇値
 * atk:攻撃力の上昇値
 * def:防御力の上昇値
 * mat:魔法力の上昇値
 * mdf:魔法防御の上昇値
 * agi:敏捷性の上昇値
 * luk:運の上昇値
 * mhp:最大HPの上昇値
 * mmp:最大MPの上昇値
 *
 * ※1　w_levelInfos・a_levelInfosのidはデータベースのIDとなります。
 * ※2　レベルアップをしていない場合w_levelInfos・a_levelInfosは空となります。
 *
 * 【攻撃力の上昇値を取得する使用例】
 *
 * const increaseParam = GrowthEquipManager.increaseParam(actor);
 * const atk = increaseParam.atk;
 *
 *-----------------------------------------------------------------------------
 * README
 *-----------------------------------------------------------------------------
 * https://github.com/basuka/RPGMZ/blob/main/GrowthEquip/README.md
 *
 *-----------------------------------------------------------------------------
 * 利用規約
 *-----------------------------------------------------------------------------
 * このプラグインはMITライセンスで配布しています
 *
 *
 *-----------------------------------------------------------------------------
 * 更新履歴
 *-----------------------------------------------------------------------------
 * 2024/9/26 Ver.1.0.0　公開
 * 2024/9/27 Ver.1.0.1　必要経験値の上限を設定するよう修正
 *                      装備レベルが最大時に不要な経験値が加算されないよう修正
 * 2024/9/28 Ver.1.0.2  獲得装備経験値の小数点以下を丸めるよう修正
 * 2024/10/12 Ver.1.0.3　レベルアップ情報を取得する関数を実装
 *                     　獲得装備経験値を取得する関数を実装
 *
 *=====================================================================================================================================================
 * @param growthWeaponInfos
 * @text 成長武器
 * @type struct<growthWeapon>[]
 * @default []
 * @desc 成長武器情報を設定
 *
 * @param growthArmorInfos
 * @text 成長防具
 * @type struct<growthArmor>[]
 * @default []
 * @desc 成長武器情報を設定
 *
 * @param expRatio
 * @text 経験値割合(%)
 * @type number
 * @min 1
 * @max 100
 * @default 100
 * @desc 成長武器が得られる経験値の割合を設定
 *       割合は獲得経験値の1～100%で設定
 *
 * @param validSwitch
 * @text 有効スイッチ
 * @type switch
 * @default 1
 * @desc 成長装備画面を有効化するスイッチを設定
 *
 * @param growthSkillUseType
 * @text 成長スキル使用タイプ
 * @type select
 * @option いつでも
 * @value 0
 * @option 成長装備着用時
 * @value 1
 * @default 1
 * @desc 成長スキルの使用タイプを設定
 *
 * @param unitLevel
 * @text レベル単位
 * @type string
 * @default Lv
 * @desc 装備レベルの単位を設定
 *
 * @param unitTextLevel
 * @text レベル単位(テキスト)
 * @type string
 * @default レベル
 * @desc テキスト表示する装備レベルの単位を設定
 *
 * @param levelUpMsg
 * @text レベルアップメッセージ
 * @type string
 * @default %1の%2が%3に上がった
 * @desc レベルアップのメッセージを設定
 *       %1:武具名 %2:レベル単位(テキスト) %3:レベル
 *