NUUN Battler TP Gauge - NUUN_BattlerTPGauge.js

Plugin desc : Butler TP Gauge

License : MIT License

Author : NUUN

Website : https://github.com/munokura/NUUN-MZ-plugins/blob/master/NUUN_BattlerTPGauge.js

Desc page : https://github.com/nuun888/MZ

Download Page : https://raw.githubusercontent.com/munokura/NUUN-MZ-plugins/master/NUUN_BattlerTPGauge.js

File name : NUUN_BattlerTPGauge.js

Help of plugin :

@target MZ
@url https://github.com/nuun888/MZ
@plugindesc Butler TP Gauge
@author NUUN
@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/NUUN-MZ-plugins ).
Original plugin by NUUN.
Please check the latest official version at:
https://github.com/nuun888/MZ
-----

Displays TP gauges for enemies and SV actors during battle.

Enemy character or actor memo field
<TPGaugeX:[position]> Adjusts the X coordinate of the TP gauge. (Relative
coordinates)
<TPGaugeY:[position]> Adjusts the Y coordinate of the TP gauge. (Relative
coordinates)

Enemy character memo field
<NoTPGauge> Does not display the TP gauge.
<TPGaugeLength:[width]， [height]> Specifies the width of the TP gauge.
[width]: Gauge width
[height]: Gauge height

Battle event notes
<TPGaugePosition:[Id]，[x]，[y]> Adjusts the gauge position of the [Id]th
monster in the enemy group. (Relative coordinates)
[Id]: Display order number
[x]: X coordinate
[y]: Y coordinate
[id] specifies the ID of the monster in the order it was placed in the enemy
group settings. A number appears in the upper left corner of the monster
image; enter that number here.

Memo field with a feature
<TPGaugeVisible> If an actor with this feature is present， the enemy's TP
gauge will be displayed.
<EnemyTPGaugeVisible> Enemies with this feature will have their TP gauge
displayed.
Enemy Memo field
<TPGaugeMask:[eval]> If the condition is not met， the TP value display will be
changed to ???.
this Enemy data
this.enemy() Enemy database data
Example: <TPGaugeMask:this.tp >= this.maxTp() * 0.5>
Displays the TP value when the enemy's TP is above 50%.

Initial TP Gauge Display
Displays when an actor with the <TPGaugeVisible> feature is in the battle
team， or if it is registered when linked to the Pokédex.
When using the above feature， set the initial TP gauge display to hidden.

This plugin requires NUUN_Base version 1.2.0 or later.

If you have installed the pseudo 3D battle mode， place this plugin below the
pseudo 3D battle mode.
If you are using the Gauge Display Extension Plugin to set the corresponding
gauge， please use the Gauge Display Extension Plugin to set the font size.

Terms of Use
This plugin is distributed under the MIT License.

Update History
January 3， 2025 Ver. 1.2.4
Fixed an issue where the transformed monster's gauge would remain displayed
even if it was set to hidden.
August 3， 2023 Ver. 1.2.3
Fixed an issue where NoTPGauge would not work with some plugins.
July 7， 2023 Ver. 1.2.2
Fixed an issue where an error would occur when displaying a gauge on an enemy
character displayed with some plugins.
June 23， 2023 Ver. 1.2.1
Fixed an issue where NoTPGauge would not work.
June 2， 2023 Ver. 1.2.0
Added the ability to display gauges on SV actors.
Added the ability to specify the width and height of the HP gauge for each
enemy character.
May 7， 2023 Ver. 1.1.1
Fixed the TP gauge display to fade in and out.
May 14， 2022 Ver. 1.1.0
Made a major change to the definition of the battler's display process.
February 12， 2022 Ver. 1.0.3
Fixed an issue where the gauge would appear at the start of battle when
display was specified for damage.
January 10， 2022 Ver. 1.0.2
Further fix.
January 10， 2022 Ver. 1.0.1
Fixed an issue where the gauge would appear starting from coordinate 0 even
when displayed as a label.
January 12， 2022 Ver. 1.0.0
First release.

@param EnemySetting
@text Enemy Settings
@default ------------------------------

@param EnemyVisibleSetting
@text Display settings
@default ------------------------------
@parent EnemySetting

@param TPPosition
@text TP gauge position
@desc Enemy TP gauge position
@type select
@default 0
@option No display
@value -1
@option Above the enemy image
@value 0
@option Under the enemy image
@value 1
@option Center of enemy image
@value 2

@param EnemySetting

@param TPVisible
@text TP gauge display timing
@desc TP gauge display timing
@type select
@default 0
@option Always Show
@value 0
@option When selected
@value 1
@option When TP fluctuates
@value 2
@option When selected， when TP changes
@value 3

@param EnemySetting

@param GaugeSetting
@text Gauge Settings
@default ------------------------------

@param GaugeWidth
@text Gauge width
@desc Specifies the width of the gauge.
@type number
@default 128
@min 0
@parent GaugeSetting

@param GaugeHeight
@text Gauge vertical width
@desc Specifies the vertical width of the gauge.
@type number
@default 12
@min 0
@parent GaugeSetting

@param Gauge_X
@text Gauge X coordinate
@desc Specifies the X coordinate (relative coordinate) of the gauge.
@type number
@default 0
@min -9999
@parent GaugeSetting

@param Gauge_Y
@text Gauge Y coordinate
@desc Specifies the Y coordinate (relative coordinate) of the gauge.
@type number
@default 0
@min -9999
@parent GaugeSetting

@param TPLabelVisible
@text TP label display
@desc Show TP label.
@type boolean
@default true
@parent GaugeSetting

@param TPValueVisible
@text TP numerical display
@desc Displays the TP value.
@type boolean
@default true
@parent GaugeSetting

@param ValueFontSize
@text Numeric Font Size
@desc Number font size (from main font size)
@type number
@default -6
@min -9999
@parent GaugeSetting

@param LabelFontSize
@text Label Font Size
@desc Label font size (from main font size).
@type number
@default -2
@min -9999
@parent GaugeSetting

@param MaskValueName
@text Characters used to hide TP values
@desc Characters used to hide the TP value.
@type string
@default ????
@parent GaugeSetting

@param SpecialSetting
@text Special Settings
@default ------------------------------
@parent GaugeSetting

@param TPVisibleMode
@text Initial TP gauge display
@desc The TP gauge will be displayed in the initial state. It will be displayed depending on the feature and the timing of the TP gauge display.
@type select
@default 0
@option display
@value 0
@option hidden
@value 1
@parent SpecialSetting

@param EnemyBookSetting
@text Pokédex linked settings
@default ------------------------------
@parent GaugeSetting

@param TPEnemyBookVisible
@text TP gauge display timing (Monster Encyclopedia)
@desc TP gauge display timing (Monster Encyclopedia)
@type select
@default 0
@option Not specified
@value 0
@option Displayed after encyclopedia registration
@value 1
@option Displayed after registering encyclopedia information
@value 2
@parent SpecialSetting

@param ActorSetting
@text Actor Settings
@default ------------------------------

@param ActorVisibleSetting
@text Display settings
@default ------------------------------
@parent ActorSetting

@param ActorTPPosition
@text TP gauge position
@desc Actor's TP gauge position
@type select
@default -1
@option No display
@value -1
@option Above the SV image
@value 0
@option Under the SV image
@value 1
@parent ActorVisibleSetting

@param ActorTPVisible
@text TP gauge display timing
@desc TP gauge display timing
@type select
@default 0
@option Always Show
@value 0
@option When selected
@value 1
@option When TP fluctuates
@value 2
@option When selected， when TP changes
@value 3
@parent ActorVisibleSetting

@param ActorGaugeSetting
@text Actor Gauge Settings
@default ------------------------------
@parent ActorSetting

@param ActorGaugeWidth
@text Gauge width
@desc Specifies the width of the actor's gauge.
@type number
@default 128
@min 0
@parent ActorGaugeSetting

@param ActorGaugeHeight
@text Gauge vertical width
@desc Specifies the vertical width of the actor's gauge.
@type number
@default 12
@min 0
@parent ActorGaugeSetting

@param ActorGauge_X
@text Gauge X coordinate
@desc Specifies the X coordinate (relative coordinate) of the actor's gauge.
@type number
@default 0
@min -9999
@parent ActorGaugeSetting

@param ActorGauge_Y
@text Gauge Y coordinate
@desc Specifies the Y coordinate (relative coordinate) of the actor's gauge.
@type number
@default 0
@min -9999
@parent ActorGaugeSetting

@param ActorTPLabelVisible
@text TP label display
@desc Displays the actor's TP label.
@type boolean
@default true
@parent ActorGaugeSetting

@param ActorTPValueVisible
@text TP numerical display
@desc Displays the actor's TP value.
@type boolean
@default true
@parent ActorGaugeSetting

@param ActorValueFontSize
@text Numeric Font Size
@desc Actor number font size (from main font size)
@type number
@default -6
@min -9999
@parent ActorGaugeSetting

@param ActorLabelFontSize
@text Label Font Size
@desc Actor label font size (from main font size).
@type number
@default -2
@min -9999
@parent ActorGaugeSetting

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.