テレポート、エスケープを実装します。 - SimpleTeleportation.js

シェア用テキスト：

▼テレポート、エスケープを実装します。（あわやまたな (Awaya_Matana)様作） - SimpleTeleportation.js
https://plugin-mz.fungamemake.com/archives/8503
テレポート、エスケープを実装します。

ふりがな：てれぽーと、えすけーぷをじっそうします。

機能概要： テレポート、エスケープを実装します。

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

作者：あわやまたな (Awaya_Matana)

解説ページ：https://awaya3ji.seesaa.net/article/512933454.html

ダウンロードページ：SimpleTeleportation.js

ファイル名：SimpleTeleportation.js

プラグインのヘルプ：

* @target MZ
* @orderAfter PluginCommonBase




* 登録した場所に移動できるテレポート、ダンジョンなどから脱出する為のエスケープが使用可能になります。
* [範囲]と[使用可能時]は自分でいい感じに変更してください。
*
* [使用効果]にコモンイベントが含まれていると、テレポートやエスケープが行われません。
* その代わり、プラグインコマンド[転送位置の取得]で変数に情報を取得できる為、
* 自分好みのテレポート/エスケープ演出が作れます。
*
* [メモ（アイテム/スキル）]
* <teleport> //使用効果[テレポート]
* <escape> //使用効果[エスケープ]
*
* [更新履歴]
* 2025/03/28：Ver.1.0.0　公開。
* 2025/04/01：Ver.1.0.1　プラグインコマンドでエリアIDを取得可能にしました。
* 2025/04/03：Ver.1.0.2　マップをリロードする機能を追加しました。
*
* @param areas
* @text エリア設定
* @desc エリア名を追加します。
* @type struct<areaSettings>[]
*
* @param seParams
* @text 効果音設定
* @desc スキル/アイテム使用時の効果音を設定します。
* システム効果音：空欄
* @default 
* @type struct<seParams>
*
* @param windowParams
* @text ウィンドウ設定
* @desc テレポート先を選択するウィンドウをカスタムします。
* @default {"skin":""，"opacity":"-1"，"overlap":"false"，"maxCols":"2"，"colSpacing":"16"，"rect":"2000"，"useNumLines":"false"，"forceOpen":"true"}
* @type struct<windowParams>
*
* @param inVehicle
* @text 乗り物の中
* @desc 乗り物の中で使える。
* @type boolean
* @default false
*
* @param requestMapReload
* @text マップのリロードを要求
* @desc 現在のマップを対象にテレポートした場合、マップやイベントの状態を初期化します。
* @type boolean
* @default true
*
* @command addTeleportationPoint
* @text テレポート位置の追加
* @arg location
* @text 場所
* @type location
* @default {"mapId":"1"，"x":"0"，"y":"0"}
* @arg areaId
* @text エリアID
* @desc 同じマップに異なる位置を追加したい場合に使います。
* @type number
* @default 0
* @arg switchId
* @text スイッチID
* @default 0
* @type switch
*
* @command removeTeleportationPoint
* @text テレポート位置の削除
* @arg mapId
* @text マップID
* @type map
* @default 1
* @arg areaId
* @text エリアID
* @type number
* @default 0
*
* @command setEscapeLocation
* @text エスケープ位置の設定
* @arg location
* @text 場所
* @type location
* @default {"mapId":"1"，"x":"0"，"y":"0"}
* @arg switchId
* @text スイッチID
* @default 0
* @type switch
*
* @command removeEscapeLocation
* @text エスケープ位置の削除
*
* @command setTeleportationAccess
* @text テレポート禁止の変更
* @arg operation
* @text 操作
* @type select
* @default Disable
* @option 禁止
* @value Disable
* @option 許可
* @value Enable
*
* @command setEscapeAccess
* @text エスケープ禁止の変更
* @arg operation
* @text 操作
* @type select
* @default Disable
* @option 禁止
* @value Disable
* @option 許可
* @value Enable
*
* @command setAreaAccess
* @text エリアの禁止設定
* @desc 特定のエリアにテレポート出来なくします。
* @arg mapId
* @text マップID
* @type map
* @default 1
* @arg areaId
* @text エリアID
* @desc 全てのエリア：-1
* @type number
* @default -1
* @min -1
* @arg operation
* @text 操作
* @type select
* @default Disable
* @option 禁止
* @value Disable
* @option 許可
* @value Enable
*
* @command getTransferLocation
* @text 転送位置の取得
* @desc 変数に移動先の情報を格納します。
* コモンイベントに使用してください。
* @arg mapId
* @text [マップID]
* @type variable
* @default 1
* @arg x
* @text [X座標]
* @type variable
* @default 1
* @arg y
* @text [Y座標]
* @type variable
* @default 1
*
* @command getTransferArea
* @text 転送エリアの取得
* @desc 変数にエリアIDを格納します。
* コモンイベントに使用してください。
* @arg areaId
* @text [エリアID]
* @type variable
* @default 1
*