Characters Map Gauges (AABSZ Extension)

aabsz_ext_chracters_map_gauges.md

Characters Map Gauges (AABSZ Extension)

This extension plugin requires Alpha ABS Z to work.

⚠️ Information valid for version 0.11 and above

---

🎯 Overview

This extension adds character health gauges to the battle screen, allowing players to easily monitor the health status of each character during combat.

Gauges are displayed above enemies and party members on the map.

⚙️ Configuration

To configure the character map gauges, follow these steps:

1. Go to the plugin parameters of the "Characters Map Gauges" extension.
2. Open the "Mini HP Gauges Visibility Condition" parameter.
3. Setup the visibility conditions, you have next options:
   • Always? - Show Always
   • When Character in Battle? - Show When Character is in Battle state
   • Is for damaged only? - Show When Character is Damaged
   • Is Show only on Hover? - Show When Mouse is Hovering the Character

🛠️ Customization

You can create your own styles for characters health gauges. Or even hide gauges for certain characters.

Create and Apply Custom Styles:

1. Go to the folder: data/AABSZ/chars_map_gauges/
2. Copy the default.json file and rename it (e.g., MyStyle.json)
3. Edit the copied file to customize the style.

To change the default style for all characters, replace or modify default.json.

To assign a custom style to a specific character:

• Use the ABS parameter: miniHpGaugeStyleFile:NAME

Add it in the Database or as a comment for the character event in the map editor.

Example for Database:

<ABS>
miniHpGaugeStyleFile:MyStyle
</ABS>

Example for Event Comment:

<miniHpGaugeStyleFile:MyStyle>

Offset Adjustment

You can adjust the position of the gauges for certain characters using the following ABS parameters: miniHPGaugeOffset:X,Y

• X: Horizontal offset (positive values move right, negative values move left)
• Y: Vertical offset (positive values move down, negative values move up)

Example for Database:

<ABS>
miniHPGaugeOffset:0,-10
</ABS>

Example for Event Comment:

<miniHPGaugeOffset:0,-10>

Hide Gauges for Specific Characters

⚠️ For hiding the gauge for a specific character, use:

Event Comment:

<miniHpGaugeStyleFile:none>

Database:

<ABS>
miniHpGaugeStyleFile:none
</ABS>

Default styles available:

In folder data/AABSZ/chars_map_gauges/ you can find some pre-made styles:

• default.json - Default style
• withText.json - Style with HP text
• none.json - No gauge (invisible)

---