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

PGMV - The Community-Driven Plugin Library for RPG Maker MV

MV plugins

TM Multi Hp Gauge - TMMultiHpGauge.js

Plugin desc : Displays multiple HP gauge windows on the map scene.

License : MIT License

Author : tomoaky

Desc page : https://github.com/munokura/tomoaky-MV-plugins

Download Page : https://raw.githubusercontent.com/munokura/tomoaky-MV-plugins/refs/heads/master/TMMultiHpGauge.js

File name : TMMultiHpGauge.js

Help of plugin :

@plugindesc Displays multiple HP gauge windows on the map scene.
@author tomoaky
@url https://github.com/munokura/tomoaky-MV-plugins
@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/tomoaky-MV-plugins ).
Original plugin by tomoaky.
-----
TMPlugin - Multi HP Gauge ver. 1.0.0

How to Use:

Adjust the plugin parameters to display your preferred HP gauge.

The coordinates set in windowPosition are for the first actor in the party.
The windows of the remaining actors are displayed at the coordinates obtained by adding gaugeWindowSpaceX / gaugeWindowSpaceY to the previous window coordinates.

This plugin has been tested with RPG Maker MV Version 1.6.1.

This plugin is distributed under the MIT License and is free to use, including commercial use, modifications, and redistribution.

Plugin Commands:

showHpGauge
Displays the HP gauge window.
If the plugin parameter startVisible is 0,
the HP gauge will not be displayed until this command is executed.

hideHpGauge
Hides the HP gauge window. It will remain hidden until the showHpGauge command is executed.

showHpGauge A
Displays Gauge A. If a type is set in the plugin parameters,
it will automatically be displayed when the game starts.

hideHpGauge B
Hides Gauge B. It will remain hidden until the showHpGauge B command is executed.

moveHpGaugeWindow 100 200
Moves the HP Gauge window to X coordinate = 100 / Y coordinate = 200.

Plugin Parameter Notes:

gaugeA to gaugeD

param
If the gauge type is VN, set the game variable number to be used as the current gauge value.
Four consecutive variables (for the number of party members) from the set number will be used.
If 5 is set, variables 5 through 8 will be used.

max
If the gauge type is VN, specify the game variable number to be used as the maximum value of the gauge.
The maximum value will only function when a value is assigned to the game variable with the number set in this parameter.
This setting only affects the length of the gauge; it does not prevent variable values from exceeding the maximum value.
As with param, four consecutive variables are used, starting from the set number.
Be careful not to overlap with other variables.

windowOpacity / collideOpacity
windowOpacity affects the window frame and background, while collideOpacity
also affects the gauge and face graphics.
If the windowOpacity value is lower than collideOpacity, the windowOpacity value is applied as the opacity when overlapping with the player.
However, the collideOpacity value is applied as usual to gauges and face graphics.

vnMax
If the value is true, the maximum value will also be displayed, but if there is insufficient space to display both the current and maximum values (i.e., the gauge is too short), only the current value will be displayed, regardless of the vnMax setting.

@param windowPosition
@desc HP gauge window display settings (fontSize is not used). Please set the coordinates to those of the leading actor's window.
@default {"x":"0","y":"0","width":"288","height":"64","fontSize":""}
@type struct<Position>

@param facePosition
@desc Visibility setting for face graphic (fontSize is not used). If width is 0, the face graphic will be hidden.
@default {"x":"140","y":"0","width":"144","height":"144","fontSize":""}
@type struct<Position>

@param statePosition
@desc State icon display settings (fontSize is not used) width sets the number of icons, not the display width.
@default {"x":"156","y":"24","width":"4","height":"0","fontSize":""}
@type struct<Position>

@param namePosition
@desc Actor name display setting width of 0 will hide the actor name.
@default {"x":"0","y":"0","width":"0","height":"0","fontSize":"28"}
@type struct<Position>

@param goldPosition
@desc Display settings for money If width is 0, money will be hidden.
@default {"x":"0","y":"0","width":"0","height":"0","fontSize":"28"}
@type struct<Position>

@param gaugeA
@desc Gauge A parameters
@default {"type":"HP","x":"12","y":"12","width":"144","height":"36","fontSize":"28","param":"0","max":"0","name":"AP","color":"#ff60c0 #ffa0e0"}
@type struct<Gauge>

@param gaugeB
@desc Gauge B parameters
@default {"type":"","x":"12","y":"12","width":"144","height":"36","fontSize":"28","param":"0","max":"0","name":"AP","color":"#ff60c0 #ffa0e0"}
@type struct<Gauge>

@param gaugeC
@desc Gauge C parameters
@default {"type":"","x":"12","y":"12","width":"144","height":"36","fontSize":"28","param":"0","max":"0","name":"AP","color":"#ff60c0 #ffa0e0"}
@type struct<Gauge>

@param gaugeD
@desc Gauge D parameters
@default {"type":"","x":"12","y":"12","width":"144","height":"36","fontSize":"28","param":"0","max":"0","name":"AP","color":"#ff60c0 #ffa0e0"}
@type struct<Gauge>

@param gaugeWindowSpaceX
@desc The number of dots to shift left and right when arranging HP gauges. You can align them horizontally by setting this to the same value as the window width.
@default 0
@type number
@min -1000

@param gaugeWindowSpaceY
@desc The number of dots to shift vertically when arranging HP gauges. You can align them vertically by setting this to the same value as the window height.
@default 64
@type number
@min -1000

@param vnMax
@desc Whether to display the maximum value of the gauge type VN. Default: OFF (ON = Display / OFF = Hidden)
@default false
@type boolean

@param startVisible
@desc Display status at the start of the game Default: ON (ON = Display / OFF = Hidden)
@default true
@type boolean

@param messageBusyHide
@desc Hide the HP gauge window while the message window is displayed. Default: ON (ON = hide / OFF = do not hide)
@default true
@type boolean

@param eventBusyHide
@desc Hide the HP gauge window while an event is running. Default: ON (ON = hide / OFF = do not hide)
@default true
@type boolean

@param windowOpacity
@desc HP gauge window opacity (0 ~ 255)
@default 255
@type number
@max 255

@param collideOpacity
@desc Opacity when overlapping with the player. Default: 128 (0 ~ 255)
@default 128
@type number
@max 255

@param goldDisplay
@desc Specifies the actor to display when money display is enabled. Specify the order of the party (first is 0), -1 will display to everyone.
@default 0
@type number
@min -1

@param shakeTime
@desc Time (in frames) to shake the window when taking damage. Default: 20 (0 means no shaking).
@default 20
@type number

@param useBattleScene
@desc Display the HP gauge window even during battle scenes. Default: OFF (ON = Display / OFF = Hide)
@default false
@type boolean

@param gaugeWindowBattleX
@desc X coordinate of the HP gauge window in the battle scene. Initial value: 0
@default 0
@type number
@min -1000

@param gaugeWindowBattleY
@desc Y coordinate of the HP gauge window in the battle scene. Initial value: 0
@default 0
@type number
@min -1000

スポンサードリンク

-MV plugins

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