//=============================================================================
// NearEventSensor.js
// ----------------------------------------------------------------------------
// (C)2015 Triacontane
// This software is released under the MIT License.
// http://opensource.org/licenses/mit-license.php
// ----------------------------------------------------------------------------
// Version
// 4.1.0 2025/02/17 パフォーマンスを改善するプラグイン設定を追加
// 4.0.1 2025/01/02 直前の修正でフラッシュが点滅せず光り続ける動作になっていた問題を修正
// 4.0.0 2024/11/11 後方互換性のために残しておいたタグ設定の実装を削除
//                  センサー条件にセルフスイッチを追加
// 3.7.1 2024/02/04 詳細タグが指定されていた場合は、必ずその設定を利用するよう修正
// 3.7.0 2024/01/04 後方互換性のために残しておいたタグ設定の説明をヘルプから削除（実装は残ります）
// 3.6.0 2023/11/02 3.5.0で追加した機能で、イベントごとに異なるスイッチ、セルフスイッチを指定できる機能を追加
// 3.5.0 2023/10/23 検知範囲に入ったときにONになるスイッチ、セルフスイッチを指定できる機能を追加
// 3.4.0 2022/06/03 イベントごと、ページごとにフキダシや感知距離、範囲を変えられる設定を追加
// 3.3.0 2022/06/03 イベント感知の距離を上下左右で個別に指定できる機能を追加
// 3.2.1 2021/06/01 フラッシュとフキダシの無効設定のメモタグが正常に機能していなかった問題を修正
// 3.2.0 2021/01/27 MZで動作するよう修正
// 3.1.1 2020/07/05 3.1.0の修正をイベント開始時にも適用できるよう変更
// 3.1.0 2020/07/05 イベントから離れたらエフェクトを即時消去できる設定を追加
// 3.0.0 2020/05/26 センサーエフェクトをイベントではなくプレイヤーに適用できる機能を追加。パラメータの再設定が必要です。
// 2.2.0 2018/11/05 フキダシの表示完了までウェイトするかどうかの設定を追加
// 2.1.1 2018/11/05 マップ移動時にすでに検知範囲内に入っていたイベントについて、一度範囲外に出ないと反応しない問題を修正
// 2.1.0 2017/10/23 特定のスイッチもしくはセルフスイッチが有効なときのみ感知エフェクトを出す機能を追加
//                  パラメータの型指定機能に対応
// 2.0.0 2016/08/27 フラッシュの代わりにフキダシアイコンを利用できる機能を追加
//                  パラメータ名等に一部破壊的な変更が加わっています。
// 1.1.0 2016/07/14 各種パラメータとメモ欄で感知可否の設定を追加
// 1.0.1 2015/11/01 既存コードの再定義方法を修正（内容に変化なし）
// 1.0.0 2015/10/31 初版
// ----------------------------------------------------------------------------
// [Blog]   : https://triacontane.blogspot.jp/
// [X]      : https://x.com/triacontane/
// [GitHub] : https://github.com/triacontane/
//=============================================================================

/*:
@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/NearEventSensor.js
@plugindesc Peripheral Event Detection Plugin
@author Triacontane
@license MIT License

@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help,
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/triacontane-MZ-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----

NearEventSensor.js

Detects nearby events and applies effects to them.
Improves usability by informing the player of actionable events.
Enter the detection settings in the "Detailed Settings List" parameter,
and enter the following in the event's memo field.
<NESDetail:sensor01> # Apply settings for identifier [sensor01]
<NESDetail:sensor01> # Same as above

This plugin requires the base plugin "PluginCommonBase.js."
"PluginCommonBase.js" is located in the following folder under the RPG Maker
MZ installation folder:
dlc/BasicResources/plugins/official

Terms of Use:
You may modify and redistribute this plugin without permission, and there are
no restrictions on its use (commercial, R18, etc.).
This plugin is now yours.

@param DetailList
@text Settings List
@desc This is a list of speech bubble settings.
@type struct<Detail>[]
@default []

@param DisableEmpty
@text Empty events are disabled
@desc If the event content is empty, it will not be detected. (ON/OFF)
@type boolean
@default true

@param FlashDuration
@text Flash Time
@desc The number of frames to flash.
@type number
@default 60

@param BalloonInterval
@text Speech bubble spacing
@desc The number of frames between displaying the balloon.
@type number
@default 15

@param WaitForBalloon
@text Wait until the balloon is complete
@desc If you stay within the range, continuous speech bubbles will be displayed, and the next speech bubble will be displayed after waiting for the previous one to finish displaying.
@type boolean
@default true

@param ConsiderationDir
@text Considering Orientation
@desc Only enable the effect if the player is facing the event.
@type boolean
@default false

@param ApplyPlayer
@text Applies to players
@desc Apply detection effects to the player instead of the target event.
@type boolean
@default false

@param EraseWhenAway
@text Delete when you leave
@desc Remove the effect when you leave the event.
@type boolean
@default false

@param performanceOption
@text Performance Settings
@desc When enabled, control characters cannot be used in parameters, but performance may improve.
@type boolean
@default false
*/

/*~struct~Color:
@param Red
@desc Red information (0-255)
@type number
@default 255
@min 0
@max 255

@param Green
@desc Green information (0-255)
@type number
@default 255
@min 0
@max 255

@param Blue
@desc Blue information (0-255)
@type number
@default 255
@min 0
@max 255

@param Alpha
@desc Strength information (0-255)
@type number
@default 255
@min 0
@max 255
*/

/*~struct~Range:
@param Left
@text Number of squares left
@desc Number of squares to the left
@type number
@default 0

@param Right
@text Number of squares to the right
@desc Number of squares to the right
@type number
@default 0

@param Up
@text Number of squares above
@desc Number of squares upwards
@type number
@default 0

@param Down
@text Number of squares below
@desc Number of squares downwards
@type number
@default 0
*/

/*~struct~Detail:
@param Id
@text identifier
@desc The setting identifier. Note that if left empty it will apply to all events.
@default sensor01

@param Page
@text Page Conditions
@desc It will be enabled when the event page is the specified value. If you specify 0, it will be enabled on all pages.
@type number
@default 0

@param Switch
@text Switch Condition
@desc It is enabled when the specified switch is ON. If you specify 0, it is always enabled.
@type switch
@default 0

@param SelfSwitch
@text Self-switching conditions
@desc It is enabled when the specified self switch is ON. If not specified, it is always enabled.
@type select
@option A
@option B
@option C
@option D

@param Reverse
@text Conditional inversion
@desc The sensor is activated when various conditions are not met.
@type boolean
@default false

@param SensorDistance
@text Sensing distance
@desc The distance at which the event is detected.
@type number
@default 2

@param SensorRange
@text Detection range
@desc Set the range of event detection in detail up, down, left, and right.
@type struct<Range>
@default {}

@param Balloon
@text speech bubble
@desc When detected, a speech bubble icon will automatically appear on the event.
@type select
@default 0
@option none
@value 0
@option Surprise
@value 1
@option Hatena
@value 2
@option note
@value 3
@option heart
@value 4
@option anger
@value 5
@option sweat
@value 6
@option crumpled
@value 7
@option silence
@value 8
@option light bulb
@value 9
@option Zzz
@value 10
@option User-defined 1
@value 11
@option User-defined 2
@value 12
@option User-defined 3
@value 13
@option User-defined 4
@value 14
@option User-defined 5
@value 15

@param FlashColor
@text Flash Color
@desc This is the flash color when detected. Please specify in the order of R (red), G (green), B (blue), A (strength).
@type struct<Color>

@param SensorSelfSwitch
@text Sensor Self Switch
@desc It is a self-switch that automatically turns on when it senses something and turns off when it moves away.
@type select
@option A
@option B
@option C
@option D

@param SensorSwitch
@text Sensor switch
@desc This switch automatically turns on when it detects something and turns off when it moves away.
@type switch
@default 0
*/

/*:ja
@plugindesc 周辺イベント感知プラグイン
@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/NearEventSensor.js
@base PluginCommonBase
@author トリアコンタン

@param DetailList
@text 設定リスト
@desc フキダシの設定リストです。
@default []
@type struct<Detail>[]

@param DisableEmpty
@text 空イベントは無効
@desc イベント内容が空の場合、感知しなくなります。(ON/OFF)
@default true
@type boolean

@param FlashDuration
@text フラッシュ時間
@desc フラッシュさせるフレーム数です。
@default 60
@type number

@param BalloonInterval
@text フキダシ間隔
@desc フキダシを表示する間隔のフレーム数です。
@default 15
@type number

@param WaitForBalloon
@text フキダシ完了までウェイト
@desc 範囲内に居続けた場合の連続フキダシ表示で、フキダシの表示が終わるのを待ってから次のフキダシの表示します。
@default true
@type boolean

@param ConsiderationDir
@text 向きを考慮
@desc プレイヤーがイベントの方を向いている場合のみエフェクトを有効にします。
@default false
@type boolean

@param ApplyPlayer
@text プレイヤーに適用
@desc 感知時のエフェクトを対象イベントではなくプレイヤーに対して適用します。
@default false
@type boolean

@param EraseWhenAway
@text 離れたら消去
@desc イベントから離れたらエフェクトを消去します。
@default false
@type boolean

@param performanceOption
@text パフォーマンス設定
@desc 有効にするとパラメータに制御文字が使えなくなりますが、パフォーマンスが改善する可能性があります。
@default false
@type boolean

@help NearEventSensor.js

周囲に存在するイベントを感知してイベントにエフェクトを発生させます。
実行可能なイベントをプレイヤーに伝えてユーザビリティを向上させます。
パラメータ「詳細設定リスト」で感知設定を入力し、
イベントのメモ欄に以下の通り入力します。
<NES詳細:sensor01>    # 識別子[sensor01]の設定を適用
<NESDetail:sensor01> # 同上

このプラグインの利用にはベースプラグイン『PluginCommonBase.js』が必要です。
『PluginCommonBase.js』は、RPGツクールMZのインストールフォルダ配下の
以下のフォルダに格納されています。
dlc/BasicResources/plugins/official

利用規約：
 作者に無断で改変、再配布が可能で、利用形態（商用、18禁利用等）
 についても制限はありません。
 このプラグインはもうあなたのものです。
*/

/*~struct~Color:ja
@param Red
@desc 赤色の情報です。(0-255)
@type number
@min 0
@max 255
@default 255

@param Green
@desc 緑色の情報です。(0-255)
@type number
@min 0
@max 255
@default 255

@param Blue
@desc 青色の情報です。(0-255)
@type number
@min 0
@max 255
@default 255

@param Alpha
@desc 強さの情報です。(0-255)
@type number
@min 0
@max 255
@default 255
*/

/*~struct~Range:ja
@param Left
@text 左マス数
@desc 左方向のマス数
@type number
@default 0

@param Right
@text 右マス数
@desc 右方向のマス数
@type number
@default 0

@param Up
@text 上マス数
@desc 上方向のマス数
@type number
@default 0

@param Down
@text 下マス数
@desc 下方向のマス数
@type number
@default 0
*/

/*~struct~Detail:ja
@param Id
@text 識別子
@desc 設定の識別子です。空にした場合、すべてのイベントに適用されるので注意してください。
@default sensor01

@param Page
@text ページ条件
@desc イベントページが指定した値のときに有効になります。0を指定すると全ページで有効になります。
@default 0
@type number

@param Switch
@text スイッチ条件
@desc 指定したスイッチがONのときに有効になります。0を指定すると常に有効になります。
@default 0
@type switch

@param SelfSwitch
@text セルフスイッチ条件
@desc 指定したセルフスイッチがONのときに有効になります。指定しない場合は常に有効になります。
@default
@type select
@option
@option A
@option B
@option C
@option D

@param Reverse
@text 条件反転
@desc 各種条件を"満たさない場合"にセンサーが有効になります。
@default false
@type boolean

@param SensorDistance
@text 感知距離
@desc イベントを感知する距離です。
@default 2
@type number

@param SensorRange
@text 感知範囲
@desc イベントを感知する範囲を上下左右で細かく設定します。
@default {}
@type struct<Range>

@param Balloon
@text フキダシ
@desc 感知時にイベントに自動でフキダシアイコンを出します。
(1:びっくり 2:はてな 3:音符 4:ハート 5:怒り....)
@default 0
@type select
@option なし
@value 0
@option びっくり
@value 1
@option はてな
@value 2
@option 音符
@value 3
@option ハート
@value 4
@option 怒り
@value 5
@option 汗
@value 6
@option くしゃくしゃ
@value 7
@option 沈黙
@value 8
@option 電球
@value 9
@option Zzz
@value 10
@option ユーザ定義1
@value 11
@option ユーザ定義2
@value 12
@option ユーザ定義3
@value 13
@option ユーザ定義4
@value 14
@option ユーザ定義5
@value 15

@param FlashColor
@text フラッシュカラー
@desc 感知時のフラッシュ色です。R(赤),G(緑),B(青),A(強さ)の順番で指定してください。
@default
@type struct<Color>

@param SensorSelfSwitch
@text センサーセルフスイッチ
@desc 感知したときに自動でONになるセルフスイッチです。離れたらOFFになります。
@default
@type select
@option A
@option B
@option C
@option D

@param SensorSwitch
@text センサースイッチ
@desc 感知したときに自動でONになるスイッチです。離れたらOFFになります。
@default 0
@type switch
*/

(function() {
    'use strict';
    const script = document.currentScript;
    const param = PluginManagerEx.createParameter(script);
    if (!param.DetailList) {
        param.DetailList = [];
    }
    if (param.performanceOption) {
        param.DetailList = param.DetailList.map(detail => {
            const data = {};
            const prevData = detail._parameter;
            for (const key in prevData) {
                data[key] = prevData[key];
            }
            return data;
        });
    }

    //=============================================================================
    // Sprite_Character
    //  キャラクターのフラッシュ機能を追加定義します。
    //=============================================================================
    const _Sprite_CharacterUpdate       = Sprite_Character.prototype.update;
    Sprite_Character.prototype.update = function() {
        _Sprite_CharacterUpdate.call(this);
        this.updateFlash();
    };

    Sprite_Character.prototype.updateFlash = function() {
        if (this._character.isFlash()) {
            this.setBlendColor(this._character._flashColor);
        }
    };

    const _Sprite_Character_updateBalloon = Sprite_Character.prototype.updateBalloon;
    Sprite_Character.prototype.updateBalloon = function() {
        if (this._character.isBalloonCancel()) {
            this._character.endBalloon();
        }
        _Sprite_Character_updateBalloon.apply(this, arguments);
    };

    //=============================================================================
    // Game_CharacterBase
    //  キャラクターのフラッシュ機能を追加定義します。
    //=============================================================================
    const _Game_CharacterBaseInitMembers       = Game_CharacterBase.prototype.initMembers;
    Game_CharacterBase.prototype.initMembers = function() {
        _Game_CharacterBaseInitMembers.call(this);
        this._flashColor    = null;
        this._flashDuration = 0;
    };

    const _Game_CharacterBaseUpdate       = Game_CharacterBase.prototype.update;
    Game_CharacterBase.prototype.update = function() {
        _Game_CharacterBaseUpdate.call(this);
        this.updateFlash();
    };

    Game_CharacterBase.prototype.startFlash = function(flashColor, flashDuration) {
        this._flashColor    = flashColor;
        this._flashDuration = flashDuration;
    };

    Game_CharacterBase.prototype.clearFlash = function() {
        this._flashColor = [0,0,0,0];
    };

    Game_CharacterBase.prototype.isFlash = function() {
        return this._flashDuration > 0;
    };

    Game_CharacterBase.prototype.updateFlash = function() {
        if (this.isFlash()) {
            this._flashColor[3] = this._flashColor[3] * (this._flashDuration - 1) / this._flashDuration;
            this._flashDuration--;
        }
    };

    Game_CharacterBase.prototype.applySensorEffect = function(targetEvent, detail) {
        const color = detail.FlashColor;
        if (color && !this.isFlash()) {
            this.startFlash([color.Red, color.Green, color.Blue, color.Alpha], param.FlashDuration);
        }
        const balloonId = detail.Balloon;
        if (balloonId && (!param.WaitForBalloon || !this.isBalloonPlaying())) {
            if (this._balloonInterval <= 0 || isNaN(this._balloonInterval)) {
                $gameTemp.requestBalloon(this, balloonId);
                this._balloonInterval = param.BalloonInterval;
            } else {
                this._balloonInterval--;
            }
        }
        this._sensorApply = true;
    };

    Game_CharacterBase.prototype.eraseSensorEffect = function() {
        if (!this._sensorApply || !param.EraseWhenAway) {
            return;
        }
        this.clearFlash();
        this._balloonCancel = true;
        this._sensorApply = false;
    };

    Game_CharacterBase.prototype.isBalloonCancel = function() {
        const cancel = this._balloonCancel;
        this._balloonCancel = false;
        return cancel;
    };

    //=============================================================================
    // Game_Event
    //  プレイヤーとの距離を測り、必要な場合にエフェクトさせる機能を追加定義します。
    //=============================================================================
    const _Game_Event_initialize = Game_Event.prototype.initialize;
    Game_Event.prototype.initialize = function(mapId, eventId) {
        _Game_Event_initialize.apply(this, arguments);
        this._balloonInterval = 0;
    };

    Game_Event.prototype.findEventSensorDetail = function() {
        const meta = this.event().meta;
        const detailTag = meta['NES詳細'] || meta['NESDetail'];
        return param.DetailList.find(item => {
            if (item.Id && item.Id !== detailTag) {
                return false;
            }
            const result = this.isValidSensorDetail(item);
            return item.Reverse ? !result : result;
        });
    };

    Game_Event.prototype.isValidSensorDetail = function(item) {
        if (item.Page && item.Page !== this._pageIndex + 1) {
            return false;
        }
        if (item.Switch && !$gameSwitches.value(item.Switch)) {
            return false;
        }
        if (item.SelfSwitch && !$gameSelfSwitches.value([$gameMap.mapId(), this._eventId, item.SelfSwitch])) {
            return false;
        }
        return true;
    };

    const _Game_EventUpdate       = Game_Event.prototype.update;
    Game_Event.prototype.update = function() {
        _Game_EventUpdate.apply(this, arguments);
        if (this.page()) {
            this.updateSensorEffect();
        }
    };

    const _Game_Event_start = Game_Event.prototype.start;
    Game_Event.prototype.start = function() {
        _Game_Event_start.apply(this, arguments);
        this.eraseSensorEffect();
    };

    Game_Event.prototype.updateSensorEffect = function() {
        const subject = this.findNearEffectSubject();
        const detail = this.findEventSensorDetail();
        const sensorOn = detail && this.isSensorOn(detail);
        if (sensorOn) {
            subject.applySensorEffect(this, detail);
        } else {
            subject.eraseSensorEffect();
            this._balloonInterval = 0;
        }
        if (this._sensorOn !== sensorOn) {
            this._sensorOn = sensorOn;
            if (detail) {
                this.updateSensorSwitch(detail);
            }
        }
    };

    Game_Event.prototype.updateSensorSwitch = function(detail) {
        const switchId = detail.SensorSwitch;
        if (switchId) {
            $gameSwitches.setValue(switchId, this._sensorOn);
        }
        const selfSwitchType = detail.SensorSelfSwitch;
        if (selfSwitchType) {
            $gameSelfSwitches.setValue([this._mapId, this._eventId, selfSwitchType.toUpperCase()], this._sensorOn);
        }
    };

    Game_Event.prototype.isSensorOn = function(detail) {
        return this.isEmptyValidate() && this.isVeryNearThePlayer(detail) && !$gameMap.isEventRunning();
    };

    Game_Event.prototype.findNearEffectSubject = function() {
        return param.ApplyPlayer ? $gamePlayer : this;
    };

    Game_Event.prototype.isEmptyValidate = function() {
        const list = this.list();
        return (list && list.length > 1) || !param.DisableEmpty;
    };

    Game_Event.prototype.isVeryNearThePlayer = function(detail) {
        const sx = this.deltaXFrom($gamePlayer.x);
        const sy = this.deltaYFrom($gamePlayer.y);
        const ax = Math.abs(sx);
        const ay = Math.abs(sy);
        const sensorRange = detail.SensorRange;
        if (sensorRange) {
            if (this.x - $gamePlayer.x > sensorRange.Left) {
                return false;
            } else if ($gamePlayer.x - this.x > sensorRange.Right) {
                return false;
            } else if (this.y - $gamePlayer.y > sensorRange.Up) {
                return false;
            } else if ($gamePlayer.y - this.y > sensorRange.Down) {
                return false;
            }
        }
        const sensorDistance = detail.SensorDistance;
        const result = (ax + ay <= sensorDistance) || !sensorDistance;
        if (result && param.ConsiderationDir) {
            if (ax > ay) {
                return $gamePlayer.direction() === (sx > 0 ? 6 : 4);
            } else if (sy !== 0) {
                return $gamePlayer.direction() === (sy > 0 ? 2 : 8);
            } else {
                return true;
            }
        }
        return result;
    };
})();