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

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

MZ plugins

NUUN Battler MP Gauge - NUUN_BattlerMPGauge.js

Plugin desc : Butler MP Gauge

License : MIT License

Author : NUUN

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

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

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

File name : NUUN_BattlerMPGauge.js

Help of plugin :

@target MZ
@url https://github.com/nuun888/MZ
@plugindesc Butler MP 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 the MP gauge on the enemy or SV actor battler.

Enemy character or actor memo field
<MPGaugeX:[position]> Adjusts the X coordinate of the MP gauge. (Relative
coordinates)
<MPGaugeY:[position]> Adjusts the Y coordinate of the MP gauge. (Relative
coordinates)
[position]: Coordinates

Enemy character memo field
<NoMPGauge> Does not display the MP gauge.
<MPGaugeLength:[width], [height]> Specifies the width of the MP gauge.
[width]: Gauge width
[height]: Gauge height

Battle event notes
<MPGaugePosition:[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 placed in the enemy group settings. A
number appears in the upper left corner of the monster image; enter that
number here.

Feature Memo Field
<MPGaugeVisible> If an actor with this feature is present, the enemy's MP
gauge will be displayed.
<EnemyMPGaugeVisible> Enemies with this feature will have their MP gauge
displayed.
Enemy Memo Field
<MPGaugeMask:[eval]> If the condition is not met, the MP value will be
displayed as ???.
this Enemy Data
this.enemy() Enemy Database Data
Example: <MPGaugeMask:this.mp < this.mmp * 0.3>
Displays the MP value when the enemy's MP is below 30%.

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

This plugin requires NUUN_Base Ver. 1.2.0 or later.

If you have installed Pseudo 3D Battle, place this plugin below Pseudo 3D
Battle.
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.5
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.4
Fixed an issue where NoMPGauge was not working with some plugins.
July 7, 2023 Ver. 1.2.3
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.2
Fixed an issue where NoMPGauge was not working.
June 2, 2023 Ver. 1.2.1
Bug fixes.
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 MP gauge display to fade in and out.
May 14, 2022 Ver. 1.1.0
Changed the definition of the butler display process significantly.
January 10, 2022 Ver. 1.0.2
Further revision.
January 10, 2022 Ver. 1.0.1
Fixed an issue where the gauge would display 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 MPPosition
@text MP gauge position
@desc Enemy MP 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
@parent EnemyVisibleSetting

@param MPVisible
@text MP gauge display timing
@desc MP gauge display timing
@type select
@default 0
@option Always Show
@value 0
@option When selected
@value 1
@option When MP changes
@value 2
@option When selected, when MP changes
@value 3
@parent EnemyVisibleSetting

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

@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 MPLabelVisible
@text MP label display
@desc Show MP label.
@type boolean
@default true
@parent GaugeSetting

@param MPValueVisible
@text MP value display
@desc Displays the MP 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 MP values
@desc Characters used to hide MP values.
@type string
@default ????
@parent GaugeSetting

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

@param MPVisibleMode
@text MP gauge display
@desc The MP gauge will be displayed in the initial state. It will be displayed depending on the feature and the timing of the MP 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 MPEnemyBookVisible
@text MP gauge display timing (Monster Encyclopedia)
@desc MP 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 EnemyBookSetting

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

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

@param ActorMPPosition
@text MP gauge position
@desc Actor's MP 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 ActorMPVisible
@text MP gauge display timing
@desc MP gauge display timing
@type select
@default 0
@option Always Show
@value 0
@option When selected
@value 1
@option When MP changes
@value 2
@option When selected, when MP 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 ActorMPLabelVisible
@text MP label display
@desc Displays the actor's MP label.
@type boolean
@default true
@parent ActorGaugeSetting

@param ActorMPValueVisible
@text MP value display
@desc Displays the actor's MP 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

スポンサードリンク

-MZ plugins

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