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 Gauge Value EX - NUUN_GaugeValueEX.js

Plugin desc : Gauge display EX

License : MIT License

Author : NUUN

Website : https://github.com/nuun888/MZ/blob/master/NUUN_GaugeValueEX.js

Download Page : https://raw.githubusercontent.com/nuun888/MZ/master/NUUN_GaugeValueEX.js

File name : NUUN_GaugeValueEX.js

Help of plugin :

* @target MZ
 * @plugindesc Gauge display EX
 * @author NUUN
 * @version 1.5.1
 * @base NUUN_Base
 * @orderAfter NUUN_Base
 * 
 * @help
 * Extend the display of the gauge.
 * 
 * This plugin extends the following functionality:
 * Hide gauge
 * Number display method
 * Change the coordinates of numbers and labels
 * Gauge color change at max and below a certain percentage
 * Label icon display
 * 
 * Gauge numeric display format specifications
 * "time" (TPB gauge) does not display a numerical value.
 * 
 * Numeric display width
 * If you specify only numeric values, enclose them with ''.
 * 
 * The application priority of the gauge numerical value setting is given priority to the upper setting. Set the target to the bottom for the 'all' setting.
 * 
 * Font settings
 * Any font can be set for gauge numbers and labels.
 * 
 * color settings
 * All color settings can specify the color code from the text tab.
 *
 * Normal gauge color
 * By entering -1 for the normal gauge color (entering -1 in the text tab for editor Ver.1.6.0 or later), the original gauge color will be applied.
 * 
 * FilteringClass
 * Enter the applicable window class or gauge class, identification name, or identifier.
 * 
 * Terms of Use
 * This plugin is distributed under the MIT license.
 * 
 * To change the font, you need a separate plug-in to load the font.
 * Triacontane font load plug-in recommended
 * https://triacontane.blogspot.com/
 * 
 * Log
 * 5/26/2024 Ver.1.5.1
 * Fixed an issue where gauge temporary data was not deleted.
 * 5/24/2024 Ver.1.5.0
 * System renovation.
 * Added the ability to specify an image to the gauge.
 * Added the ability to set a frame on the gauge.
 * Added a function that allows you to specify the width and height of the gauge only for the default gauge.
 * 4/16/2023 Ver.1.4.2
 * Modified filtering class processing to support "ExtraGauge" and "SceneCustomMenu".
 * 12/24/2022 Ver.1.4.1
 * Fixed an issue where normal gauge color settings were not being applied.
 * 12/15/2022 Ver.1.4.0
 * Added a function that can change numbers and labels to arbitrary fonts.
 * Fixed an issue where displaying an unset gauge type would cause an error.
 * 12/15/2022 Ver.1.3.3
 * Added a function to display the number display in the main font.
 * 12/13/2022 Ver.1.3.2
 * Fixed the problem that an error occurs when displaying with core script Ver.1.3.2 or earlier versions.
 * 12/6/2022 Ver.1.3.1
 * Changed the Type of color specification plug-in parameter to color. (Core script Ver.1.6.0 or later)
 * Changed the Type of icon specified plug-in parameter to icon. (Core script Ver.1.6.0 or later)
 * 11/25/2022 Ver.1.3.0
 * Added a function that can specify an icon for the label.
 * Changed the display in languages other than Japanese to English.
 * 7/19/2022 Ver.1.2.1
 * Added function to center the position of numbers.
 * 7/18/2022 Ver.1.2.0
 * Added a function that can specify the class to be displayed.
 * Changed font size specifications.
 * Changed processing of numeric display.
 * Added a function that can specify left alignment and right alignment of numerical values.
 * 1/3/2022 Ver.1.1.1
 * Changed so that the current value, /, and maximum value coordinate change can be changed respectively.
 * 12/12/2021 Ver.1.0.3
 * Changed because some plugins and functions were duplicated.
 * 12/5/2021 Ver.1.0.2
 * Fixed an issue where gauge hiding was not being applied.
 * 12/5/2021 Ver.1.0.1
 * Corrected so that the current value/maximum value is aligned to the right.
 * Fixed an issue where gauges below a certain percentage other than HP were not applied.
 * Fixed an issue where the color of numbers below a certain percentage was not applied at maximum.
 * Fixed an issue where the label's X coordinate was not applied.
 * Fixed some processing.
 * 12/4/2021 Ver.1.0.0
 * First edition
 * 
 * @param CommonSetting
 * @text Common setting
 * @default ------------------------------
 * 
 * @param GaugeValueSetting
 * @text Gauge value setting
 * @desc Gauge value setting.
 * @type struct<ValueGauge>[]
 * @default ["{¥"Type¥":¥"'hp'¥",¥"ValueVisible¥":¥"'Value'¥",¥"ValueAlign¥":¥"'default'¥",¥"GaugeVisible¥":¥"true¥",¥"ValueDigits¥":¥"¥",¥"FilteringClass¥":¥"¥",¥"GaugeImg¥":¥"¥",¥"GaugeDisplayRangeSetting¥":¥"------------------------------¥",¥"GaugeWidth¥":¥"128¥",¥"GaugeHeight¥":¥"12¥",¥"BitmapHeight¥":¥"32¥",¥"CoordinateSetting¥":¥"------------------------------¥",¥"ValueWidth¥":¥"0¥",¥"GaugeAbsoluteCoordinates¥":¥"false¥",¥"GaugeX¥":¥"-1¥",¥"GaugeY¥":¥"0¥",¥"ValueAbsoluteCoordinates¥":¥"false¥",¥"ValueX¥":¥"0¥",¥"ValueY¥":¥"0¥",¥"MaxValueX¥":¥"0¥",¥"MaxValueY¥":¥"0¥",¥"SeparationX¥":¥"0¥",¥"SeparationY¥":¥"0¥",¥"LabelAbsoluteCoordinates¥":¥"false¥",¥"LabelX¥":¥"0¥",¥"LabelY¥":¥"3¥",¥"ValueSpaceMargin¥":¥"0¥",¥"ValueMargin¥":¥"0¥",¥"UserLabelFontFace¥":¥"¥",¥"FontSetting¥":¥"------------------------------¥",¥"ValueFontSize¥":¥"-6¥",¥"MaxValueFontSize¥":¥"-6¥",¥"SeparationFontSize¥":¥"-6¥",¥"LabelFontSize¥":¥"-2¥",¥"ValueFontFace¥":¥"false¥",¥"UserValueFontFace¥":¥"¥",¥"ColorSetting¥":¥"------------------------------¥",¥"MaxValueColor¥":¥"0¥",¥"SeparationColor¥":¥"0¥",¥"LabelColor¥":¥"16¥",¥"GaugeColorSetting¥":¥"------------------------------¥",¥"GaugeBackColor¥":¥"19¥",¥"GaugeStrokeColor¥":¥"-1¥",¥"GaugeColor1¥":¥"-1¥",¥"GaugeColor2¥":¥"-1¥",¥"IconSetting¥":¥"------------------------------¥",¥"LabelIcon¥":¥"0¥",¥"LabelIconScale¥":¥"100¥",¥"GaugeColorMaxSetting¥":¥"------------------------------¥",¥"GaugeColorMaxApply¥":¥"false¥",¥"MaxGaugeColor1¥":¥"0¥",¥"MaxGaugeColor2¥":¥"0¥",¥"GaugeColorRatioSetting¥":¥"------------------------------¥",¥"GaugeColorRatioApply¥":¥"false¥",¥"RatioGauge¥":¥"0¥",¥"RatioGaugeColor1¥":¥"0¥",¥"RatioGaugeColor2¥":¥"0¥"}","{¥"Type¥":¥"'mp'¥",¥"ValueVisible¥":¥"'Value'¥",¥"ValueAlign¥":¥"'default'¥",¥"GaugeVisible¥":¥"true¥",¥"ValueDigits¥":¥"¥",¥"FilteringClass¥":¥"¥",¥"GaugeImg¥":¥"¥",¥"GaugeDisplayRangeSetting¥":¥"------------------------------¥",¥"GaugeWidth¥":¥"128¥",¥"GaugeHeight¥":¥"12¥",¥"BitmapHeight¥":¥"32¥",¥"CoordinateSetting¥":¥"------------------------------¥",¥"ValueWidth¥":¥"0¥",¥"GaugeAbsoluteCoordinates¥":¥"false¥",¥"GaugeX¥":¥"-1¥",¥"GaugeY¥":¥"0¥",¥"ValueAbsoluteCoordinates¥":¥"false¥",¥"ValueX¥":¥"0¥",¥"ValueY¥":¥"0¥",¥"MaxValueX¥":¥"0¥",¥"MaxValueY¥":¥"0¥",¥"SeparationX¥":¥"0¥",¥"SeparationY¥":¥"0¥",¥"LabelAbsoluteCoordinates¥":¥"false¥",¥"LabelX¥":¥"0¥",¥"LabelY¥":¥"3¥",¥"ValueSpaceMargin¥":¥"0¥",¥"ValueMargin¥":¥"0¥",¥"UserLabelFontFace¥":¥"¥",¥"FontSetting¥":¥"------------------------------¥",¥"ValueFontSize¥":¥"-6¥",¥"MaxValueFontSize¥":¥"-6¥",¥"SeparationFontSize¥":¥"-6¥",¥"LabelFontSize¥":¥"-2¥",¥"ValueFontFace¥":¥"false¥",¥"UserValueFontFace¥":¥"¥",¥"ColorSetting¥":¥"------------------------------¥",¥"MaxValueColor¥":¥"0¥",¥"SeparationColor¥":¥"0¥",¥"LabelColor¥":¥"16¥",¥"GaugeColorSetting¥":¥"------------------------------¥",¥"GaugeBackColor¥":¥"19¥",¥"GaugeStrokeColor¥":¥"-1¥",¥"GaugeColor1¥":¥"-1¥",¥"GaugeColor2¥":¥"-1¥",¥"IconSetting¥":¥"------------------------------¥",¥"LabelIcon¥":¥"0¥",¥"LabelIconScale¥":¥"100¥",¥"GaugeColorMaxSetting¥":¥"------------------------------¥",¥"GaugeColorMaxApply¥":¥"false¥",¥"MaxGaugeColor1¥":¥"0¥",¥"MaxGaugeColor2¥":¥"0¥",¥"GaugeColorRatioSetting¥":¥"------------------------------¥",¥"GaugeColorRatioApply¥":¥"false¥",¥"RatioGauge¥":¥"0¥",¥"RatioGaugeColor1¥":¥"0¥",¥"RatioGaugeColor2¥":¥"0¥"}","{¥"Type¥":¥"'tp'¥",¥"ValueVisible¥":¥"'Value'¥",¥"ValueAlign¥":¥"'default'¥",¥"GaugeVisible¥":¥"true¥",¥"ValueDigits¥":¥"¥",¥"FilteringClass¥":¥"¥",¥"GaugeImg¥":¥"¥",¥"GaugeDisplayRangeSetting¥":¥"------------------------------¥",¥"GaugeWidth¥":¥"128¥",¥"GaugeHeight¥":¥"12¥",¥"BitmapHeight¥":¥"32¥",¥"CoordinateSetting¥":¥"------------------------------¥",¥"ValueWidth¥":¥"0¥",¥"GaugeAbsoluteCoordinates¥":¥"false¥",¥"GaugeX¥":¥"-1¥",¥"GaugeY¥":¥"0¥",¥"ValueAbsoluteCoordinates¥":¥"false¥",¥"ValueX¥":¥"0¥",¥"ValueY¥":¥"0¥",¥"MaxValueX¥":¥"0¥",¥"MaxValueY¥":¥"0¥",¥"SeparationX¥":¥"0¥",¥"SeparationY¥":¥"0¥",¥"LabelAbsoluteCoordinates¥":¥"false¥",¥"LabelX¥":¥"0¥",¥"LabelY¥":¥"3¥",¥"ValueSpaceMargin¥":¥"0¥",¥"ValueMargin¥":¥"0¥",¥"UserLabelFontFace¥":¥"¥",¥"FontSetting¥":¥"------------------------------¥",¥"ValueFontSize¥":¥"-6¥",¥"MaxValueFontSize¥":¥"-6¥",¥"SeparationFontSize¥":¥"-6¥",¥"LabelFontSize¥":¥"-2¥",¥"ValueFontFace¥":¥"false¥",¥"UserValueFontFace¥":¥"¥",¥"ColorSetting¥":¥"------------------------------¥",¥"MaxValueColor¥":¥"0¥",¥"SeparationColor¥":¥"0¥",¥"LabelColor¥":¥"16¥",¥"GaugeColorSetting¥":¥"------------------------------¥",¥"GaugeBackColor¥":¥"19¥",¥"GaugeStrokeColor¥":¥"-1¥",¥"GaugeColor1¥":¥"-1¥",¥"GaugeColor2¥":¥"-1¥",¥"IconSetting¥":¥"------------------------------¥",¥"LabelIcon¥":¥"0¥",¥"LabelIconScale¥":¥"100¥",¥"GaugeColorMaxSetting¥":¥"------------------------------¥",¥"GaugeColorMaxApply¥":¥"false¥",¥"MaxGaugeColor1¥":¥"0¥",¥"MaxGaugeColor2¥":¥"0¥",¥"GaugeColorRatioSetting¥":¥"------------------------------¥",¥"GaugeColorRatioApply¥":¥"false¥",¥"RatioGauge¥":¥"0¥",¥"RatioGaugeColor1¥":¥"0¥",¥"RatioGaugeColor2¥":¥"0¥"}"]
 * @parent CommonSetting
 * 
 * @param ValueAlign
 * @desc Specifies the default numeric position.
 * @text default numeric position
 * @type select
 * @option Left
 * @value 'left'
 * @option Center
 * @value 'center'
 * @option Right
 * @value 'right'
 * @default 'right'
 * @parent CommonSetting
 * 
 * @param ValueDigits
 * @desc The display width of the numeric value when the default gauge numeric display format is current value/max value.
 * @text default number display width
 * @type string
 * @default '0000'
 * @parent CommonSetting
 *

スポンサードリンク

-MZ plugins

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