GABA 名前による顔画像自動表示 - GABA_AutoDisplayFaceByName.js

シェア用テキスト：

▼GABA 名前による顔画像自動表示（ガバチョ（溟犬一六）様作） - GABA_AutoDisplayFaceByName.js
https://plugin-mz.fungamemake.com/archives/3623
メッセージ表示の名前欄に従って顔画像を自動表示します。

ふりがな：なまえによるかおがぞうじどうひょうじ

機能概要： メッセージ表示の名前欄に従って顔画像を自動表示します。

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

作者：ガバチョ（溟犬一六）

作者サイト：https://star-write-dream.com/

解説ページ：https://star-write-dream.com/#/MZ-AutoDisplayFaceByName

ファイル名：GABA_AutoDisplayFaceByName.js

プラグインのヘルプ：

/*:ja
 * @target MZ
 * @plugindesc 名前と顔グラフィックを関連づけて自動表示します。
 * @author ガバチョ（溟犬一六）
 * @url https://star-write-dream.com/
 * @orderAfter GABA_NameWindowAdjustment
 * @help GABA_AutoDisplayFaceByName.js(ver1.0.0)
 *
 *  メッセージ表示の名前欄に従って顔画像を自動表示します。
 *
 *  ■前知識
 *  ・キャラ1人につき顔画像を１つ用意する必要があります。
 *  ・顔画像はデプロイメントの「未使用ファイルを除外」で除外されます。
 *    最後に手動コピペを忘れずに。
 *
 * ■画像ファイルの準備
 *  正方形の画像を用意してください。144*144で表示します。
 *  ファイル名はアルファベットにしてください。
 *
 * ■パラメータの準備
 *  名前とファイル名のセットをリスト登録します。
 * ・名前
 *    キャラの名前です。名前ウィンドウに表示するものを入力します。
 * ・ファイル名
 *    名前と関連づけたいファイル名を、拡張子を除いて入力します。
 *    「taro.png」なら、「taro」と入力します。
 *
 * これで完了です。メッセージ表示で名前ウィンドウが表示される時、
 * リスト登録されていれば顔画像が自動表示されます。
 *
 * ■プラグインコマンド
 * ・顔画像を変更
 *   メッセージに表示中の顔画像を変更します。
 *   並列コモンイベントで実行してください。
 *
 * ■１キャラで複数の顔画像を使い分ける
 *  GABA_NameWindowAdjustment.js（ver1.0.2以降）を導入し、
 *  メッセージ中のタグによって名前を表示できるようにしてください。
 *  その時のタグ指定によって、複数の画像を切り替えます。
 *
 *  ○画像ファイルの用意：通常の顔画像のファイル名の末尾に、
 *    適当な文字列を付けたものを用意します。
 *     ※ファイル名に半角スペースを使わないでください。
 *    例）taro.png、taroAngry.png、taroSad.png
 *    パラメータには「太郎」「taro」を登録します。
 *
 *  名前欄に入力、または通常のタグ指定（tag[太郎]）をすると「taro.png」が表示されます。
 *  タグ指定の際、
 *   「tag[太郎, Angry]」とすると、「taroAngry.png」が表示されます。
 *   「tag[太郎, Sad]」とすると、「taroSad.png」が表示されます。
 *
 * --------------------------
 * Copyright (c) 2021 Gabacho(Ichiro Meiken)
 * Released under the MIT license
 * https://opensource.org/licenses/mit-license.php
 * --------------------------
 *
 * @param faceDataList
 * @text 顔画像データリスト
 * @type struct<GABAFaceData>[]
 * @desc 名前と画像名の関連づけリスト。
 * @default []
 *
 * @param faceDir
 * @text 顔画像を配置するフォルダ名
 * @desc 顔画像はすべて、imgフォルダの中の、このフォルダに置いてください。デフォルト「pictures」
 * @default pictures
 *
 * @command changeFaceImage
 * @text 顔画像を変更
 * @desc メッセージに表示中の顔グラフィックを変更します。並列コモンイベントで実行してください。
 *
 * @arg fileName
 * @type file
 * @text 顔画像ファイル
 * @desc 顔画像を選択してください。
 *
 */