Near Event Sensor - PGMZ - The Community-Driven Plugin Library for RPG Maker MZ

Near Event Sensor - NearEventSensor.js

16 September 2025

Plugin desc : Peripheral Event Detection Plugin

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com

Desc page : https://github.com/triacontane/RPGMakerMV/tree/mz_master/NearEventSensor.js

Download Page : https://raw.githubusercontent.com/munokura/triacontane-MZ-plugins/refs/heads/main/NearEventSensor.js

File name : NearEventSensor.js

Help of plugin :

@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

munokura

Welcome to PGMZ! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.