H2A キャラにリージョンを辿って歩かせる - H2A_RegionWalker.js

シェア用テキスト：

▼H2A キャラにリージョンを辿って歩かせる（はどはど様作） - H2A_RegionWalker.js
https://plugin-mz.fungamemake.com/archives/7067
キャラクターがリージョンに沿って移動します。

ふりがな：きゃらにりーじょんをたどってあるかせる

機能概要： キャラクターがリージョンに沿って移動します。

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

作者：はどはど

作者サイト：https://had2apps.com/

解説ページ：https://had2apps.com/mvzp?pluginName=H2A_RegionWalker

ファイル名：H2A_RegionWalker.js

プラグインのヘルプ：

*:ja
 * @plugindesc キャラにリージョンを辿って歩かせる
 *
 * @target MZ
 * @author Had2Apps
 * @url https://github.com/katai5plate/RPGMakerPlugins
 *
 * @param isStrict
 * @text 厳格モード
 * @desc エラーによる強制終了と警告を有効にします。
 * @type boolean
 * @default true
 *
 * @param enableRandomWalk
 * @text ランダム歩行
 * @desc 移動経路が 2 方向以上ある場合、ランダムに決定します。
 * @type boolean
 * @default false
 *
 * @param addOneStep
 * @text 到着したら一歩前進
 * @desc 終端に辿り着いたら、一歩前進します。
 * @type boolean
 * @default false
 *
 * @command run
 * @text 実行
 * @desc リージョン ID の道が途切れるまで移動し続けます。
 *
 *   @arg regionId
 *   @text リージョン ID
 *   @desc ルート指定に使用するリージョン ID
 *   @type number
 *   @min 1
 *   @default 1
 *
 *   @arg characterId
 *   @text イベント ID
 *   @desc 移動する マップイベント ID (主人公: -1)
 *   @type number
 *   @min -1
 *   @default -1
 *
 *   @arg initDirection
 *   @text 歩き始める方角
 *   @desc どの方角を正面として歩き始めるかを設定します。
 *   @type select
 *
 *     @option 現在の向き
 *     @value -1
 *
 *     @option 下
 *     @value 2
 *
 *     @option 左
 *     @value 4
 *
 *     @option 右
 *     @value 6
 *
 *     @option 上
 *     @value 8
 *
 *   @default -1
 *
 *   @arg walkSpeed
 *   @text 移動速度
 *   @desc 歩くスピード
 *   @type select
 *
 *     @option 指定しない
 *     @value 0
 *
 *     @option 1: 1/8倍速
 *     @value 1
 *
 *     @option 2: 1/4倍速
 *     @value 2
 *
 *     @option 3: 1/2倍速
 *     @value 3
 *
 *     @option 4: 標準速
 *     @value 4
 *
 *     @option 5: 2倍速
 *     @value 5
 *
 *     @option 6: 4倍速
 *     @value 6
 *
 *   @default 0
 *
 *   @arg wait
 *   @text 完了までウェイト
 *   @desc 終端に辿りつくまでウェイトします。
 *   @type boolean
 *   @default true
 *
 *   @arg through
 *   @text すり抜ける
 *   @desc すり抜けを ON にします
 *   @type boolean
 *   @default false
 *
 *   @arg endSwitch
 *   @text 移動完了スイッチ
 *   @desc スイッチを指定すると、移動が終わったら自動で ON になります。
 *   @type switch
 *   @default 0
 *
 *   @arg beforeScripts
 *   @text スクリプト(初動)
 *   @desc (上級者向け機能) 任意の移動スクリプトを実行ルートの始めに追加します
 *   @type string[]
 *   @default []
 *
 *   @arg afterScripts
 *   @text スクリプト(末尾)
 *   @desc (上級者向け機能) 任意の移動スクリプトを実行ルートの末尾に追加します
 *   @type string[]
 *   @default []
 *
 * @command script
 * @text 移動スクリプト
 * @desc (上級者向け機能) 移動スクリプトを入力します。
 *
 *   @arg characterId
 *   @text イベント ID
 *   @desc 移動する マップイベント ID (主人公: -1)
 *   @type number
 *   @min -1
 *   @default -1
 *
 *   @arg walkSpeed
 *   @text 移動速度
 *   @desc 歩くスピード
 *   @type select
 *
 *     @option 指定しない
 *     @value 0
 *
 *     @option 1: 1/8倍速
 *     @value 1
 *
 *     @option 2: 1/4倍速
 *     @value 2
 *
 *     @option 3: 1/2倍速
 *     @value 3
 *
 *     @option 4: 標準速
 *     @value 4
 *
 *     @option 5: 2倍速
 *     @value 5
 *
 *     @option 6: 4倍速
 *     @value 6
 *
 *   @default 0
 *
 *   @arg wait
 *   @text 完了までウェイト
 *   @desc 終端に辿りつくまでウェイトします。
 *   @type boolean
 *   @default true
 *
 *   @arg through
 *   @text すり抜ける
 *   @desc すり抜けを ON にします
 *   @type boolean
 *   @default false
 *
 *   @arg endSwitch
 *   @text 移動完了スイッチ
 *   @desc スイッチを指定すると、移動が終わったら自動で ON になります。
 *   @type switch
 *   @default 0
 *
 *   @arg scripts
 *   @text スクリプト
 *   @desc 任意の移動スクリプト
 *   @type string[]
 *   @default []
 *
 * @command wait
 * @text 移動完了まで待つ
 * @desc スイッチが ON になるまでウェイトします。
 *
 *   @arg endSwitch
 *   @text 移動完了スイッチ
 *   @desc 「実行」で指定したスイッチ
 *   @type switch
 *   @default 1
 *
 * @help
 * キャラクターがリージョンに沿って移動します。
 * 真後ろには移動せず、前方から見て前・左・右にのみ動きます。
 *
 * ・「厳格モード」では、通行を妨げるタイルがあったり、
 * 　ランダム歩行が無効なのに一本道ではない場合に、
 * 　コンソールに警告を出したり、エラーでゲームを強制終了します。
 * ・「ランダム歩行」では、一本道でない道に来た時、
 * 　ランダムで方角を決定します。
 * ・通常、行き止まりに到達して立ち止まった時は、
 * 　終端のリージョンを踏んでいる状態になります。
 * 　そのため、到達時にリージョンの外まで歩かせたい場合は
 * 　「到着したら一歩前進」を有効化してください。
 * ・プラグインコマンドの「スクリプト」は、上級者向け機能です。
 *   `ROUTE_MOVE_DOWN` `ROUTE_WAIT 60`
 *   `ROUTE_CHANGE_IMAGE ”Actor1” 3`
 *   `ROUTE_PLAY_SE {”name”:”Dog”,”pan”:0,”pitch”:100,”volume”:90}`
 *   のように記述します。 (ROUTE_? arg1 arg2)
 *   ROUTE_ で始まる文は、rmmz_objects.js の
 *   processMoveCommand の定義を参照してください。
 *   ROUTE_ は省略しても構いません。 例: `WAIT 60`
 *   スペースで区切り、2 塊目からは JSON で値が評価されます。
 *   ROUTE_PLAY_SE のように JSON を引数に渡す場合はスペースを省いてください。
 *
 * [注意]
 * ・「移動完了まで待つ」場合、
 * 　経路の途中に通行を妨げるキャライベント等があると、
 * 　そのままゲームが先に進まなくなる可能性があります。
 *
 * Copyright (c) 2022 Had2Apps
 * This software is released under the MIT License.
 *
 * Version: v1.3.3
 * RPG Maker MZ Version: v1.1.1
 */