initial commit

README.md

@@ -0,0 +1,31 @@
+# Daggerheart Importer
+
+A Foundry VTT module for the **Daggerheart** system that allows you to easily import Adversaries and Environments from text statblocks (e.g., from PDFs or simple text files).
+
+## Features
+
+-   **Bulk Import**: Paste multiple statblocks at once.
+-   **Smart Parsing**: Automatically detects sections for Stats, Attacks, Features, Experiences, and Motives.
+-   **Vertical & Columnar Support**: Handles various copy-paste formats including vertical "HP & Stress" columns.
+-   **Compendium Matching**: Automatically scans your world compendiums to match Features by name, allowing you to link to existing data instead of creating duplicates.
+-   **Preview UI**: Review parsed data before importing. Toggle found features on or off.
+-   **Daggerheart Styling**: A clean, themed interface matching the system aesthetics.
+
+## Usage
+
+1.  Open the **Actor Directory** tab in Foundry VTT.
+2.  Click the **"Import Statblocks"** button in the header.
+3.  Choose **Adversary** or **Environment** from the dropdown.
+4.  Paste your text into the box. Separate multiple blocks with `-----`.
+5.  Click **Review Data**.
+6.  Verify the parsing in the preview window.
+7.  Click **Confirm Import**.
+
+## Copy-Paste Tips
+
+The parser is designed to be robust, but for best results:
+-   Ensure the **Name** is on the first line.
+-   Ensure **Tier X [Type]** is on the second line (e.g., "Tier 1 Standard").
+-   Keep headers like **Features**, **Experience**, and **Motives & Tactics** on their own lines if possible.
+
+