initial commit

README.md

@@ -0,0 +1,32 @@
+# 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.