マップの部分的な入れ替え - MpiSwapArea.js

シェア用テキスト：

▼マップの部分的な入れ替え（奏ねこま（おとぶきねこま）様作） - MpiSwapArea.js
https://plugin.fungamemake.com/archives/13142
マップの内容を部分的に入れ替える機能を提供します。

ふりがな：まっぷのぶぶんてきないれかえ

機能概要： マップの内容を部分的に入れ替える機能を提供します。

利用規約（ライセンス）：
・著作権：保持
・商用利用：許可
・追加改変：許可
・再配布：禁止 （素材を利用した作品の配布は再配布に当たりません。）
・詳細はダウンロードページ・プラグイン内を確認

作者：奏ねこま（おとぶきねこま）

作者サイト：https://x.com/koma_neko

解説ページ：https://makonet.sakura.ne.jp/rpg_tkool/Old/

ファイル名：MpiSwapArea.js

プラグインのヘルプ：

/*:
 * @plugindesc マップの内容を部分的に入れ替える機能を提供します。
 * @author 奏ねこま（おとぶき ねこま）
 *
 * @param Disable Transfer Position Swapping Switch ID
 * @type switch
 * @desc 場所移動時、移動先の入れ替えを無効化するスイッチの番号を指定してください。
 * @default 0
 * 
 * @help
 * [説明]
 *  メモ欄に指定された条件に基づいて、マップの内容を部分的に入れ替えます。
 *  （制限事項あり。[制限事項]を参照）
 *
 * [プラグインパラメータ]
 *  Disable Transfer Position Swapping Switch ID
 *   場所移動時、移動先の入れ替えを無効化するスイッチの番号を指定します。
 * 
 *  - このパラメータで指定した番号のスイッチがOFFの場合（デフォルト） -
 *   場所移動によってプレイヤーが移動する先のエリアが他の場所と入れ替わっていた
 *   場合、移動先もそれに合わせて入れ替わります。例えば指定した移動先が(10,10)の
 *   とき、その位置が(20,20)と入れ替わっていた場合、移動先は(20,20)になります。
 * 
 *  - このパラメータで指定した番号のスイッチがONの場合 -
 *   エリアの入れ替わりに関わらず、指定した座標に移動します。例えば指定した移動
 *   先が(10,10)のとき、エリア入れ替え後のマップにおいても(10,10)に移動します。
 * 
 * [使用方法]
 *  マップのメモ欄に、入れ替え条件を指定したタグを記述します。
 * 
 * ----
 *  指定した二か所の範囲を入れ替えるタグ（複数記述可）
 *   <swap_area: x1, y1, width, height, x2, y2[, switchId]>
 * 
 *   例：x=5,y=10から横幅10マス、縦幅20マスを、x=20,y=25の場所と入れ替える
 *   <swap_area: 5, 10, 10, 20, 20, 25>
 * 
 *   例：スイッチ99番がONのとき、入れ替える
 *   <swap_area: 5, 10, 10, 20, 20, 25, 99>
 * 
 * ----
 *  マップを指定数で分割し、ランダムで入れ替えるタグ（複数記述可）
 *   <random_swap_area: rows, cols[, switchId]>
 * 
 *   例：マップ全体を縦4つ、横6つに分割し、分割したエリアをランダムで入れ替える
 *   <random_swap_area: 4, 6>
 * 
 *   例：スイッチ99番がONのとき、ランダムに入れ替える
 *   <random_swap_area: 4, 6, 99>
 * 
 * ----
 *  入れ替え状態に合わせて遠景画像も入れ替えるタグ
 *   <swap_area_parallax>
 * 
 *   遠景画像を一枚絵のマップ画像として使用している場合、上記タグを指定すること
 *   で入れ替え状態に合わせて遠景画像も入れ替わります。
 *  
 * ----
 *  座標や範囲、スイッチ番号には、変数を指定することもできます。
 *  v[変数番号]と記述することで、その変数の値が使用されます。
 * 
 *   例：入れ替え元座標、入れ替え範囲、入れ替え先座標、スイッチ番号を変数で指定
 *   <swap_area: v[1], v[2], v[3], v[4], v[5], v[6], v[7]>
 * 
 *   例：分割数、スイッチ番号を変数で指定
 *   <random_swap_area: v[1], v[2], v[3]>
 * 
 * [制限事項]
 *  座標などの指定に変数やスイッチを指定した場合、「変数やスイッチの最新の状態」
 *  がマップに反映されるのは、「別のマップからそのマップに移動してきたとき」にな
 *  ります。マップ表示中に変数やスイッチの状態を変更しても、別のマップから再びそ
 *  のマップに移動してくるまでは、表示に反映されません。同一マップ内での移動につ
 *  いても同様に反映されませんので、変数やスイッチの状態をすぐに反映させたい場合
 *  は「一度別のマップに移動してから戻ってくる処理」を入れるようにしてください。
 * 
 * [利用規約] ..................................................................
 *  - 本プラグインの利用は、RPGツクールMV/RPGMakerMVの正規ユーザーに限られます。
 *  - 商用、非商用、有償、無償、一般向け、成人向けを問わず、利用可能です。
 *  - 利用の際、連絡や報告は必要ありません。また、製作者名の記載等も不要です。
 *  - プラグインを導入した作品に同梱する形以外での再配布、転載はご遠慮ください。
 *  - 本プラグインにより生じたいかなる問題についても、一切の責任を負いかねます。
 * [改訂履歴] ..................................................................
 *   Version 1.02  2018/04/08  場所移動先の切り替え機能を追加。
 *   Version 1.01  2018/04/05  遠景画像の入れ替えに対応。
 *   Version 1.00  2018/04/01  First edition.
 * -+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
 *  Web Site: http://makonet.sakura.ne.jp/rpg_tkool/
 *  Twitter : https://twitter.com/koma_neko
 *  Copylight (c) 2018 Nekoma Otobuki
 */