Skip to main content
All CollectionsPlayers
Importing a Character
Importing a Character

How to import a character from JSON or D&D Beyond

Updated over 3 months ago

You can quickly import or export a characters in a few different ways.

D&D Beyond Import

Follow these steps to import a character from D&D Beyond.

1. In D&D Beyond, open the character sheet for the character you'd like to import.

2. Make sure the character is marked as publicly viewable. Manage > Character Settings > Character Privacy: Public.

3. On the character sheet, click the SHARE button at the top.

4. Copy the link from the sidebar (not the link to the page or PDF).

5. Open the Alchemy desktop app. If you don't already have it, you can download it for your operating system here: Windows, Mac, Linux. The desktop app v1.1.0 or higher is required to use D&D Beyond character import.

6. Navigate to your Library > Characters and then click the downward triangle next to CREATE CHARACTER.

7. In the resulting menu, click on Import from Beyond.

8. Paste the ddb.ac link you copied earlier into the field.

9. Click the IMPORT CHARACTER button and wait a few seconds for your character to appear in your library.

You can also import a Character into the Premades tab of a universe in the same way.

Note that this feature is experimental and may not work for all characters. Please report any bugs to us using the built-in help. If you're a developer and you'd like to help, you can find the source code and bug tracker for this feature on GitHub in the alchemyrpg/ddb2alchemy repo.

Many thanks to community member krsr for their help in bringing this feature to life quickly. ❤️

Export JSON

Follow these steps to export an NPC from a universe module to an Alchemy JSON file.

1. Click on the NPC.

2. Click on the lock switch in the top left of the character sheet.

3. Once in edit mode, click on the three dots to the right of the lock switch.

4. Click on the Export JSON menu option.

5. Choose where to save the file.

The JSON exported for the character will include all of their core stats as well as their actions, items, and spells.

Similar steps can be followed to export a player character.

Import JSON

Follow these steps to import a character from an Alchemy JSON file.

1. Navigate to a Universe.

2. Click on the NPCs tab.

3. Click the triangle on the right side of the CREATE NPC button.

4. Click on Import JSON.

5. Select a JSON file with one or more NPCs in it. (See below for information about the structure of this file).

The character(s) will be imported and added to the active module.

Similar steps can be followed to import Alchemy JSON to your character library or the premade characters of a universe.

Developers

You can read documentation about the expected JSON in our developer documentation.

Did this answer your question?