マップ画面の視界制限フィルタープラグイン - SpotVisibleFilter.js

シェア用テキスト：

▼マップ画面の視界制限フィルタープラグイン（村人Ａ様作） - SpotVisibleFilter.js
https://plugin-mz.fungamemake.com/archives/8662
マップ画面の視界制限フィルタープラグイン

ふりがな：まっぷがめんのしかいせいげんふぃるたーぷらぐいん

機能概要： マップ画面の視界制限フィルタープラグイン

利用規約（ライセンス）：https://www.rpgmaker-script-wiki.xyz/kiyaku.php

作者：村人Ａ

作者サイト：https://www.rpgmaker-script-wiki.xyz/index.php

解説ページ：https://rpgmaker-script-wiki.xyz/SpotVisibleFilter_mzpl…

ファイル名：SpotVisibleFilter.js

プラグインのヘルプ：

* @target MZ
 * @plugindesc マップ画面に、特定範囲以外を見えなくする「視界制限」フィルター効果を付加します。
 * @author 村人Ａ
 *
 * @command switchFilter
 * @text フィルターのON
 * @desc フィルターを適用・開始します。指定範囲でプレイヤー周囲以外が見えなくなります。
 *
 * @arg range
 * @text 見える範囲
 * @desc 全範囲=100を基準として、0~100の値で可視範囲を指定します。
 * 0に近いほど視界が狭く、100で画面全域が見える状態になります。
 * @default 10
 * @type number
 * @max 100
 * @min 0
 *
 * @command offFilter
 * @text フィルターのOFF
 * @desc 適用中のフィルターを解除し、通常表示に戻します。
 *
 * @help
 * ============================================================================
 * 概要
 * ============================================================================
 * このプラグインは、マップ画面上でプレイヤーが立っている位置周辺のみが
 * 見えるようなフィルター効果を付加します。  
 * 「フィルターのON」コマンドで視界範囲（0~100）を指定すると、
 * プレイヤー周囲のみ明るく表示され、それ以外の部分は暗く（表示されず）
 * なります。  
 * 「フィルターのOFF」コマンドを実行すればフィルターが解除され、マップ全域が
 * 通常通り表示されます。
 *
 * この機能を利用して、暗がりでの探索や視界制限付きのマップ演出が可能です。
 *
 * ============================================================================
 * プラグインコマンド
 * ============================================================================
 * ### フィルターのON 
 * マップ上に視界制限フィルターを適用します。
 * 
 * - **見える範囲（range）**  
 *   0～100で指定し、0に近いほど視野が狭く、100で画面全域可視となります。
 *
 * 例：  
 * 「range: 10」 → プレイヤー周囲のみ小さな範囲が見える  
 * 「range: 100」 → 実質フィルターなし（画面全域が見える）
 *
 * ### フィルターのOFF
 * 適用中の視界制限フィルターを解除します。
 * フィルターが外れ、通常通りにマップ全体が表示されるようになります。
 *
 * ============================================================================
 * 使い方
 * ============================================================================
 * 1. **プラグイン導入**  
 *    プラグインマネージャーで「villaA_SpotVisibleFilter.js」を有効にしてください。
 *
 * 2. **視界制限の適用**  
 *    イベントコマンド「プラグインコマンド」で「フィルターのON」を選び、
 *    見える範囲を指定します。  
 *    これでプレイヤー付近のみが表示されるようになります。
 *
 * 3. **フィルター解除**  
 *    再び「プラグインコマンド」で「フィルターのOFF」を実行すれば、
 *    フィルターが外れ、通常表示に戻ります。
 *
 * 例：
 * ```
 * ◆プラグインコマンド：villaA_SpotVisibleFilter， フィルターのON
 * ：range: 10
 * （プレイヤー付近のみ視界が通るフィルター適用）
 *
 * --- イベント進行後 ---
 *
 * ◆プラグインコマンド：villaA_SpotVisibleFilter， フィルターのOFF
 * （再びマップ全域が見える状態に戻る）
 * ```
 *
 * ============================================================================
 * 注意事項
 * ============================================================================
 * - フィルター適用中は描画負荷が増える可能性があります。
 * - 他の描画系プラグインやフィルターとの併用時は動作確認を行ってください。
 *
 * ============================================================================
 * 不具合報告
 * ============================================================================
 * 不具合はXやメールで報告してください。
 * Xアカウント：＠rpgmaker_villaA
 * メール：villaa.contact＠gmail.com
 *