How emilithe-tech/veilrunner-system works
Veilrunner is a Foundry VTT game system for character management, rules-driven play, combat, and campaign recordkeeping. Its principal player workflow runs from character creation and progression through a hero sheet into action selection and combat execution. GMs also author canonical progression content and manage shared relations, maps, and events through the Datapad. The graph emphasizes documented entry-point wiring and sampled calls; several feature internals are represented by their exact enclosing directories because their source was not sampled.
Main entry points: veilrunner.mjs Veilrunner system · service.mjs Relations service · catalog-provider.mjs Progression catalog · controller.mjs Action HUD
Components 24
System Runtime
- Veilrunner system
veilrunner.mjs - System settings
modules/settings.mjs
Play And Combat
- Action HUD
modules/apps/action-hud/controller.mjs - Action execution
modules/apps/action-hud/execution.mjs - Firearms
modules/items/firearms.mjs - Combat tools
modules/apps
Characters And Progression
- Hero sheet
modules/sheets/hero-sheet.mjs - Character creation
modules/apps/character-creation.mjs - Creation workflow
modules/apps/chargen - Progression catalog
modules/data/progression/catalog-provider.mjs - Progression authoring
modules/data/progression/authoring-services.mjs - Content creation
modules/data/progression/content-creation-service.mjs
Rules And Definitions
- Action resolution
modules/actions/resolved-action.mjs - Item rules
modules/rules/item-rules.mjs - Definition identity
modules/data/definitions/canonical-id.mjs - Definition validation
modules/data/definitions/validation.mjs - Compendium routing
modules/data/definitions/compendium-router.mjs
Campaign Records
- Datapad
modules/apps/datapad.mjs - Relations workspace
modules/relations/view.mjs - Relations service
modules/relations/service.mjs - Relations model
modules/relations/model.mjs - Relations storage
modules/relations/vault.mjs - Party data
modules/helpers/party.mjs
Other components
- Foundry user
Connections 31
- Foundry user → Veilrunner system: starts system
veilrunner.mjs - Veilrunner system → Hero sheet: registers sheets
veilrunner.mjs - Veilrunner system → Character creation: registers app
veilrunner.mjs - Veilrunner system → Action HUD: registers HUD
veilrunner.mjs - Veilrunner system → Datapad: registers app
veilrunner.mjs - Veilrunner system → Combat tools: registers apps
veilrunner.mjs - Veilrunner system → System settings: registers settings
veilrunner.mjs - Veilrunner system → Progression catalog: initializes catalog
veilrunner.mjs - Veilrunner system → Progression authoring: initializes authoring
veilrunner.mjs - Action HUD → Action execution: executes actions
modules/apps/action-hud/controller.mjs - Action HUD → System settings: reads preferences
modules/apps/action-hud/controller.mjs - Action execution → Firearms: uses firearm actions
modules/apps/action-hud/execution.mjs - Firearms → Item rules: checks item rules
modules/items/firearms.mjs - Hero sheet → Relations workspace: renders relations
modules/sheets/hero-sheet.mjs - Hero sheet → Action resolution: resolves owned actions
modules/sheets/hero-sheet.mjs - Character creation → Creation workflow: opens creation flow
modules/apps/character-creation.mjs - Character creation → Progression catalog: loads catalog
modules/apps/character-creation.mjs - Character creation → Progression authoring: uses authoring
modules/apps/character-creation.mjs - Progression authoring → Content creation: creates content
modules/data/progression/authoring-services.mjs - Progression authoring → Progression catalog: uses catalog
modules/data/progression/authoring-services.mjs - Content creation → Definition identity: builds canonical IDs
modules/data/progression/content-creation-service.mjs - Content creation → Definition validation: validates definitions
modules/data/progression/content-creation-service.mjs - Progression catalog → Compendium routing: routes definitions
modules/data/progression/catalog-provider.mjs - Progression catalog → Definition identity: builds canonical IDs
modules/data/progression/catalog-provider.mjs - Datapad → Relations workspace: renders workspace
modules/apps/datapad.mjs - Datapad → Relations service: reads relations
modules/apps/datapad.mjs - Relations workspace → Relations service: reads state
modules/relations/view.mjs - Relations service → Relations model: projects and transacts
modules/relations/service.mjs - Relations service → Relations storage: seals stored data
modules/relations/service.mjs - Relations service → Party data: uses party data
modules/relations/service.mjs - Action HUD → Party data: uses party context