イベントコマンドの「場所移動」を拡張した、 - YKNR_MZ_TransferToEvent.js

シェア用テキスト：

▼イベントコマンドの「場所移動」を拡張した、（焼きノリ様作） - YKNR_MZ_TransferToEvent.js
https://plugin-mz.fungamemake.com/archives/8476
イベントコマンドの「場所移動」を拡張した、

ふりがな：いべんとこまんどの「ばしょいどう」をかくちょうした、

機能概要： イベントコマンドの「場所移動」を拡張した、

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

作者：焼きノリ

作者サイト：https://github.com/Yakinori0424/RPGMakerMVPlugins/blob/master/plugins/YKNR_TransferToEvent/YKNR_MZ_TransferToEvent.js

解説ページ：https://github.com/Yakinori0424/RPGMakerMVPlugins/tree/…

ダウンロードページ：https://raw.githubusercontent.com/Yakinori0424/RPGMaker…

ファイル名：YKNR_MZ_TransferToEvent.js

プラグインのヘルプ：

@help YKNR_MZ_TransferToEvent.js (Version : 1.1.0)
 * ----------------------------------------------------------------------------
 * 【！注意！】
 * ※共通プラグイン「YKNR_MZ_Core.js」のバージョン(1.2.1)以降でのみ対応。
 * ※ツクールMZ本体のバージョン(1.9.0)以降でのみ対応。
 * ----------------------------------------------------------------------------
 *【機能紹介】
 * 通常のイベントコマンドの「場所移動」は
 * ・マップID
 * ・X座標
 * ・Y座標
 * ・向き
 * ・フェード
 * を指定して移動処理を行いますが、本プラグインは
 * ・マップID
 * ・イベントID
 * ・向き
 * ・フェード
 * を指定して移動処理を行い、そのイベントと同じ位置に移動する機能を提供します。
 * 
 * これにより、例えば
 * 通常ではゲームの作成途中でマップの形状を調整すると、
 * そのマップへ移動する全イベントをチェック/移動座標の修正が必要になりますが、
 * 本プラグインの機能を利用することで
 * そのマップ上のイベント位置を調整するだけで済むようになります。
 * 
 * あとはおまけ機能として、
 * 通常のイベントコマンド「場所移動」の移動時も含めて、
 * 指定された座標から±nマスずれた位置に移動する設定も可能となります。
 * 扉イベントの位置に移動させたいけど、
 * 扉と重なった位置に移動するのは違和感があるといった場合に有効です。
 * 
 * ----------------------------------------------------------------------------
 *【プラグインコマンド】
 * -------------------------------------
 * 「イベント位置へ場所移動」
 * -------------------------------------
 * マップIDとイベントIDを指定して場所移動を行います。
 * 向きとフェードはイベントコマンド「場所移動」と同様に設定できるほか、
 * イベント位置から何マスずらした位置に移動するかの設定ができます。
 * 
 * -------------------------------------
 * 「現在のマップのイベント位置へ場所移動」
 * -------------------------------------
 * イベントIDを指定して場所移動を行います。
 * こちらは現在のマップにある任意のイベントに移動させるため、
 * マップIDの指定は省略されています。
 * それ以外の設定については、「イベント位置へ場所移動」と同じです。
 * 
 * 
 * ----------------------------------------------------------------------------
 * ※以下、スクリプトわかる方向け
 * ----------------------------------------------------------------------------
 * 
 * -------------------------------------
 * // 任意のマップの任意のイベントへ「場所移動」
 * // ($gamePlayer.reserveTransfer の代わりに使用します).
 * $gamePlayer.reserveTransferToEvent(mapId， eventId， direction， fadeType);
 * -------------------------------------
 * // 「場所移動」での転送先を指定マス分ずらす.
 * // $gamePlayer.reserveTransfer や $gamePlayer.reserveTransferToEvent
 * // と併用して呼び出す必要があります.
 * const ox = 1; // 左右へのずらすマス数. マイナスで左方向， プラスで右方向です.
 * const oy = 1; // 上下へのずらすマス数. マイナスで上方向， プラスで下方向です.
 * $gamePlayer.reserveTransferOffset(ox， oy);
 * -------------------------------------
 * // イベントコマンドの「スクリプト」から実行する例.
 * const mapId = 1;
 * const eventId = 1;
 * const direction = 0;
 * const fadeType = 0;
 * const ox = 0;
 * const oy = 1;
 * $gamePlayer.reserveTransferToEvent(mapId， eventId， direction， fadeType);
 * $gamePlayer.reserveTransferOffset(ox， oy);
 * this.setWaitMode("transfer");
 * -------------------------------------