1. Open Configure Settings → Custom Currency 5e → Manage Currencies as a GM.
2. Optionally choose Add Group for a region, faction, or kind of money.
3. Choose Add Currency in that group or in Ungrouped, fill in its definition, and save.
4. Open an editable actor sheet and enter an amount in the new currency field.

The standard keys pp, gp, ep, sp, and cp are reserved. Edit their existing entries to change their labels, abbreviations, rates, icons, or physical links. Standard denominations can be reverted or hidden, but cannot be deleted. Their coin weight follows dnd5e's settings.

Deleting a group offers a choice: cancel, remove just the group and move its currencies to Ungrouped, or remove the group and all assigned currencies.

Sheet Visibility hides selected denominations, including standard currency pills on Group sheets, without deleting balances. Show Linked Currency When Carried requires Physical Currency and overrides those choices. Actor sheets check items carried directly by the actor, outside bags or containers. Container sheets check their own contents and support standard denominations only.

Physical links accept non-container Items with stack quantity support. Containers, spells, Actors, and Journal Entries cannot be linked as coin stacks.

Duplicate matching stacks can be consolidated during sync to keep the quantity exact.

Standard denominations also sync with container currency fields when linked coins move into or out of a container. Custom coins can be stored in containers, but their currency fields appear only on actor sheets. The actor's synced balance counts coins carried outside bags or containers.

Changing a physical source refreshes existing linked stacks while preserving quantities and container locations. Same-type refreshes update the name, image, and system data. If the item type differs, only safe visual/source metadata is refreshed and Audit & Repair reports the mismatch.

Clearing a physical link preserves inventory items and removes their sync metadata. Disabling Physical Currency offers a choice to keep linked items or remove them from actors. Actor sync counts coin stacks outside bags or containers. Container sync supports standard denominations only.

Each currency has one stored global conversion value. Saving 1 source = X target changes only the source's value, which also changes its relationships with other currencies. It does not rewrite actor balances, item quantities, or price denomination keys.

Exchange Profiles apply only to exchanges in this module's Converter. Global rates, listed item prices, and how sheets calculate currency values stay the same. Applying an exchange updates the actor's balances.

To create a market, expand Exchange Profiles → Add Profile:

• Value ×: 1 is normal, 0.8 values the currency at 80% of its usual value, and 1.2 values it at 120%.
• Spread: splits the moneychanger's margin around each currency's local value. You sell below that value and buy above it; per-currency overrides are available.
• Set as current market: makes this profile the Converter's default. Users can choose another profile or base rates for an exchange.

The gp anchor carries no spread by default, unless explicitly assigned its own override. Profiles do not automatically apply to merchant modules or listed prices.

The Converter accepts positive whole-number source amounts and rejects same-denomination exchanges, insufficient funds, and results smaller than one target coin. Apply deducts the full source amount and credits the rounded-down target amount; fractional change is not returned. For example, a result of 3.75 credits 3 coins.

Use a currency or profile card's export button for one definition, a group's toolbar for Group Only or Group + Currencies, or Export All for all custom groups, currencies, and profiles. Each export offers Download .json and Copy to clipboard. Import accepts a file or pasted JSON.

Imports merge into the current setup. Overwrite replaces the conflicting definition; Rename keeps both under distinct keys; Skip leaves the existing definition alone. Reserved standard keys can only be renamed or skipped. References within the import follow renamed currencies and groups.

Export All is an economy-definition export, not a world backup. It excludes standard currency overrides, actor balances, sheet visibility and other module preferences, the current-market selection, and physical item links. Image paths are included, but image files are not bundled; make those assets available in the destination world.

Physical links are unset on import, including when overwriting an existing custom currency. Relink those definitions in the destination manager afterward.

Renaming a custom currency migrates actor balances, linked item flags, visibility entries, item price and NPC/vehicle cost denominations, and exchange-profile references to the new key.

Deleting a custom currency removes its actor balances and clears linked-item metadata while keeping physical inventory items as ordinary items. Prices using a deleted or missing denomination fall back to gp; their numeric price values are not converted.

Audit & Repair checks invalid physical links, stale visibility/group references, orphaned actor flags and item metadata, invalid price denominations, and mismatched physical stacks. Stack repairs use the current actor or supported container currency amount as the quantity to match. Source-link and item-type mismatches are also checked; ambiguous matches and unsafe type changes need manual review.

Open Configure Settings → Custom Currency 5e. World settings apply to the world; Debug Logging is saved for the current client.

Confirm that the world uses a supported dnd5e version and that Custom Currency 5e is enabled, then reload the client. If a denomination is missing, check Sheet Visibility and the linked-inventory override. The Converter button requires an editable actor sheet with a visible custom currency.

For sync problems, confirm that Physical Currency is enabled and the linked item still exists and has a quantity field. Use Audit & Repair to inspect missing or outdated item links and mismatched coin quantities. For weight problems, also check dnd5e's currency-weight setting.

Enable Debug Logging and inspect the browser console for messages prefixed with custom-currency-5e |. If another module changes sheets, price fields, or currency behavior, reproduce the issue in a test world with only Custom Currency 5e enabled.

• Fixed linked world currency items losing their currency identity when dropped onto actor or owned container sheets. Dropped stacks retain the configured link for carried-item visibility and quantity sync.

• Added regional exchange profiles and portable import/export for custom currencies, groups, and profiles.
• Added custom denominations to NPC and vehicle cost fields, with rename/delete cleanup and audit coverage.
• Hardened physical item sync, source refresh, import conflicts, converter validation, and audit repairs.
• Corrected custom currency weight in metric worlds and refreshed derived values across connected clients after definition changes.
• Recorded startup, manager, diagnostics, audit, and fixture checks on Foundry VTT 14.367 with dnd5e 5.3.3.

See CHANGELOG.md, included with the installed module, for full release details.

Recorded testing: Custom Currency 5e 14.1.4 has recorded live checks for startup, settings/assets, manager rendering, diagnostics, audit, fixture automation, encumbrance, and item-value refresh on that baseline. This does not establish compatibility with every later system version or third-party sheet.

• Native dnd5e tools: the system's currency manager, awards, transfers, and conversion workflows remain oriented around standard denominations. Use this module's Converter for custom exchanges.
• Containers: custom coin items can be carried inside containers, but there are no custom container currency fields. Actor balances and carried-item visibility count items carried directly by the actor, outside bags or containers.
• Markets: exchange profiles apply in this module's Converter; automatic merchant integration and transaction logs are not implemented.
• Other sheets and modules: replacements for native sheet markup, price fields, currency calculations, or inventory behavior may need separate integration. Compatibility with every combination is not established.