Progress Bars

Progress bars display character statistics as visual bars with optional numeric values.

Overview

Progress bars:

Show health, mana, stamina, spirit, encumbrance
Update automatically from game data
Support custom colors and styling
Can show value, percentage, or both

Configuration

[[windows]]
name = "health"
type = "progress"

# Position and size
row = 0
col = 80
width = 30
height = 1

# Progress-specific options
stat = "health"           # Stat to track (required)
show_value = true         # Show "425/500"
show_percentage = false   # Show "85%"
show_label = true         # Show stat name

# Colors
bar_color = "#00FF00"     # Bar fill color
bar_empty_color = "#333333"  # Empty portion
text_color = "#FFFFFF"    # Text color

Properties

stat (required)

The character statistic to display:

Stat	Description
`health`	Health points
`mana`	Mana points
`spirit`	Spirit points
`stamina`	Stamina points
`encumbrance`	Encumbrance level

show_value

Display the numeric value:

show_value = true     # Shows "425/500"
show_value = false    # Bar only

show_percentage

Display percentage instead of/with value:

show_percentage = true    # Shows "85%"
show_percentage = false   # Shows value or nothing

show_label

Display the stat name:

show_label = true     # Shows "HP: 425/500"
show_label = false    # Shows "425/500"

bar_color

Color of the filled portion:

bar_color = "#00FF00"     # Green
bar_color = "health"      # From palette
bar_color = "@health"     # From preset

Dynamic Colors

Use different colors based on value:

[[windows]]
name = "health"
type = "progress"
stat = "health"

# Color thresholds (checked in order)
[windows.color_thresholds]
75 = "#00FF00"    # Green above 75%
50 = "#FFFF00"    # Yellow 50-75%
25 = "#FF8800"    # Orange 25-50%
0 = "#FF0000"     # Red below 25%

Display Formats

Compact (1 row)

[[windows]]
name = "health"
type = "progress"
stat = "health"
width = 20
height = 1
show_label = true
show_value = true

Result: HP ████████░░ 80%

Minimal (Bar only)

[[windows]]
name = "health"
type = "progress"
stat = "health"
width = 15
height = 1
show_label = false
show_value = false

Result: ████████████░░░

Vertical Bar

[[windows]]
name = "health"
type = "progress"
stat = "health"
width = 3
height = 10
orientation = "vertical"

Examples

Health Bar (Green)

[[windows]]
name = "health"
type = "progress"
stat = "health"
row = 0
col = 80
width = 25
height = 1
bar_color = "#00FF00"
show_value = true

Mana Bar (Blue)

[[windows]]
name = "mana"
type = "progress"
stat = "mana"
row = 1
col = 80
width = 25
height = 1
bar_color = "#0088FF"
show_value = true

Spirit Bar (Cyan)

[[windows]]
name = "spirit"
type = "progress"
stat = "spirit"
row = 2
col = 80
width = 25
height = 1
bar_color = "#00FFFF"
show_value = true

Stamina Bar (Yellow)

[[windows]]
name = "stamina"
type = "progress"
stat = "stamina"
row = 3
col = 80
width = 25
height = 1
bar_color = "#FFFF00"
show_value = true

Encumbrance Bar

[[windows]]
name = "encumbrance"
type = "progress"
stat = "encumbrance"
row = 4
col = 80
width = 25
height = 1
bar_color = "#888888"
show_percentage = true

Stacked Vitals

# All vitals in one area
[[windows]]
name = "health"
type = "progress"
stat = "health"
row = 0
col = 100
width = 20
height = 1

[[windows]]
name = "mana"
type = "progress"
stat = "mana"
row = 1
col = 100
width = 20
height = 1

[[windows]]
name = "spirit"
type = "progress"
stat = "spirit"
row = 2
col = 100
width = 20
height = 1

[[windows]]
name = "stamina"
type = "progress"
stat = "stamina"
row = 3
col = 100
width = 20
height = 1

Data Source

Progress bars receive data from <progressBar> XML elements:

<progressBar id='health' value='85' text='health 425/500' />

The parser extracts:

id: Stat type
value: Percentage (0-100)
text: Parse current/max values

Troubleshooting

Bar not updating

Verify stat matches a valid stat ID
Check game is sending progress bar data
Ensure widget is enabled

Wrong colors

Check bar_color syntax
Verify palette/preset references exist
Check color threshold order

Value display issues

Ensure show_value or show_percentage is true
Check width is sufficient for text
Verify text_color is visible against background

Two-Face Documentation