Skip to main content

DG-HUD Documentation

This is a Living Document and will change as DG-HUD is further developed and modified. Images and other media here may appear out of date but I will try to keep as current as possible.

DG-HUD is currently only tested and verified to work on Foundry v13

About

DG-HUD is a module used to give both Handlers and Agents seamless access to all major rolls and mechanics and provides new automation all from one cohesive, tabbed panel.

Getting Started

Installation

  • Visit My Patreon Page to purchase individual modules or to join a Support Tier that includes the module(s) you want.
  • Head to https://fuliginheart.dev and use the Login with Patreon button to access any entitlements you have with me.
  • Add your custom manifest link to your Foundry installation.

Accessing

In order to access DG-HUD, you must enable it and then the HUD will appear. By default, if you're the GM, only the Handler HUD will appear with information, while the Agent HUD won't fully open unless you're selecting an Agent or NPC actor. Agents' HUD will appear 24/7 as long as they have a properly assigned actor in the Foundry User Configuration.

image

Features

DG-HUD currently has two different main HUD panels: Agent HUD and Handler HUD. Information is tracked 1:1 to character and NPC sheets. Panel positions, minimized states, and more are all tracked between Foundry sessions. Custom chat popups exist for stat rolls, skill rolls, luck rolls, weapon attacks, and psyche info.

Agent HUD

The Agent HUD UI bar will open by default in full mode. The bar can also be changed to compact mode by double-clicking the left-side hamburger icon. You can also move the HUD around by clicking and dragging on the same icon. Full mode will display skills, gear, bonds, and psyche in separate panels. Compact mode will only display those in an all-in-one non-tabbed panel when hovering over the bar. The panel in compact mode will dynamically orient based on whether it is at the top or bottom of the screen. HP, WP, SAN, and BP are tracked in real time and can all be raised and lowered by -1 and +1 by LMB and RMB-ing the numbers respectively, across both modes.

Full Mode

Compact Mode

Compact Mode: Full Panel

Skills

In the Skills panel both Agent stats and skills will show up, rolls can be made for both stats and skills by left-clicking them. Shift-clicking will provide a roll-modifier popup. Right-clicking skills will mark them as failed (skills will be automatically marked on failed rolls, too) for the purposes of skill improvement. Untrained skills won't appear by default, but can be displayed by clicking Show Untrained. Luck can be rolled too. Skills that are marked for improvement can be improved and rolled automatically as well, using the chosen method in the Delta Green system settings. 3d dice rolls are supported with Dice So Nice.

image

Gear

Weapons and armor will be displayed here with their corresponding information. Right-clicking gear will toggle if they're equipped or not. Weapons can be rolled automatically by clicking them and the corresponding skill will be rolled, along with a popup to roll damage in the chat if it's a success. You can also toggle weapons that have a lethality state to lethal by right-clicking them, and that will be rolled instead when clicked. Shift-clicking will provide a modifier pop-up accordingly.

Screenshot 2026-02-03 232344

Bonds

All Agent Bonds will be displayed here, and new ones can be added by clicking Add Bond and a custom popup will appear allowing you to add details. Any bond can have sanity loss projected onto it by clicking on it. You may put in how much should be projected onto the bond, and optionally also restore that same amount to the Agent's sanity.

image

Psych

Agents' sanity, adaptations, and breaking point are all tracked here. Sanity checks can be made here too. Sanity is displayed in its numeric score and a progress bar. You may raise or lower sanity by the + and - icons. Breaking point is tracked along with sanity loss and will notify you when crossed and will also grant a popup to reset it automatically. You can also add adaptation marks for violence and helplessness here by LMB and RMB for +1 and -1. When checked three times, the Agent can be adapted and a popup will appear allowing you to also apply the respective rolled stat penalties, or just mark them on their own.

image

Handler HUD

Handler HUD has three different modes of display: cards, table, and compact. Each will show the existing player controlled Agents. It will display their HP, WP, and SAN (as well as BP). An Agent's character sheet can be opened by left-clicking them. The log tracks and showcases all major Agent actions such as sanity loss, breaking point resets, skill changes, etc.

Handler HUD

Handler Log

Settings

Settings can be accessed by clicking the gear icon on both the Agent UI bar or the Handler UI bar. You can:

  • Toggle if the Agent's name and profession show above the Agent's UI bar.
  • Change the font scale.
  • Change the theme between: Classic Dark, Tactical Dark, Light Ops, Retro Amber, Shadow Ops, Desert Sun, Ultra Contrast, CB: Blue/Yellow, CB: Purple/Teal, CB: High Contrast.
  • Change the font family. Any Foundry, system, or custom font can be selected for the HUD.
  • Handler Only: Toggle the visibility of the Agent monitoring window.
  • Change which of the four core panels are visible to all players.
Screenshot 2026-02-03 233847