DG-HUD Documentation

This module is in active development and this is a living document. Not all information or screenshots may accurately represent the current state of the module. View the latest Changelogs for the most up-to-date information. Questions, issues, or suggestions can be submitted here.

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

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.

ae504987-23b8-48d8-82e2-03d296f35f36

41dd8213-85d1-445c-b961-763e75e5c236

Full Mode

Compact Mode

aff09660-b6ac-469c-b6e2-7220c3834087

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.

a205e8bd-a600-4d38-b90c-95bece8c0843

35e6de62-b25c-4a39-b495-c6d28cbc6fdb

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:

Screenshot 2026-02-03 233847

Revision #10
Created 2026-02-19 17:28:37 UTC by Fuligin Heart
Updated 2026-03-18 14:21:22 UTC by Fuligin Heart