鳶嶋式 キャラのアニメや移動など強化 - TF_CharEx.js

シェア用テキスト：

▼鳶嶋式 キャラのアニメや移動など強化（とんび@鳶嶋工房様作） - TF_CharEx.js
https://plugin-mz.fungamemake.com/archives/6949
キャラ( イベント・プレイヤー・隊列メンバー )の位置・パターンの設定。頻出するアニメーションの指定。キャラの[ルート移動]の簡易コマンドによる指定。通常のイベントコマンドでは指定できない隊列メンバーを指定できる。

ふりがな：きゃらのあにめやいどうなどきょうか

機能概要： キャラ( イベント・プレイヤー・隊列メンバー )の位置・パターンの設定。頻出するアニメーションの指定。キャラの[ルート移動]の簡易コマンドによる指定。通常のイベントコマンドでは指定できない隊列メンバーを指定できる。

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

作者：とんび@鳶嶋工房

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

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

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

ファイル名：TF_CharEx.js

プラグインのヘルプ：

/*:ja
 * @target MZ
 * @plugindesc キャラのアニメや移動など強化
 * @author とんび@鳶嶋工房(tonbi.jp)
 * @url https://github.com/tonbijp/RPGMakerMZ/blob/master/TF_CharEx.js
 * @base PluginCommonBase
 * @orderAfter PluginCommonBase
 *
 * @param moveUnit @text [アニメの終了]時の配置単位
 * @desc 規定値: 通常(1タイル)
 * @type select @default 1
 * @option 通常(1タイル) @value 1
 * @option 半歩(0.5タイル) @value 0.5
 * @option なし(アナログ) @value 0
 * 
 * @help
 * 主な機能とイベントコマンドにない利点。
 * 
 * 1 : キャラ( イベント・プレイヤー・隊列メンバー )の位置・パターンの設定。
 * 　ピクセル単位の位置指定で、キャラの繊細なアニメーションができる。
 * 　歩行パターン別の指定で、キャラ素材を無駄なく利用できる。
 * 
 * 2 : 頻出するアニメーションの指定。
 * 　ドア・宝箱の開閉など、縦のアニメーションを1コマンドで指定。
 * 　歩行パターン別に指定可能なので、3列違う素材を置ける。
 *
 * 3 : キャラの[ルート移動]の簡易コマンドによる指定。
 * 　例えば[上に移動][上に移動][上に移動][上に移動]と指定が必要な場合、
 * 　↑4 と書けるので回数調整が容易で、全体の見通しが良い。
 *
 * 4 : 通常のイベントコマンドでは指定できない隊列メンバーを指定できる。
 * 　プレイヤーの設定がコピーされるため、[向き固定]など指定しても反映されない。
 * 　反映させたい場合は[隊列メンバーの追跡設定]をOFFにする。
 *
 * 利用できるプラグインコマンド一覧
 * [移動ルートの一括設定]
 * [キャラパターン指定アニメ]
 * [キャラパターンを指定]
 * [イベントを指定座標に移動]
 * [イベントを別のイベント位置に移動]
 * [イベントを指定座標に配置]
 * [イベントを別のイベント位置に配置]
 * [隊列メンバーの追跡設定]
 * [アニメの指定]
 * [アニメの終了]
 * ※ 利用方法はプラグインコマンド設定時の説明をご覧ください。
 * 
 * 【[移動ルートの設定]で使うスクリプト】
 * ------------------------------
 * TF_setCharPattern([キャラクター番号], [歩行パターン], [キャラの向き]);
 * 　[キャラパターンを指定]コマンドの[移動ルートの設定]用。
 * ------------------------------
 * this.TF_goXY( [x], [y] );
 * 　[イベントを指定座標に移動]コマンドの[移動ルートの設定]用。
 * ------------------------------
 * this.TF_goEv( [目標イベントID], [dx], [dy] );
 * 　[イベントを別のイベント位置に移動]コマンドの[移動ルートの設定]用。
 * =========================
 * 
 * 【プラグインコマンドに指定する引数の詳細】
 * ------------------------------
 * [イベントID] は、イベントの[名前]でも指定できる。
 * ただし数値や 上記 this などと同じ名前、スペースの入った名前の指定不可。
 * ------------------------------
 * [向き]にはテンキーに対応した数字の他、以下の文字が利用できる。
 * 　上: up, u, north, n, ↑, 上, 北
 * 　左: left, l, west, w, ←, 左, 西
 * 　右: right, r, east, e, →, 右, 東
 * 　下: down, d, south, s, ↓, 下, 南
 * 　※大文字小文字の区別をしません。
 * ------------------------------
 * [キャラパターン]は歩行グラフィックの[歩行パターン]と[向き]を一度に指定。
 * 　0, 1, 2		<= 下向き(テンキー2)
 * 　3, 4, 5		<= 左向き(テンキー4)
 * 　6, 7, 8		<= 右向き(テンキー6)
 * 　9, 10, 11 <= 上向き(テンキー8)
 * ------------------------------
 * 移動速度を[ウェイト]に変換する場合以下のような対応となる。
 * 　1 / 8倍速 … 64フレーム
 * 　1 / 4倍速 … 32フレーム
 * 　1 / 2倍速 … 16フレーム
 * 　通常速 … 8フレーム
 * 　2倍速 … 4フレーム
 * 　4倍速 … 2フレーム
 * ------------------------------
 * [移動指定] コマンド文字+数字を一単位とする文字列。
 * かなり量があるので、印刷するなどして手元で確認することを推奨。
 * 移動系のコマンドは数字に0を指定すると、
 * 方向転換コマンドの[〇〇を向く]と判断される。
 * 　[〇〇に移動] : [方向]に使える文字に加え以下の文字が使える。
 * 　　左上: upleft, ul, northwest, nw, ↖︎, 左上, 北西
 * 　　右上: upright, ur, northeast, ne, ↗︎, 右上, 北東
 * 　　左下: downleft, dl, southwest, sw, ↙︎, 左下, 南西
 * 　　右下: downright, dr, southeast, se, ↘︎, 右下, 南東
 * 　　ランダム: random, &, 乱
 * 　　プレイヤーに近づく: tward, t, 近
 * 　　プレイヤーから遠ざかる: away, y, 遠
 * 　　一歩前進(0は何もしない): front, forward, f, 前
 * 　　一歩後退(0は[180度回転]): back, backward, b, 後
 * 　[ジャンプ…] : jump, j, 跳
 * 　　数字が0の場合は、その場でジャンプ。
 * 　　コンマ( , )で区切ってx,yの座標が指定できる(空白不可)
 * 　[ウェイト…] : wait, z, 待
 * 　　数字はフレーム数。z は寝るイメージ( wは 左に移動なので注意)
 * 　[右に90度回転] : turnright, >, ⤵︎
 * 　　数字に0を指定すると[ランダムに方向転換]
 * 　　1の場合即時変更、2以降は[移動速度]に応じたウェイトをして回転。
 * 　[左に90度回転] : turnleft, <, ⤹, ⤴
 * 　　数字に0を指定すると[右か左に90度回転]
 * 　　1の場合即時変更、2以降は[移動速度]に応じたウェイトをして回転。
 * 　[スイッチ] : switch, h, ス
 * 　　コンマ( , )で区切って一つ目の数字はスイッチID。
 * 　　ふたつ目の数字が0の場合は[スイッチOFF…]、1で[スイッチON…]
 * 　[移動速度の変更…] : agility, a, 速
 * 　　1: 1 / 8倍速, 2: 1 / 4倍速, 3: 1 / 2倍速, 4: 通常速, 5: 2倍速, 6: 4倍速
 * 　[移動頻度の変更…] : freaqency, q, 頻
 * 　　1: 最低, 2: 低, 3: 通常, 4: 高, 5: 最高
 * 　[歩行アニメ] : walk, k, 歩
 * 　　数字が0の場合は[歩行アニメOFF]、1で[歩行アニメON]
 * 　[足踏みアニメ] : step, p, 踏
 * 　　数字が0の場合は[足踏みアニメOFF]、1で[足踏みアニメON]
 * 　[向き固定] : fix, x, 固
 * 　　数字が0の場合は[向き固定OFF]、1で[向き固定ON]
 * 　[すり抜け] : through, g, 抜
 * 　　数字が0の場合は[すり抜けOFF]、1で[すり抜けON]
 * 　[透明化] : invisible, i, 透
 * 　　数字が0の場合は[透明化OFF]、1で[透明化ON]
 * 　[表示] : visible, v, 示
 * 　　数字が0の場合は[表示OFF]、1で[表示ON]
 * 　　透明化のOFFで見えるというのが分かりづらく間違いまくるので追加。
 * 　SET_CHAR : change, c, 変
 * 　　コンマ( , )で区切って [キャラ番号],[歩行パターン],[向き] を数字で指定。
 * 　　標準のコマンド[画像の変更…]は数字だけで指定できないので、
 * 　　現在指定しているキャラ画像内での変更するコマンドを別に追加。
 * 　　[画像の変更…]はファイルとキャラの変更はできる。
 * 　　でも[歩行パターン][向き]の変更はできないので、むしろ高機能かも。
 * 　[不透明度の変更…] : opacity, o, 濁
 *　　0〜255 の間の数字。
 * 　[合成方法の変更…] : blendmode, m, 合
 * 　　0: 通常, 1: 加算, 2: 乗算, 3: スクリーン
 * 　COM_GO_XY( COM_GO_EV ) : go, ＠, 移
 * 　　コンマ( , )で区切って [x],[y] の座標に移動。
 * 　　数字がひとつだけの場合イベントIDとみなし、その位置に移動。
 *
 * ※ PluginCommonBase 定義によりパラメータや引数に V[n] を使えます。
 *
 * 利用規約 : MITライセンス
 * @================================================
 * @command route @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 routeCode @text ルート設定文字列
 * @desc
 * 例: ↑4⤵︎5→3
 * 専用コマンド文字の詳細はヘルプを参照。
 * @type string  @default ↑1↓1←1→1
 *
 * @arg repeat @text 動作を繰り返す
 * @on 繰り返し @off 一回のみ(規定値)
 * @type boolean @default false
 *
 * @arg skippable @text 移動できない場合は飛ばす
 * @on 飛ばす(規定値) @off 停止
 * @type boolean @default true
 *
 * @arg isWait @text 完了までウェイト
 * @on 待つ(規定値) @off 完了を待たず並列実行
 * @type boolean @default true
 *
 * @================================================
 * @command patternAnime @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 fileName @text 画像ファイル名
 * @desc
 * .pngを除いた img/characters/ フォルダのファイル名
 *  (規定値:そのまま)
 * @type file @dir img/characters/
 *
 * @arg characterNumber @text キャラクター番号
 * @desc
 * [0123]
 * [4567] (規定値:-1 そのまま)
 * @type number @default -1
 * @min -1 @max 7
 *
 * @arg animePattern @text パターン
 * @desc
 *  パターンの列(規定値:↓現在列)
 * @type select @default -1
 * @option ↓現在列 @value -1
 * @option ↓・・ 左列 @value 0
 * @option ・↓・ 中央列 @value 1
 * @option ・・↓ 右列 @value 2
 * @option ↑・・ 左列 @value 3
 * @option ・↑・ 中央列 @value 4
 * @option ・・↑ 右列 @value 5
 * @option ┬│↓ 左列から順に全て @value 6
 * @option ↑│┴ 右列から順に全て @value 7
 *
 * @arg waitFrames @text ウェイト
 * @desc
 * 1パターンの表示時間(フレーム数)(0:[移動速度]より算出)
 * @type number @default 0
 * @min 0
 * 
 * @================================================
 * @command setCharPattern  @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 fileName @text 画像ファイル名
 * @desc
 * .pngを除いた img/characters/ フォルダのファイル名
 *  (規定値:そのまま)
 * @type file @dir img/characters/
 *
 * @arg characterNumber @text キャラクター番号
 * @desc
 * [0123]
 * [4567] (規定値:-1 そのまま)
 * @type number @default -1
 * @min -1 @max 7
 *
 * @arg patternNumber @text 歩行パターン
 * @desc
 *  パターンの列(規定値:↓現在列)
 * @type select @default -1
 * @option ↓現在列 @value -1
 * @option ↓・・ 左列 @value 0
 * @option ・↓・ 中央列 @value 1
 * @option ・・↓ 右列 @value 2
 *
 * @arg d @text キャラの向き
 * @desc (規定値: そのまま)
 * @type select @default 0
 * @option そのまま @value 0
 * @option ↑ @value 8
 * @option ← @value 4
 * @option → @value 6
 * @option ↓ @value 2
 *
 * @================================================
 * @command goXY @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 pointStr @text 移動先位置(タイル数)
 * @desc 移動先座標(小数点以下可)
 * @type string @default 0,0
 *
 * @arg isWait @text 完了までウェイト
 * @on 待つ(規定値) @off 完了を待たず並列実行
 * @type boolean @default true
 * 
 * @================================================
 * @command goEv @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 destinationId @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 pointStr @text 移動先位置(タイル数)
 * @desc 移動先座標(小数点以下可)
 * @type string @default 0,0
 *
 * @arg isWait @text 完了までウェイト
 * @on 待つ(規定値) @off 完了を待たず並列実行
 * @type boolean @default true
 *
 * @================================================
 * @command locateXY @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 pointStr @text 移動先位置(タイル数)
 * @desc 移動先座標(小数点以下可)
 * @type string @default 0,0
 * 
 * @arg patternNumber @text 歩行パターン
 * @desc
 *  パターンの列(規定値:そのまま)
 * @type select @default -1
 * @option そのまま @value -1
 * @option ↓・・ 左列 @value 0
 * @option ・↓・ 中央列 @value 1
 * @option ・・↓ 右列 @value 2
 *
 * @arg d @text キャラの向き
 * @desc (規定値: そのまま)
 * @type select @default 0
 * @option そのまま @value 0
 * @option ↑ @value 8
 * @option ← @value 4
 * @option → @value 6
 * @option ↓ @value 2
 *
 * @================================================
 * @command locateEv @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 destinationId @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 pointStr @text 相対座標(タイル数)
 * @desc 相対座標(小数点以下可)
 * @type string @default 0,0
 *
 * @arg patternNumber @text 歩行パターン
 * @desc
 *  パターンの列(規定値:そのまま)
 * @type select @default -1
 * @option そのまま @value -1
 * @option ↓・・ 左列 @value 0
 * @option ・↓・ 中央列 @value 1
 * @option ・・↓ 右列 @value 2
 *
 * @arg d @text キャラの向き
 * @desc (規定値: そのまま)
 * @type select @default 0
 * @option そのまま @value 0
 * @option ↑ @value 8
 * @option ← @value 4
 * @option → @value 6
 * @option ↓ @value 2
 *
 * @================================================
 * @command getOn @text 乗り物に乗る
 * @desc すでに乗っている、乗り物を設定してない、
 * 乗り物が現在のマップにない場合、動作しない。
 *
 * @arg eventId @text 対象乗り物
 * @desc
 * 規定値: 大型船(ship)
 * @type select @default ship
 * @option 小型船(boat) @value boat
 * @option 大型船(ship) @value ship
 * @option 飛行船(airship) @value airship
 *
 * @arg isVehiclePos @text 乗った後の位置
 * @desc
 * @type boolean @default true
 * @on 乗り物位置(規定値) @off プレイヤー位置
 * 
 * @================================================
 * @command getOff @text 乗り物から降りる
 * @desc 乗り物に乗っていない場合は動作しない。
 * 通常降りられない場所でも強制的に降りる。
 *
 * @arg d @text 降りる向き
 * @desc (規定値: 前に降りる)
 * @type select @default 0
 * @option 前に降りる @value 0
 * @option ↑ @value 8
 * @option ← @value 4
 * @option → @value 6
 * @option ↓ @value 2
 * @option その場 @value 5
 * 
 * @================================================
 * @command follow @text 隊列メンバーの追跡設定
 * @desc プレイヤーが動いた場合に追跡するか指定。
 * 
 * @arg eventId @text 隊列メンバーID
 * @desc 指定隊列メンバー(規定値:all)
 * @type select @default all
 * @option all @option follower0 @option follower1 @option follower2
 *
 * @arg isFollow @text 追跡するか
 * @desc ONは[向き固定]などの値をプレイヤーからコピーする。
 * @on 追跡する(規定値) @off 追跡しない
 * @type boolean @default true
 *
 * @================================================
 * @command anime @text アニメの指定
 * @desc アニメモード(移動アニメ停止・[すり抜け]ON)になるので、
 * [アニメの終了]を実行しておくこと。
 *
 * @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 pointStr @text 移動距離(ピクセル数)
 * @desc (小数点以下可)
 * @type string @default 0,0
 *
 * @arg wait @text ウェイト
 * @desc
 * 待ちフレーム(1/60秒)(規定値:0)
 * @type number @default 0
 *
 * @arg characterNumber @text キャラクター番号
 * @desc
 * [0123]
 * [4567] (規定値:-1 そのまま)
 * @type number @default -1
 * @min -1 @max 7
 *
 * @arg patternNumber @text 歩行パターン
 * @desc
 *  パターンの列(規定値:↓現在列)
 * @type select @default -1
 * @option ↓現在列 @value -1
 * @option ↓・・ 左列 @value 0
 * @option ・↓・ 中央列 @value 1
 * @option ・・↓ 右列 @value 2
 *
 * @arg d @text キャラの向き
 * @desc (規定値: そのまま)
 * @type select @default 0
 * @option そのまま @value 0
 * @option ↑ @value 8
 * @option ← @value 4
 * @option → @value 6
 * @option ↓ @value 2
 * 
 * @================================================
 * @command endAnime @text アニメの終了
 * @desc [アニメの指定]をするとアニメモード(移動アニメ停止・[すり抜け]ON)になるのでアニメ終了時に実行すること。
 *
 * @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
 * 
 */