アビリティボード実装 - AbilityBoard.js

シェア用テキスト：

▼アビリティボード実装（Basu様作） - AbilityBoard.js
https://plugin-mz.fungamemake.com/archives/7102
アビリティボード機能を実装します。

ふりがな：あびりてぃぼーどじっそう

機能概要： アビリティボード機能を実装します。

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

作者：Basu

作者サイト：https://github.com/basuka

解説ページ：https://github.com/basuka/RPGMZ/tree/main/AbilityBoard

ファイル名：AbilityBoard.js

プラグインのヘルプ：

/*:ja
 * @target MZ
 * @plugindesc アビリティボード機能を実装します。
 * @author Basu
 * @url https://raw.githubusercontent.com/basuka/RPGMZ/main/AbilityBoard/AbilityBoard.js
 *
 *
 * @help パラメータの設定項目
 *
 * 【パラメータ】
 *
 * ■アクターアビリティ
 * アクター毎にアビリティの設定をします。
 *
 * 　・アクター
 * 　アビリティの設定を行うアクターを設定します。
 *
 * 　・開始X軸
 * 　アビリティの開始位置(X軸)を設定します。
 *
 * 　・開始Y軸
 * 　アビリティの開始位置(Y軸)を設定します。
 *
 * 　・開始アイコン
 * 　開始アビリティのアイコンを設定します。
 * 　-1を設定するとアクターの顔画像が設定されます。
 * 　アイコンはテキストタグ変更後に右クリックから設定が可能です。
 * 　※右クリックから設定を行う場合、デフォルトの数値は消えないので注意してください
 *
 * 　　例：デフォルトで0が入力されている状況で右クリックから32番目のアイコンを設定すると「320」が設定されます。
 *
 * 　・アビリティ情報
 * 　アビリティ情報の設定を行います。
 * 　アビリティ情報については後述【アビリティ情報について】を参照してください。
 *
 * 　・移動先アビリティ
 * 　キー入力によるカーソルの移動先IDを設定します。
 *
 *
 * 【アビリティ情報について】
 *
 * 　・ID
 * 　アビリティIDを設定します。
 * 　IDはユニークな値を設定してください。
 *
 * 　・メモ
 * 　設定するアビリティについてのメモとして使用してください。
 * 　プラグイン上では使用されないので自由にお使いください。
 *
 * 　・アビリティ名
 * 　アビリティ名の設定を行います。
 *
 * 　・アイコン
 * 　アビリティに使用するアイコンを設定ます。
 *
 * 　・必要AP
 * 　取得に必要なアビリティポイントを設定ます。
 *
 * 　・説明
 * 　アビリティの説明を設定します。
 * 　スキル習得の場合はスキルの説明が自動で設定されます。
 *
 * 　・親アビリティID
 * 　親アビリティのIDを設定します。
 * 　設定した親アビリティを基準に表示位置や取得の可否などが設定されます。
 *
 * 　・表示位置X軸
 * 　アビリティの表示位置(X軸)を設定します。
 * 　親アビリティを基準(0,0)に設定されます。
 *
 * 　・表示位置Y軸
 * 　アビリティの表示位置(Y軸)を設定します。
 * 　親アビリティを基準(0,0)に設定されます。
 *
 * 　・紐づけ先ID
 * 　親アビリティとは別に紐づけを行いたいIDを設定します。
 * 　紐づけ先IDは複数設定することが可能です。
 *
 * 　・グループ化
 * 　親アビリティと紐づけしたアビリティのグループ化を設定します。
 * 　グループ化にした場合、親アビリティと紐づけしたアビリティを全て取得後にアビリティの取得が可能になります。
 *
 * 　・移動先アビリティ
 * 　キー入力によるカーソルの移動先IDを設定します。
 *
 * 　・アビリティタイプ
 * 　アビリティが「アビリティ獲得」か「スキル習得」かの設定を行います。
 *
 *
 * 　●アビリティ効果
 * 　アビリティによる効果を設定します。
 *
 * 　【耐性】
 *
 * 　・属性有効度
 * 　属性有効度を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 * 　・弱体有効度
 * 　弱体有効度を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 * 　・ステート有効度
 * 　ステート有効度を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 * 　・ステート無効
 * 　ステート無効を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 *
 *  【能力値】
 *
 * 　・通常能力値
 * 　通常能力値を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 * 　※能力値を率(％)で設定した場合、ベースの能力(装備をしていない状態)で計算されます。
 *
 * 　・追加能力値
 * 　追加能力値を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 * 　・特殊能力値
 * 　特殊能力値を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 *
 *　【その他】
 *
 * 　・攻撃時ステート
 * 　攻撃時ステートを設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 * 　・攻撃回数追加
 * 　攻撃回数追加を設定します。
 * 　詳細についてはツクールのヘルプを参照してください。
 *
 * 　・スキル習得
 * 　習得するスキルを設定します。
 *
 *
 * ■AP獲得アイテム
 * AP獲得アイテムを設定します。
 *
 * 　・AP獲得アイテム
 * 　AP獲得アイテムとするアイテムを設定します。
 *
 * 　・獲得値
 * 　アイテムによる獲得するAP値を設定します。
 *
 *
 * 【AP獲得】
 *
 * ■AP獲得方法
 * APの獲得方法を設定します。
 *
 * ■獲得AP(レベル)
 * レベルによる獲得APの設定をします。
 *
 * 　・設定範囲
 * 　獲得APを設定するアクターの範囲を設定します。
 *
 * 　・獲得値(全体)
 * 　全アクター共通の獲得APを設定します。
 *
 * 　・獲得値(アクター別)
 * 　アクター毎に獲得するAPを設定します。
 *
 * ■獲得AP(戦闘勝利)
 * 戦闘勝利による獲得APの設定をします。
 *
 * 　・獲得値
 * 　勝利時に獲得するAPを設定します。
 *
 * 　・敵グループ
 * 　獲得値を設定する敵グループを設定します。
 *
 *
 * 【初期メニュー】
 *
 * ■初期状態
 * 初期状態で機能を有効にするかを設定します。
 *
 * ■メニュー表示
 * 機能が無効の場合、メニューに表示するかを設定します。
 *
 * ■有効・無効判定
 * 機能の有効・無効を判定するためのスイッチを設定します。
 *
 * ■無効時AP取得
 * 機能が無効の間もAPを取得するかを設定します。
 *
 *
 * 【表示文字】
 *
 * ■メニュー表示
 * メニューに表示するコマンドを設定します。
 *
 * ■AP名
 * 表示するAP名を設定します。
 *
 * ■取得
 * アビリティ取得コマンドに表示するコマンド(取得)を設定します。
 *
 * ■取得キャンセル
 * アビリティ取得コマンドに表示するコマンド(キャンセル)を設定します。
 *
 * ■習得
 * スキル習得コマンドに表示するコマンド(習得)を設定します。
 *
 * ■習得キャンセル
 * スキル習得コマンドに表示するコマンド(キャンセル)を設定します。
 *
 *
 * 【メッセージ】
 *
 * ■アビリティ取得確認
 * アビリティ取得確認メッセージを設定します。
 * ※１行目にアビリティ名が表示されます
 *
 * ■スキル習得確認
 * スキル習得確認メッセージを設定します。
 * ※１行目にスキル名が表示されます
 *
 * ■勝利獲得メッセージ
 * 勝利時にAPを獲得するメッセージを設定します。
 * %1：獲得AP　%2：AP名
 *
 *
 * 【色】
 *
 * ■取得済みライン色
 * 取得済みアビリティのラインの色を設定します。
 *
 * ■未取得ライン色
 * 未取得アビリティのラインの色を設定します。
 *
 *
 *
 * ■戦闘非参加メンバー
 * 戦闘非参加メンバーを戦闘勝利時のAP獲得対象にするかを設定します。
 *
 * ■スクロール矢印
 * スクロール可能時の矢印を表示するかを設定します。
 *
 *
 *-----------------------------------------------------------------------------
 * README
 *-----------------------------------------------------------------------------
 * https://github.com/basuka/RPGMZ/blob/main/AbilityBoard/README.md
 *
 *-----------------------------------------------------------------------------
 * 利用規約
 *-----------------------------------------------------------------------------
 * このプラグインはMITライセンスで配布しています
 *
 *
 *-----------------------------------------------------------------------------
 * 更新履歴
 *-----------------------------------------------------------------------------
 * 2024/6/10 Ver.1.0.0　公開
 * 2024/6/14 Ver.1.0.1　PageUP/PageDownキー(キーボード操作)によるアクター変更時にフリーズが発生する不具合を修正
 *
 *
 *
 *=====================================================================================================================================================
 * @param actorAbilityList
 * @text アクターアビリティ
 * @type struct<actorAbility>[]
 * @desc 各アクターのアビリティを設定
 *
 * @param apItemInfoList
 * @text AP獲得アイテム
 * @type struct<apItemInfo>[]
 * @desc AP獲得アイテムを設定
 *
 * @param gainMethod
 * @text AP獲得
 * @type string
 * @default ==================================
 *
 * @param gainMethodType
 * @text AP獲得方法
 * @type select
 * @option レベル
 * @value 0
 * @option 戦闘勝利
 * @value 1
 * @option その他
 * @value 2
 * @default 0
 * @parent gainMethod
 * @desc APの獲得方法を設定
 *
 * @param levelGainAp
 * @text 獲得AP(レベル)
 * @type struct<levelGainAp>
 * @parent gainMethod
 * @desc レベルアップ時に獲得するAPを設定
 *
 * @param troopGainApList
 * @text 獲得AP(戦闘勝利)
 * @type struct<troopGainAp>[]
 * @parent gainMethod
 * @desc 戦闘勝利時に獲得するAPを設定
 *
 * @param option
 * @text オプション
 * @type string
 * @default ==================================
 *
 * @param initMenu
 * @text 初期メニュー
 * @type string
 * @default ==================================
 * @parent option
 *
 * @param initEnabled
 * @text 初期状態
 * @type boolean
 * @on 有効
 * @off 無効
 * @default true
 * @parent initMenu
 * @desc 初期状態を有効・無効で設定
 *
 * @param menuShow
 * @text メニュー表示
 * @type boolean
 * @on 表示
 * @off 非表示
 * @default true
 * @parent initMenu
 * @desc 無効の場合メニューに表示するかを設定
 *
 * @param enabledSwitchId
 * @text 有効・無効判定
 * @type switch
 * @parent initMenu
 * @desc 無効の場合有効・無効の判定を行うスイッチを設定
 *
 * @param invalidGain
 * @text 無効時AP取得
 * @type boolean
 * @on 取得する
 * @off 取得しない
 * @default false
 * @parent initMenu
 * @desc 無効の場合もAPを取得するかを設定
 *
 * @param text
 * @text 表示文字
 * @type string
 * @default ==================================
 * @parent option
 *
 * @param menuText
 * @text メニュー表示
 * @type string
 * @default アビリティボード
 * @parent text
 * @desc メニューコマンドに表示する文字を設定
 *
 * @param apNameText
 * @text AP名
 * @type string
 * @default AP
 * @parent text
 * @desc 表示するアビリティポイント名を設定
 *
 * @param acquisitionYesText
 * @text 取得
 * @type string
 * @default 取得する
 * @parent text
 * @desc アビリティ取得コマンド(取得)を設定
 *
 * @param acquisitionNoText
 * @text 取得キャンセル
 * @type string
 * @default 取得しない
 * @parent text
 * @desc アビリティ取得コマンド(取得キャンセル)を設定
 *
 * @param learnSkillYesText
 * @text 習得
 * @type string
 * @default 習得する
 * @parent text
 * @desc スキル習得コマンド(習得)を設定
 *
 * @param learnSkillNoText
 * @text 習得キャンセル
 * @type string
 * @default 習得しない
 * @parent text
 * @desc スキル習得コマンド(習得キャンセル)を設定
 *
 * @param message
 * @text メッセージ
 * @type string
 * @default ==================================
 * @parent option
 *
 * @param acquisitionMsg
 * @text アビリティ取得確認
 * @type string
 * @default このアビリティを取得しますか？
 * @parent message
 * @desc アビリティ取得確認メッセージを設定
 *       ※１行目にアビリティ名が表示されます
 *
 * @param learnSkillMsg
 * @text スキル習得確認
 * @type string
 * @default このスキルを習得しますか？
 * @parent message
 * @desc スキル習得確認メッセージを設定
 *       ※１行目にスキル名が表示されます
 *
 * @param winGainApMsg
 * @text 勝利獲得メッセージ
 * @type string
 * @default %1%2を獲得！
 * @parent message
 * @desc 勝利時にAPを獲得する場合のメッセージを設定
 *       %1：獲得AP　%2：AP名
 *
 * @param color
 * @text 色
 * @type string
 * @default ==================================
 * @parent option
 *
 * @param acquisitionLineColor
 * @text 取得済みライン色
 * @type string
 * @default #f0f8ff
 * @parent color
 * @desc 取得済みアビリティのライン色を設定
 *
 * @param notAcquisitionLineColor
 * @text 未取得ライン色
 * @type string
 * @default #808080
 * @parent color
 * @desc 未取得アビリティのライン色を設定
 *
 * @param gainBenchMembers
 * @text 戦闘非参加メンバー
 * @type boolean
 * @on 取得する
 * @off 取得しない
 * @default false
 * @desc 戦闘非参加メンバーを戦闘勝利時の獲得対象にするかを設定
 * @parent option
 *
 * @param drawArrow
 * @text スクロール矢印
 * @type boolean
 * @on 表示
 * @off 非表示
 * @default true
 * @desc スクロール可能時の矢印を表示するかを設定
 * @parent option
 *
 */