A visual and intuitive utility for the Daggerheart system in Foundry VTT. It automatically displays distance rings (Melee, Very Close, Close, Far) around tokens and calculates distances between characters instantly, helping players and GMs visualize combat ranges without needing to measure manually.

Leia em Português do Brasil

• Visual Range Rings: Instantly see the 4 main range bands of Daggerheart:

  • Melee: 5 ft.

  • Very Close: 15 ft.

  • Close: 30 ft.

  • Far: 60 ft.

• Smart Hover: Hover your mouse over any token to see exactly how far it is from your character. No ruler needed!

• Easy Toggle: Turn the rings on or off quickly using a button in the Token HUD or a keyboard shortcut.

• Smart Edge Detection: Accurate for tokens of all sizes! The system measures distance from edge-to-edge rather than center-to-center. It also checks visual coverage: a token is only considered "in range" if a specific percentage of its body (configurable) is physically inside the ring, ensuring that what you see matches the rules.

Set how much of a token must be inside the circle to be considered in range.

The system accounts for token size when calculating range.

• Mass Measurement: Select multiple tokens and use the macro DHDistances.MassMeasurement(); to generate distance rings from the center of the group.

• Target Highlighting: Valid targets within range rings now glow with the ring's color.

• Ghost Preview: Range rings now follow the token preview while dragging to test positions.

The GM can show distance rings to all connected players at once. When you broadcast, the rings appear on every player's screen and disappear automatically after a configurable duration (default: 7 seconds).

This is perfect for highlighting a threat's reach during combat so the whole table is on the same page — no need to describe distances verbally.

Three ways to broadcast:

• Keyboard: Select a token and press Shift+R
• Macro: DHDistances.Toggle({ remote: true });
• Hover Broadcast Mode: Enable it in settings and every token you hover will automatically broadcast to players (see Operation Mode below)

Note: Only the GM can broadcast. Players pressing Shift+R have no effect.

You can change how rings appear by selecting an Operation Mode in the Module Settings:

You can also temporarily override the active mode using hold-keys — useful when you're in Manual mode but want a quick broadcast without changing settings:

• Hold Shift+H — activates Hover Mode (GM) while the key is held
• Hold Shift+B — activates Hover Mode (Broadcast) while the key is held

Release the key and the mode returns to normal.

• Beautiful Themes: Choose from pre-made color palettes like "Traffic Light", "Neon Cyberpunk", or "Warm Sunset".

• Visual Styles: Configure the rings to have solid, dotted, or dashed lines, and adjust their thickness.

• Immersive Effects: Enable animated gradient fills that pulse gently, or keep it simple with static colors.

You have many easy ways to show or hide the range rings around a token:

1. Token HUD: Right-click a token to open the HUD, then click the Circle icon ().

2. Keyboard Shortcuts:

All keybindings can be reassigned in Foundry Settings → Configure Controls.

3. You can also use macros:

DHDistances.Toggle();              // Toggle rings for selected/hovered token
DHDistances.Toggle({ remote: true }); // Broadcast rings to all players (GM only)
DHDistances.MassMeasurement();     // Mass Measurement from selected tokens
DHDistances.ClearAll();            // Remove all active rings (respects Clear All Mode setting)

DHDistances.Toggle({mode: '2d'}); // Calculates distance ignoring elevation.

DHDistances.Toggle({mode: '3d'}); // Calculates distance accounting for elevation.

DHDistances.Toggle({mode: 'both'}); // Shows both 3D and 2D distances.

// GM only: explicit scope override (takes precedence over the Clear All Mode setting)
DHDistances.ClearAll({ scope: 'all' });  // Remove rings for all connected players
DHDistances.ClearAll({ scope: 'self' }); // Remove rings for the GM only

Go to the Module Settings tab in Foundry VTT to customize the look and feel:

Want to translate this module into your language? Here's how:

1. Download the English translation file: languages/en.json
2. Translate the values (keep the keys unchanged)
3. Submit your translation at GitHub Issues — attach the translated file and mention the target language