32 lines
2.1 KiB
Markdown
32 lines
2.1 KiB
Markdown
# Daggerheart Custom Attribution Sources
|
|
|
|
A Foundry VTT (Version 14) module for the **Daggerheart** system that allows Game Masters to add, update, and remove custom item attribution sources directly from the module settings.
|
|
|
|
## Features
|
|
|
|
- **No Overwrites**: Safely registers custom sources to the system `CONFIG.DH.GENERAL.attributionSources` configuration without altering or affecting system defaults or attributions from other modules.
|
|
- **Modern UI/UX**: Built using Foundry VTT v14's modern `ApplicationV2` interface with a dark layout matching Daggerheart's crimson and gold design aesthetics.
|
|
- **Dynamic Configuration**: Add source groups (e.g. `Forevermore`) and nest multiple values inside them (e.g. `Campaign - Forevermore`).
|
|
- **Autocompleter Integration**: Custom attributions automatically populate autocomplete lists when editing any item's attribution details.
|
|
|
|
## File Structure
|
|
|
|
```text
|
|
dh-attribution-sources/
|
|
├── module.json # Module registration and compatibility manifest
|
|
├── scripts/
|
|
│ └── dh-attribution-sources.mjs # Module entrypoint & ApplicationV2 form logic
|
|
├── styles/
|
|
│ └── dh-attribution-sources.css # Crimson & Gold CSS styles for the settings dialog
|
|
└── templates/
|
|
├── footer.hbs # Save and Reset buttons template
|
|
└── settings.hbs # Layout template for editing groups and nested values
|
|
```
|
|
|
|
## How to Install & Use
|
|
|
|
1. Ensure the `dh-attribution-sources` directory is placed inside your Foundry VTT `Data/modules` folder.
|
|
2. Launch Foundry VTT, open your game world, go to the **Manage Modules** tab in the sidebar, and check **Daggerheart Custom Attribution Sources**.
|
|
3. In the sidebar under **Configure Game Settings** -> **Daggerheart Custom Attribution Sources**, click the **Manage Custom Sources** menu.
|
|
4. Add source groups and values, configure their labels, and click **Save Settings**.
|
|
5. Edit any item sheet, click the **Attribution** icon in the header, and begin typing in the source field to see your custom sources appear as autocomplete recommendations.
|