A customizable, free, system-agnostic real-time party health overlay for Foundry Virtual Tabletop.
This module adds a configurable overlay to your Foundry VTT interface that displays real-time health bars, character portraits, and status feedback for the entire party. It pulls health data directly from actor or token attributes and updates instantly as characters take damage or heal. Designed to be intuitive, non-intrusive, and easy to set up, it enhances group awareness without getting in the way of gameplay.
🧙 For Players
Dynamic HP Bars
See the health of your group at a glance with color-coded bars—static green or dynamic green-yellow-red.
Portrait & Name Display
Show each character’s token or actor portrait, with optional name labels.
Real-Time Damage Feedback
Portraits briefly shake when a character takes damage.
Quick Token Access
-
Left-click to pan to a token
-
Right-click to open the character sheet (if permitted)
Customizable Overlay
Drag to reposition, scroll to resize, and tweak settings—all changes update live.
Portrait Behavior
Optional tinting or darkening based on HP percentage.
🛠️ For GMs
Player Visibility Controls
Configure whether players see exact HP, descriptive health states (e.g., “Wounded”, “Critical”), or just visual bars.
Layout Options
Switch between vertical and horizontal display, and adjust size, background, border, and opacity.
Portrait Controls
Choose portrait shapes, border styles, or disable portraits entirely.
System Support
Works out of the box with common systems like DnD5e, PF2e, PF1, SWADE, Knight, and WFRP4e.
Other systems are supported via the first-time setup dialog or by manually defining HP paths.
Configuration Sync
HP path presets are stored in a shared online config. New systems can be added and updated without requiring a module update.
⚙️ Setup
-
Each player must have an assigned character.
-
For non-5e systems, the first-time setup dialog will guide you through HP configuration.
-
Settings can be adjusted per-user via the module's UI, with no need to reload or refresh.