NAPI 顔グラ自動表示 - NAPI_AutoFaceGraphic.js

2024-09-29

シェア用テキスト：

▼NAPI 顔グラ自動表示（なぴぃ様作） - NAPI_AutoFaceGraphic.js
https://plugin-mz.fungamemake.com/archives/4122
文章の表示で文章に含まれた名前に応じて自動で顔画像を表示します。表情キーを設定する事で表情も指定できます。MZの場合文章内に書いた名前を名前枠に移す事ができます。

ふりがな：かおぐらじどうひょうじ

機能概要：文章の表示で文章に含まれた名前に応じて自動で顔画像を表示します。表情キーを設定する事で表情も指定できます。MZの場合文章内に書いた名前を名前枠に移す事ができます。

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

作者：なぴぃ

作者サイト：https://napiiey.github.io/plugins/

解説ページ：https://napiiey.github.io/plugins/napi_autofacegraphic.…

ファイル名：NAPI_AutoFaceGraphic.js

プラグインのヘルプ：

/*:
 * @target MV MZ
 * @plugindesc 顔グラ自動表示プラグイン
 * @author なぴぃ
 * 
 * @help 文章の表示で文章に含まれた名前に応じて自動で顔画像を表示します。
 * 表情キーを設定する事で表情も指定できます。
 * MZの場合文章内に書いた名前を名前枠に移す事ができます。
 * 
 * 
 * ●使い方
 * 顔画像リストで呼び出したい画像を設定します。
 * 文章の表示コマンドで
 * 
 * 　　名前「本文
 * 
 * の形式で入力します。
 * 
 * 　　例）
 * 　　ハロルド「自動で画像を表示するぞ！
 * 
 * すると名前に対応した画像が自動で表示されます。
 * 
 * 
 * ●表情の変更
 * 表情差分を含んだ画像を顔画像リストで登録します。
 * 表情キーリストで表情を呼び出すキーとなる文字を設定します。
 * 
 * 　　名前 表情キー「本文
 * 
 * の形式で入力します。
 * 
 * 　　例）
 * 　　ハロルド怒「自動で”怒”キーを設定したインデックスの画像を表示するぞ！
 * 
 * プレイ時には表情キーは表示されず以下のように表示されます。
 * 
 * 　　ハロルド「自動で”怒”キーを設定したインデックスの画像を表示するぞ！
 * 
 * 
 * ●スクリプト等で利用できる情報（上級者向け）
 * 文章の表示並列コモンスイッチプラグイン等を使ったコモンイベントで利用できる情報です。
 * 
 * NAPI.afgFaceImage　顔画像のファイル名
 * NAPI.afgFaceIndex　顔画像のインデックス
 * NAPI.afgBackground　ウィンドウ背景（0.ウィンドウ 1.暗くする 2.透明）
 * NAPI.afgPositionType　ウィンドウの位置（0.上 1.中 2.下）
 * NAPI.afgName　名前
 * NAPI.afgSpeakerName　MZの名前ウィンドウに表示される名前（MZで名前表示欄に表示をONにした場合のみ利用できます）
 * 
 * 文章の表示並列コモンスイッチプラグインと併用する場合はこのプラグインを上にして下さい。
 * 
 * 
 * ●ご利用について
 * 本プラグインはMITライセンスの下で公開しています。
 * MITライセンスの内容に従ってご利用下さい。
 * https://napiiey.github.io/plugins/license.html
 * 
 * 
 * @param Delimiter
 * @text 名前と本文を区切る記号
 * @desc 文章の表示の文章入力時に名前と本文を区切る記号を指定します。
 * @default 「
 * @type string
 * 
 * @param FaceGraphicList
 * @text 顔画像リスト
 * @desc 顔グラを 名前:ファイル名:標準インデックス（左上から右に0-3）の形で指定します。改行を挟み複数入力できます。(:は半角)
 * @default ”ハロルド:Actor1:0nテレーゼ:Actor1:7”
 * @type note
 * 
 * @param FacialExpressionKeyList
 * @text 表情キーリスト
 * @desc 表情を呼び出すキーとなる文字を設定します。行数がインデックスに対応しています。（左上から右に0-3、左下から右に4-7）
 * @default ”常n喜n怒n哀n楽n苦n攻n驚n”
 * @type note
 * 
 * @param HideFaceGraphicKey
 * @text 顔画像非表示キー
 * @desc 顔画像を非表示にする為のキーとなる文字を設定します。
 * @default 無
 * @type string
 * 
 * @param PluginDisableSwitch
 * @text プラグイン無効化スイッチ
 * @desc ここで設定したスイッチがONになっている間このプラグインが無効になります。
 * @default 0
 * @type switch
 * 
 * @param ShowInNameWindow
 * @text 名前表示欄に表示（MZ用）
 * @desc 文章内の名前をMZの名前表示欄に表示します。
 * @default true
 * @type boolean
 * 
 */