An open library of RPG Maker MZ plugins, powered by the community.

PGMZ - The Community-Driven Plugin Library for RPG Maker MZ

MZ plugins

Trace Event - TraceEvent.js

Plugin desc : Specified Event Tracking Plugin

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com

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

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

File name : TraceEvent.js

Help of plugin :

@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/TraceEvent.js
@plugindesc Specified Event Tracking 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
-----

TraceEvent.js

Provides commands for approaching specified events in various ways.
Execute the following from the ”Set Movement Route” script.

Approach an event in a general way.
this.traceEventById(id); # Approach the event with the id number
this.traceEventByName(’name’); # Approach the event with the name name
this.traceEventByTag(’tagName’); # Approach the event with the specified note
(*1)

*1 Enter <tagName> (the name specified in the function) in the event note
field.
Example: Note field: <aaa>
Script: this.traceEventByNote(’aaa’);

Approach an event in a highly accurate and high-load way.
this.findEventById(id); # Approach the event with the ID number
this.findEventByName(’name’); # Approach the event with the name name
this.findEventByTag(’tagName’); # Approach the event with the specified note
(*1)

Move away from the event in a general way.
this.awayEventById(id); # Move away from the event with the ID number
this.awayEventByName(’name’); # Move away from the event with the name name
this.awayEventByTag(’tagName’); # Move away from the event with the specified
note (*1)

Face the direction of the event.
this.turnEventById(id); # Turn towards the event with the ID number
this.turnEventByName(’name’); # Turn towards the event with the name name
this.turnEventByTag(’tagName’); # Turn towards the event with the specified
note
this.turnEventById(id, true); # Turn in the opposite direction to the event
with the ID number

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 eventPriorityType
@text Event Priority Criteria
@desc This is the priority criteria when there are multiple target events.
@type select
@default 0
@option The event with the smallest ID
@value 0
@option The closest event to its current value
@value 1

@param traceRange
@text Tracking Range
@desc The search scope when searching for an event. Use the control character ¥v[n] to get the variable value.
@type number
@default 0

@param outOfRangeAction
@text Out-of-range operation
@desc This is the behavior if the event is out of range.
@type select
@default 0
@option Doesn’t work
@value 0
@option Random Movement
@value 1
@option Approach the player
@value 2

スポンサードリンク

-MZ plugins

Copyright© PGMZ - The Community-Driven Plugin Library for RPG Maker MZ , 2026 All Rights Reserved.