User Manual

Import & Export

Character Export (JSON)

From the character sheet's More menu, select Export JSON. This downloads a self-contained JSON file with all character data including resolved entity names (not just IDs). The file can be used for backup or sharing.

FoundryVTT Export

From the character sheet's More menu, select Export to FoundryVTT to download a FoundryVTT v13 compatible Actor JSON file. This export maps all character data into the Foundry format:

Ability scores and modifiers

Skills and proficiencies

Spells (with level, school, and components)

Equipment and inventory items

Class features and traits

Proficiencies (armor, weapons, tools, languages)

To import into FoundryVTT:

1. In FoundryVTT, create a blank character actor

2. Right-click the actor and select Import Data

3. Select the downloaded .json file

No additional FoundryVTT modules are required for import. The export is compatible with FoundryVTT v13 and the standard D&D 5e system.

FoundryVTT Import — Sync Existing Character

From the character sheet's Settings menu, select Import from FoundryVTT. Upload a FoundryVTT actor JSON (export from Foundry by right-clicking an actor and choosing Export Data) and the import dialog parses the file. After upload, you'll see a checklist of which sections are present in the file. Tick the sections you want to apply and click Import Selected.

Sections you can sync:

Ability scores, save proficiencies, skill proficiencies, languages, weapon/armor proficiencies, tool proficiencies
HP / temp HP, death saves, exhaustion, inspiration, XP, currency, spell slots
Class levels & subclass (additive only — D&D Manager classes not in the FVTT file are kept, never deleted)
Hit dice used, feats, known spells
Item quantities, charges, equipped/attuned state, and new items not already on the character

Each section has its own checkbox so you can selectively re-import (e.g. just refresh HP and currency after a session, leave everything else alone). Sections missing from the file are disabled with "(not in file)".

FoundryVTT Import — Create New Character

On the Create Character page, you'll see a card at the top: "Import from FoundryVTT". Click it instead of stepping through the wizard. Upload an actor JSON and the dialog matches race / subrace / background against your game data, then creates a new character with every section imported.

Race matching tries the FVTT name as a Race first, then strips suffixes like "(Legacy)", then tries it as a Subrace (a subrace match populates both the parent Race and the Subrace). When matching fails, the dialog surfaces Race / Subrace / Background dropdowns so you can pick manually before the Create button enables.

Class features are auto-seeded: a Barbarian 5 import comes in with Rage, Reckless Attack, Danger Sense, plus all subclass features through level 5. Weapons imported as custom items get full stats (damage dice, properties, range, magic bonus) populated from FVTT data — the damage type is inherited from the base item (e.g. "greatsword" → slashing). Max HP is recomputed from class HitDie + CON when FVTT leaves it null (Foundry derives it on the fly).

"Unarmed Strike" in the FVTT inventory is skipped on import — D&D Manager derives it automatically as an attack for every character.

Heuristic item matching. The importer scores every FVTT inventory item's name against the seeded Items table and your accessible homebrew (your own UserItems plus items others have shared) using Jaccard similarity on normalized tokens (lowercase, drop pure-digit tokens, stem trailing 's', sort). Items scoring ≥ 89% auto-link silently — handles things like "Crossbow, Light" ↔ "Light Crossbow", "Crossbow Bolts" ↔ "Crossbow Bolt", "Ink (1 ounce bottle)" ↔ "Ink (1-ounce bottle)". An exact-name match against your library wins outright over a seeded match. Items scoring below the threshold surface a per-item picker with the top 5 candidates (labeled with score; homebrew candidates tagged with "(homebrew)") plus a "Create Custom Item" option.

FVTT description text is sanitized on import. DDB-Importer's HTML (paragraphs, inline color styles, external dndbeyond.com links, CSS classes like Core-Styles_Core-Body) is stripped to plain-text paragraphs before being saved as the item or feature's description. The result is the same paragraph-array format the seeded data uses, so it renders consistently.

Class & subclass picks are imported. Beyond the standard class features that get auto-seeded from game data (Pact Magic, Sneak Attack, etc.), the importer now also captures user-picked options bundled with class features: Pact of the Blade and the other Pact Boons, individual Eldritch Invocations, Fighting Style choices, Metamagic options, etc. These appear as feature rows with Source = "class" or "subclass" on the Features tab.

Item Active Effects are imported. DDB-Importer carries item bonuses (Cloak of Protection's +1 AC and +1 save, Rod of the Pact Keeper's +1 spell attack, etc.) as Active Effects rather than inline magic-bonus fields. The importer now walks each item's effects[] array and surfaces the recognized integer bonuses on the resulting custom item: AC bonus, saving throw bonus, spell attack bonus, and weapon attack bonus. The character sheet's AC and save calculations pick these up automatically when the item is equipped. Non-numeric values (dice formulas), speed/HP/ability/skill changes, and conditional triggers ("while raging") aren't imported — those would need to be re-created as buffs or features.

Feats now get mechanical effects on import. When an imported feat name matches a known entry in the feat registry, the importer applies the static portion of its effects automatically (Mobile's +10 speed, Alert's +5 initiative, Tough's +2 HP/level, Heavy Armor Master's +1 STR, Dual Wielder's +1 AC, Lucky's 3-use Luck Points resource, Observant's +5 passive Perception/Investigation, etc.). For feats that require user picks (Resilient ability, Skill Expert expertise, Magic Initiate / Fey Touched / Shadow Touched spell picks, etc.), the static parts apply and a warning prompts you to open the Features tab and re-grant via Add Feature to set the picks.

Spell names with (Legacy) suffix work. DDB-Importer suffixes every spell with " (Legacy)" or " (2024)". The importer retries the lookup with the parenthesized suffix stripped, so "Eldritch Blast (Legacy)" matches the seeded "Eldritch Blast". Imported spells default to IsPrepared = true (only set to false when FVTT explicitly says false), so known casters' spells appear in the default Prepared view filter.

Character Transfers (Account → Account)

To hand a character off to another player, open their character sheet's Settings menu and choose Transfer to Another Player. Enter the recipient's username or email, optionally include a note, and send. The recipient sees the request on their Transfers page and can Accept or Decline. You can Cancel a pending transfer before they respond.

On Accept, ownership changes and the campaign membership is preserved only if both you AND the recipient are members of that campaign. Otherwise the character is moved out of the campaign so the new owner isn't stuck with a character they can't access. A "transferred" snapshot is created on the character's history.

Editing Custom Items From the Sheet

Inventory rows now have inline action icons:

Pencil (custom items only) — opens the magic-item editor with all fields prefilled. Save changes; new damage dice, properties, AC bonus, charges etc. flow through to the Attacks table immediately.
Wand icon (built-in items only) — "Convert to Custom". Clones the seeded item (PHB Longsword, etc.) into a new homebrew item owned by you, so you can edit it freely. Useful for turning a found weapon into a "+1 Longsword of Awesome".

The same Edit / Convert buttons appear in the Weapon Detail dialog (next to the Customize header). Editing custom To Hit / Damage bonuses there now refreshes the dialog's displayed totals live — no need to close and reopen.

Shared homebrew items. Items in your "My Items" library can be carried by multiple characters. If you edit a homebrew item held by ≥2 of your characters, a banner warns that changes apply to all of them and offers "Edit only this character's copy" — which clones the item and swaps the current character to the clone, leaving the others untouched.

My Items Library

Settings → My Items is your homebrew item library. Every UserItem you've created or auto-created during FVTT import lives here.

"Used By" column shows each item's holders as clickable character chips. Empty = orphan (safe to delete).
"Merge Duplicates" button appears when you have same-named items. Survivor = whichever copy a character is currently holding (else the most-recent row). All `CharacterItem` references on losing duplicates are repointed to the survivor before deletion.
"Remove Orphans (N)" button bulk-deletes items with zero holders in one click.
Delete protects against shared items: held by your characters → second confirmation listing them + force delete; held only by another user's character → blocked entirely (deleting would yank it from their inventory, so the system refuses).

Deleting a Character

Delete from the character sheet's Settings menu or the trash icon on the character card.

Confirmation dialog lists every custom item on the character's inventory with checkboxes.
Each item defaults checked (will also be removed from your library when the character goes).
Items held by another of your characters are disabled with a note (they'll stay in your library because someone else has them).
All / None buttons toggle every eligible checkbox at once.
Uncheck anything you want to keep. The button text dynamically reads "Delete Character + N item(s)".

Character snapshots (version history) are not deleted — they remain for audit. All other child data (items, spells, features, languages, proficiencies, class levels, buffs, resources, companions) cascades with the character.

Foundry Bridge Tokens

At Settings > Foundry Tokens, you can review and revoke the access tokens used by the (planned) D&D Manager Foundry module to talk to this server. Tokens are issued automatically when you sign in from the Foundry module — there is no "generate" button. Each token lasts 30 days from last use; idle tokens expire automatically. Revoke a token to disconnect that browser/device immediately.

The Foundry module itself is in development. Until it ships, this page will show an empty list — and that's fine. The plumbing (token issuance, CORS, bearer auth) is already running so the module can plug in as soon as it's released.

CSS Skin Export/Import

On the Sheet Skin page, use the Export button to download your custom CSS as a .css file, or Import to upload one (max 100 KB).

Admin: Database Backup

Administrators can download the entire SQLite database file from Admin > Data Export. This is a complete backup including all characters, campaigns, game data, and user accounts.

Admin: Bulk Character Export

Administrators can export all characters from all users as a single JSON file from the Data Export page. Each character includes full resolved data.

PDF User Manual

Click the Download PDF button at the top of this manual's sidebar to generate a styled PDF version. The PDF features a D&D fantasy theme with a dark cover, gold accents, chapter icons from game-icons.net, styled tables, and tip boxes.

Each PDF is unique — cover art and chapter icons are randomly selected from a pool of 25 fantasy-themed icons each time the manual is generated.