ファストトラベル - NUUN_FastTravel.js

シェア用テキスト：

▼ファストトラベル（NUUN様作） - NUUN_FastTravel.js
https://plugin-mz.fungamemake.com/archives/7861
ファストトラベル

ふりがな：ふぁすととらべる

機能概要： ファストトラベル

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

作者：NUUN

ダウンロードページ：https://raw.githubusercontent.com/nuun888/MZ/refs/heads…

ファイル名：NUUN_FastTravel.js

プラグインのヘルプ：

* @target MZ
 * @plugindesc ファストトラベル
 * @author NUUN
 * @base NUUN_Base
 * @orderAfter NUUN_Base
 * @version 1.1.1
 * 
 * @help
 * ファストトラベルを実装します。
 * 
 * ファストトラベル用のマップの設定
 * マップの設定のメモ欄に<FastTravelMap:[id]>を記入します。
 * 
 * ファストトラベルの設定
 * イベントIDにマップで設定したイベントIDを記入します。(IDまたはイベント名)
 * 選択後イベント起動をONにしている場合は、イベントIDで指定したイベントが実行されます。
 * OFFにしている場合は移動先マップID、座標を指定します。
 * 
 * ファストトラベル用マップへの移動
 * イベントコマンドの場所移動、またはプラグインパラメータでファストトラベル用マップに移動します。
 * キャンセルはプラグインパラメータから実行のみ有効になります。
 * 
 * 
 * マップのメモ欄
 * <FastTravelMap:[id]> このタグが付けられたマップはファストトラベルマップとなります。
 * [id]:ファストトラベル設定のリスト番号
 * 
 * スクリプト
 * $gameMap.openFastTravel([id]， [x]， [y]);
 * [id]:移動先マップID
 * [x]:移動先X座標
 * [y]:移動先Y座標
 * 
 *  
 * 利用規約
 * このプラグインはMITライセンスで配布しています。
 * 無償、有償ゲーム問わずご利用いただけます。
 * 
 * 
 * 更新履歴
 * 2025/5/17 Ver.1.1.1
 * NUUN_MenuParamListBaseを導入しないとエラーが出るため別プラグイン化
 * 2025/4/13 Ver.1.1.0
 * サブウィンドウを実装。(別プラグイン化)
 * 2025/3/1 Ver.1.0.4
 * アノテーションlocationに対応。(1.8以前のバージョンは従来の方式)
 * 2024/9/22 Ver.1.0.3
 * カーソルの初期位置のスクロールの挙動を修正。
 * 2024/9/21 Ver.1.0.2
 * ヘルプウィンドウ、ファストトラベルウィンドウのウィンドウが透明化しない問題を修正。
 * カーソルの初期インデックスを移動先の座標から一番近いイベントのインデックスになるように修正。
 * カーソルの初期インデックスを指定のインデックスにする機能を追加。
 * 2024/8/18 Ver.1.0.1
 * 移動先の向きを指定できる機能を追加。
 * 選択できない場所にスクロールしないように修正。
 * 戻るボタンを追加。(プラグインコマンドから実行時のみ)
 * 2024/8/17 Ver.1.0.0
 * 初版
 * 
 * 
 * @command FastTravelOpen
 * @desc ファストトラベルを開きます。
 * @text ファストトラベル開く
 * 
 * @arg MapId
 * @text マップID
 * @type number
 * @default 0
 * @desc マップIDを指定します。
 * 
 * @arg MapX
 * @text 移動先X座標
 * @type number
 * @default 0
 * @desc 移動先のX座標を指定します。
 * 
 * @arg MapY
 * @text 移動先Y座標
 * @type number
 * @default 0
 * @desc 移動先のY座標を指定します。
 * 
 * 
 * @command FastTravelSelectIndex
 * @desc ファストラベルの初期カーソルインデックスを指定します。移動後に初期化されます。
 * @text ファストラベル初期カーソルインデックス
 * 
 * @arg FastTravelListId
 * @text カーソルインデックス
 * @type number
 * @default -1
 * @min -1
 * @desc カーソルインデックスを記入します。
 * 
 * @param FastTravelSetting
 * @desc ファストトラベルの設定をします。
 * @text ファストトラベル設定
 * @type struct<fastTravelSetting>[]
 * @default 
 * 
 * @param TransferEventTrigger
 * @text 選択後イベント起動
 * @desc 移動先マップ選択後に対象のイベントを起動します。
 * @type boolean
 * @default true
 * 
 * @param NoDisplayUnregisteredLocation
 * @text 未登録場所非表示
 * @desc 条件に一致しない場所を表示しない。
 * @type boolean
 * @default false
 * 
 * @param MapUnknownData
 * @desc 未登録の文字列です。？1文字だけ入れると名前の文字数に応じて？に置き換えられます。
 * @text 条件不一致時文字列
 * @type string
 * @default ？
 * 
 * @param ScrollSpeed
 * @desc スクロールスピードを設定します。
 * @text スクロールスピード
 * @type number
 * @default 20
 * 
 * @param CharacterSetting
 * @text キャラクターチップ設定
 * @default ------------------------------
 * 
 * @param FastTravelCharacterName
 * @text キャラチップ画像
 * @desc ファストラベル中のキャラチップの画像。
 * @type file
 * @dir img/characters/
 * @default 
 * 
 * @param FastTravelCharacterIndex
 * @text キャラチップインデックスID
 * @desc ファストラベル中のキャラチップのインデックスID。
 * @type number
 * @default 0
 * 
 * @param HelpWindowSetting
 * @text ヘルプウィンドウ設定
 * @default ------------------------------
 * 
 * @param HelpWindowX
 * @text ヘルプウィンドウX座標
 * @desc ヘルプウィンドウのX座標
 * @type number
 * @default 0
 * @min -9999
 * @parent HelpWindowSetting
 * 
 * @param HelpWindowY
 * @desc ヘルプウィンドウのY座標
 * @text ヘルプウィンドウY座標
 * @type number
 * @default 0
 * @min -9999
 * @parent HelpWindowSetting
 * 
 * @param HelpWindowWidth
 * @desc ヘルプウィンドウの横幅。
 * @text ヘルプウィンドウ横幅
 * @type number
 * @default 0
 * @min 0
 * @parent HelpWindowSetting
 * 
 * @param HelpWindowVisible
 * @text ヘルプウィンドウ不透明化
 * @desc ヘルプウィンドウを不透明化する。
 * @type boolean
 * @default true
 * @parent HelpWindowSetting
 * 
 * @param FastTravelWindowSetting
 * @text ファストトラベルウィンドウ設定
 * @default ------------------------------
 * 
 * @param FastTravelWindowX
 * @text ファストトラベルウィンドウX座標
 * @desc ファストトラベルウィンドウのX座標
 * @type number
 * @default 0
 * @min -9999
 * @parent FastTravelWindowSetting
 * 
 * @param FastTravelWindowY
 * @desc ファストトラベルウィンドウのY座標
 * @text ファストトラベルウィンドウY座標
 * @type number
 * @default 68
 * @min -9999
 * @parent FastTravelWindowSetting
 * 
 * @param FastTravelWindowWidth
 * @desc ファストトラベルウィンドウの横幅。
 * @text ファストトラベルウィンドウ横幅
 * @type number
 * @default 240
 * @min 0
 * @parent FastTravelWindowSetting
 * 
 * @param FastTravelWindowRows
 * @desc ファストトラベルウィンドウの行数。
 * @text ファストトラベルウィンドウ行数
 * @type number
 * @default 10
 * @min 1
 * @parent FastTravelWindowSetting
 * 
 * @param FastTravelWindowVisible
 * @text ファストトラベルウィンドウ不透明化
 * @desc ファストトラベルウィンドウを不透明化する。
 * @type boolean
 * @default true
 * @parent FastTravelWindowSetting
 * 
 * @param ButtonSetting
 * @text ボタン設定
 * @default ------------------------------
 * 
 * @param ButtonAbsoluteCoordinates
 * @text ボタン絶対座標
 * @desc ボタンの座標を絶対座標にします。
 * @type boolean
 * @default false
 * @parent ButtonSetting
 * 
 * @param ButtonX
 * @text キャンセルボタンX座標
 * @desc キャンセルボタンのX座標
 * @type number
 * @default 0
 * @min -9999
 * 
 * @parent ButtonSetting
 * 
 * @param ButtonY
 * @desc キャンセルボタンのY座標
 * @text キャンセルボタンY座標
 * @type number
 * @default 0
 * @min -9999
 * @parent ButtonSetting
 *