Welcome Adventurers!

It only takes a few steps to bring your TitanCraft miniatures into the realm of TaleSpire.

Let's begin.

Please note that you do not need a TitanCraft account to play with miniatures created by other players, even if you are the GM. An account is only required for sharing your creations with a campaign

Linking your TitanCraft Account

In order to bring your creations into TaleSpire, first you need to link your account.

We start in TitanCraft

Browse to your user drop-down > "TaleSpire" to find your TaleSpire related info.

Click the button on the right side of the API Token box to copy your token to the clipboard. This token is what gives TaleSpire the right to fetch your created miniatures.

Remember, never share your API token with anyone. Your TitanCraft account can only be associated with a single TaleSpire Account at the same time.

And now, in TaleSpire

Click the Settings icon in the top right.

In the newly opened Settings window, click the last tab to go to the "Community Content" settings.
Scroll down to the "3rd Party Miniature Providers" section, and click the little pen icon to the right of the "TitanCraft Access Key."

Nearly done! Paste your API token in the box, and click OK to complete.

Adding your miniature to a campaign

Now that your account is linked, you can choose which miniatures are shared with which campaign.

There is no limit: you can link each miniature to multiple campaigns.

The UI is slightly different for GMs than it is for the players, so feel free to jump to the bit that suits you best (or read them both if you fancy!)

Adding miniatures as a player

First, choose the campaign you are playing and click "Play." This will take you into that campaign.

Then, down at the bottom of the screen, there will be a little tab you need to click on to open the TitanCraft panel.
If it's not immediately visible, press the Spacebar to show the UI.

After a few seconds, a list of your miniatures will appear. To start with, all of the images will be gray. This is because they are not yet linked to the campaign.

Simply click an image to link the miniature. It will then begin to download.
Once the download is complete, TaleSpire will do a couple of seconds of processing, and then the image will gain color. Your miniature is now linked and ready to use!

Unlinking a miniature

If you ever want to unlink a miniature from the campaign:

Open the TitanCraft panel using the tab.
Find the miniature you want to unlink.
Click the small chain icon in the top left. The picture will become gray showing that the mini is no longer linked.

And that's it!

As only GMs can spawn creatures, your work is now complete! Your miniature will be automatically downloaded to all your friends in the campaign, including your GM, who will then be able to spawn it.

If you are curious about what it looks like for GMs, keep reading. If not, then thanks for stopping by. Best of luck on your adventures!

Managing miniatures as a GM

As overlords of the campaign, only GMs can spawn creatures in TaleSpire. This goes for ones made in TitanCraft too.

This means that while both you and your players can share your creations with the campaign, they will need a GM to bring them into the world.

Luckily the process is extremely simple but first, let's look at how your share miniatures with the campaign.

First, choose the campaign you are playing and click "Play." This will take you into that campaign.

Next, click on the Library tab at the bottom of the screen to show the Library panel. As usual, if it's not immediately visible, simply press space to show the UI.

On the left of the "Open Library" tab, you should see some tabs. By clicking the one with the TitanCraft logo, you will switch to the TitanCraft panel.

On the far left of the TitanCraft panel, you will see one or two categories depending on whether you have linked your account or only some of your players have.
The top icon switches to the "Your TitanCraft Library" category. It lets you link the miniatures from your TitanCraft account.
The bottom icon switches to the "Campaign Linked" category. It allows you to see and spawn the miniatures linked by any member of the campaign.

Managing your own TitanCraft minis

The "Your TitanCraft Library" section is almost identical to the view the players have. Your TitanCraft miniatures will appear here.

To start with, all of the images will be grey. This is because those miniatures are not yet linked to the campaign.

To link a miniature, simply click on it. It will begin to download. When the download is complete, the image will gain color.

You can now click on it to spawn that miniature as a creature!

All downloaded miniatures are also available in the regular asset library in the Creatures category, under the TitanCraft folder.

Managing all the miniatures linked to the campaign

In the "Campaign Linked" section, you will find all the TitanCraft miniatures linked to your campaign by any player or GM.

The images here will be grayed out until the download completes. Once downloaded, you can click any miniature to spawn it as a TaleSpire creature.

As with your own miniatures, all downloaded miniatures are also available in the regular asset library in the Creatures category, under the TitanCraft folder.

And there you have it. Drop us a note on the Discord or https://feedback.talespire.com/ if you experience any problems with the integration, but aside from that, we hope you enjoy forging some new adventures.