鳶嶋式 [フキダシアイコンの表示]の拡張 - TF_BalloonEx.js

シェア用テキスト：

▼鳶嶋式 [フキダシアイコンの表示]の拡張（とんび@鳶嶋工房様作） - TF_BalloonEx.js
https://plugin-mz.fungamemake.com/archives/6947
フキダシアニメ開始、単体フキダシ表示、フキダシ位置変更、フキダシアニメ停止

ふりがな：[ふきだしあいこんのひょうじ]のかくちょう

機能概要： フキダシアニメ開始、単体フキダシ表示、フキダシ位置変更、フキダシアニメ停止

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

作者：とんび@鳶嶋工房

作者サイト：http://tonbi.jp/

解説ページ：https://github.com/tonbijp/RPGMakerMZ?tab=readme-ov-fil…

ダウンロードページ：https://raw.githubusercontent.com/tonbijp/RPGMakerMZ/ma…

ファイル名：TF_BalloonEx.js

プラグインのヘルプ：

/*:ja
 * @target MZ
 * @plugindesc [フキダシアイコンの表示]の拡張
 * @author とんび@鳶嶋工房
 * @url https://github.com/tonbijp/RPGMakerMZ/blob/master/TF_BalloonEx.js
 * @base PluginCommonBase
 * @orderAfter PluginCommonBase
 *
 * @param balloonParamList @text アニメーション設定
 * @type struct<BalloonParam>[]
 * @default [”{”name”:”びっくり”,”dx”:”0”,”dy”:”0”,”startPatterns”:”0”,”loopPatterns”:”7”,”endPatterns”:”0”,”loops”:”1”,”speed”:”4”,”waitTime”:”24”}”,”{”name”:”はてな”,”dx”:”0”,”dy”:”0”,”startPatterns”:”0”,”loopPatterns”:”8”,”endPatterns”:”0”,”loops”:”1”,”speed”:”4”,”waitTime”:”24”}”,”{”name”:”音符”,”dx”:”0”,”dy”:”0”,”startPatterns”:”0”,”loopPatterns”:”8”,”endPatterns”:”0”,”loops”:”2”,”speed”:”4”,”waitTime”:”12”}”,”{”name”:”ハート”,”dx”:”0”,”dy”:”0”,”startPatterns”:”4”,”loopPatterns”:”4”,”endPatterns”:”0”,”loops”:”3”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”怒り”,”dx”:”0”,”dy”:”0”,”startPatterns”:”1”,”loopPatterns”:”3”,”endPatterns”:”0”,”loops”:”4”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”汗”,”dx”:”0”,”dy”:”0”,”startPatterns”:”0”,”loopPatterns”:”8”,”endPatterns”:”0”,”loops”:”1”,”speed”:”8”,”waitTime”:”32”}”,”{”name”:”くしゃくしゃ”,”dx”:”0”,”dy”:”0”,”startPatterns”:”1”,”loopPatterns”:”3”,”endPatterns”:”0”,”loops”:”3”,”speed”:”8”,”waitTime”:”0”}”,”{”name”:”沈黙”,”dx”:”0”,”dy”:”0”,”startPatterns”:”1”,”loopPatterns”:”3”,”endPatterns”:”0”,”loops”:”1”,”speed”:”12”,”waitTime”:”48”}”,”{”name”:”電球”,”dx”:”0”,”dy”:”0”,”startPatterns”:”2”,”loopPatterns”:”3”,”endPatterns”:”0”,”loops”:”2”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”Zzz”,”dx”:”0”,”dy”:”0”,”startPatterns”:”0”,”loopPatterns”:”6”,”endPatterns”:”0”,”loops”:”2”,”speed”:”10”,”waitTime”:”12”}”,”{”name”:”星”,”dx”:”0”,”dy”:”0”,”startPatterns”:”2”,”loopPatterns”:”6”,”endPatterns”:”0”,”loops”:”0”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”はてな複数”,”dx”:”18”,”dy”:”15”,”startPatterns”:”5”,”loopPatterns”:”3”,”endPatterns”:”0”,”loops”:”4”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”音符複数”,”dx”:”20”,”dy”:”0”,”startPatterns”:”3”,”loopPatterns”:”5”,”endPatterns”:”0”,”loops”:”0”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”ハート複数”,”dx”:”0”,”dy”:”0”,”startPatterns”:”3”,”loopPatterns”:”5”,”endPatterns”:”0”,”loops”:”0”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”ユゲダシ”,”dx”:”0”,”dy”:”0”,”startPatterns”:”2”,”loopPatterns”:”5”,”endPatterns”:”0”,”loops”:”4”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”汗複数”,”dx”:”0”,”dy”:”0”,”startPatterns”:”3”,”loopPatterns”:”3”,”endPatterns”:”1”,”loops”:”4”,”speed”:”8”,”waitTime”:”12”}”,”{”name”:”がやがや”,”dx”:”0”,”dy”:”0”,”startPatterns”:”2”,”loopPatterns”:”3”,”endPatterns”:”2”,”loops”:”4”,”speed”:”8”,”waitTime”:”0”}”,”{”name”:”きゃっきゃ”,”dx”:”20”,”dy”:”5”,”startPatterns”:”3”,”loopPatterns”:”2”,”endPatterns”:”3”,”loops”:”40”,”speed”:”8”,”waitTime”:”0”}”,”{”name”:”ヒットマーク”,”dx”:”0”,”dy”:”40”,”startPatterns”:”5”,”loopPatterns”:”1”,”endPatterns”:”2”,”loops”:”5”,”speed”:”1”,”waitTime”:”0”}”,”{”name”:”カウントダウン”,”dx”:”0”,”dy”:”0”,”startPatterns”:”5”,”loopPatterns”:”0”,”endPatterns”:”0”,”loops”:”1”,”speed”:”60”,”waitTime”:”0”}”]
 * 
 * @param baseDy @text 基本y座標差分
 * @type number
 * @default 0
 * 
 * @================================================
 * @help
 * ●基本的な使い方
 * 　プラグインパラメータの[アニメーション設定]に[フキダシ番号]毎に設定を書く。
 * 　・配置(dx,dy) ループ回数(loops) 速度(speed) 終了時間(waitTime)など設定。
 * 　・パターン数(出現, ループ, 消滅)は計8以内。
 * 　・値について詳細は、それぞれのヘルプ文などを参照。
 * 　通常の[フキダシアイコンの表示]イベントコマンドを実行すると、
 * 　[フキダシ番号]に応じた設定でアニメが再生されます。
 *
 * ●プラグインコマンド
 * [フキダシアニメ開始]
 * [単体フキダシ表示]
 * [フキダシ位置変更]
 * [フキダシアニメ停止]
 * 
 * ● [移動ルートの設定]で使えるスクリプト
 * 
 * this.TF_startBalloon( [フキダシ番号], [完了までウエイト], [dx], [dy] );
 * 　[フキダシアニメ開始]の機能
 * 　[完了までウエイト], [dx], [dy] は省略できます。
 * 　規定値は [フキダシアニメ開始] に準拠します。
 *------------------------------
 * this.TF_setBalloon( [フキダシ番号], [パターン番号], [表示フレーム数], [完了までウェイト], [dx], [dy] );
 * 　[単体フキダシ表示]の機能
 *------------------------------
 * this.TF_locateBalloon( [dx], [dy] );
 * 　[フキダシ位置変更]の機能
 *------------------------------
 * this.TF_stopBalloon( [消滅アニメを表示] );
 * 　[フキダシアニメ停止]の機能
 *------------------------------
 *
 *
 * 利用規約 : MITライセンス
 * @================================================
 * @command startBalloon @text フキダシアニメ開始
 * @desc
 * ほぼ[フキダシアイコンの表示]コマンドと同じ。
 * +フォロワー指定 +表示位置指定 の機能強化。
 * @arg eventId @text イベントID
 * @desc
 * イベントID(数値)かイベントの名前
 * @type combo @default this
 * @option this @option player @option follower0 @option follower1 @option follower2
 * @option boat @option ship @option airship
 *
 * @arg balloonIndex @text フキダシ番号
 * @desc
 * [アニメーション設定]で設定した名前か
 * フキダシ番号(数値)を入力します。
 * @type combo @default びっくり
 * @option びっくり @option はてな @option 音符 @option ハート @option 怒り
 * @option 汗 @option くしゃくしゃ @option 沈黙 @option 電球 @option 沈黙 @option Zzz
 *
 * @arg isWait @text 完了までウェイト
 * @type boolean @default false
 * @on 待つ @off 待たない(規定)
 *
 * @arg dx @text 表示位置X差分
 * @desc
 * [テキスト]で空に設定すると[アニメーション設定]で
 * フキダシ番号毎に設定された値が使われます。
 * @type number @default
 * @min -1000000
 * 
 * @arg dy @text 表示位置Y差分
 * @desc
 * [テキスト]で空に設定すると[アニメーション設定]で
 * フキダシ番号毎に設定された値が使われます。
 * @type number @default
 * @min -1000000
 * 
 * @================================================
 * @command setBalloon @text 単体フキダシ表示
 * @desc
 *
 * @arg eventId @text イベントID
 * @desc
 * イベントID(数値)かイベントの名前
 * @type combo @default this
 * @option this @option player @option follower0 @option follower1 @option follower2
 * @option boat @option ship @option airship
 *
 * @arg balloonIndex @text フキダシ番号
 * @desc
 * [アニメーション設定]で設定した名前か
 * フキダシ番号(数値)を入力します。
 * @type combo @default びっくり
 * @option びっくり @option はてな @option 音符 @option ハート @option 怒り
 * @option 汗 @option くしゃくしゃ @option 沈黙 @option 電球 @option 沈黙 @option Zzz
 *
 * @arg patternIndex @text パターン番号
 * @desc
 * フキダシ画像の左から 0〜7 のパターン(規定値:7)
 * @type number @default 7
 * @min 0 @max 7
 * 
 * @arg waitTime @text 表示フレーム数
 * @desc
 * 0:TF_STOP_BALLOONを実行するまでループ
 * (規定値:64フレーム)
 * @type number @default 64
 * @min 0
 * 
 * @arg isWait @text 完了までウェイト
 * @type boolean @default false
 * @on 待つ @off 待たない(規定)
 *
 * @arg dx @text 表示位置X差分
 * @desc
 * [テキスト]で空に設定すると[アニメーション設定]で
 * フキダシ番号毎に設定された値が使われます。
 * @type number @default
 * @min -1000000
 *
 * @arg dy @text 表示位置Y差分
 * @desc
 * [テキスト]で空に設定すると[アニメーション設定]で
 * フキダシ番号毎に設定された値が使われます。
 * @type number @default
 * @min -1000000
 *
 * @================================================
 * @command locateBalloon @text フキダシ位置変更
 * @desc
 * フキダシ表示中のみ可能。
 * 
 * @arg eventId @text イベントID
 * @desc
 * イベントID(数値)かイベントの名前
 * @type combo @default this
 * @option this @option player @option follower0 @option follower1 @option follower2
 * @option boat @option ship @option airship
 *
 * @arg dx @text 表示位置X差分
 * @desc
 * [テキスト]で空に設定すると[アニメーション設定]で
 * フキダシ番号毎に設定された値が使われます。
 * @type number @default
 * @min -1000000
 *
 * @arg dy @text 表示位置Y差分
 * @desc
 * [テキスト]で空に設定すると[アニメーション設定]で
 * フキダシ番号毎に設定された値が使われます。
 * @type number @default
 * @min -1000000
 *
 * @================================================
 * @command stopBalloon @text フキダシアニメ停止
 * @desc
 * [フキダシアニメ開始][単体フキダシ表示]で
 * [ループ回数] 0 の場合、これを使って止める。
 *
 * @arg eventId @text イベントID
 * @desc
 * イベントID(数値)かイベントの名前
 * @type combo @default this
 * @option this @option player @option follower0 @option follower1 @option follower2
 * @option boat @option ship @option airship
 *
 * @arg showFinish @text 消滅アニメ表示
 * @desc
 * 消滅アニメを表示してから消すか。
 * @type boolean @default false
 * @on 消滅アニメ表示(規定) @off 即時
 */