The Library
The Library is your stash of reusable art, at /library. Import once, use in
any campaign.
| Kind | Used for |
|---|---|
| Maps | Battle map images |
| Tokens | Character and monster art |
| Objects | Scenery placed on maps |
| Textures | Tiling surfaces for map foundations |
Modules can also ship asset packs, which appear alongside your own.
Adding art
Upload takes one file or many. Folder takes a whole directory, including everything nested inside it. Or drop files, folders or a .zip anywhere on the Library page — a drop does exactly what Upload does.
A .zip is opened in your browser and each image in it is uploaded, keeping the folders it was zipped in. Anything that is not an image — a readme, a PDF — is skipped, and a notice names what was left out.
Uploads go straight from your browser to storage, so a folder of large battle maps does not stall the page. A few at a time run in parallel; the rest wait their turn rather than opening hundreds of connections at once.
Details opens the report: every file, what happened to it, and the reason for anything that failed. Failures can be retried on their own without re-uploading what already worked.
Sort orders the Library by when things were last modified (newest first, the default — so what you just uploaded is at the top), when they were added, or by name. Renaming, retyping or retagging something counts as modifying it. Your choice is remembered in this browser, and the texture pickers — a drawing's Fill and a map's Foundation Texture — list My Textures and Library the same way, with their own Load more.
If you close the tab mid-import, the queue survives. Reopening the Library offers to resume it, and nothing already uploaded is sent twice.
Folder names are worth keeping
If your art is filed under battlemaps/, tokens/ and so on — on disk or
inside a zip — the folder names come along with it and help sort what you upload. You do not have to organise
anything first — it just helps if you already have.
How things get sorted
Every upload is classified: which of the four kinds it is, and what tags describe it.
Some of that is measured directly from the image and is simply true — its proportions, whether it has a transparent background, whether it tiles seamlessly. The rest is a judgement, and if you have configured an AI provider it is made by a model. Without one, the Library still sorts by shape alone, which is better than nothing and is not always right.
Tags come from a fixed vocabulary rather than being invented per image, so
searching for orc finds everything tagged orc — and not the orchard.
Needs review
Anything the classifier was unsure about, or never looked at, lands in Needs review. Each row says why, and you can correct the kind and the tags in place.
A correction is permanent. Once you have set something by hand, no later re-classification will overwrite it.
If a row says shape only, no model classified it — the text after that says whether a provider was configured and, if one was, what it said when it declined. That is usually a missing API key or a model name that has been retired.
Searching
Search matches names as a substring and tags exactly, so partial typing finds what you are part-way through remembering without dragging in everything that merely contains those letters. Filtering by tag requires all the tags you pick.
Sharing
Each item is visible to you, to everyone on the deployment, or to a campaign. Your own uploads are yours by default.
Storage limits
There is a cap on how many items and how many bytes one account can store. The defaults are generous and you will be told if you reach one.
Importing from a server folder
Self-hosted deployments can import directly from a folder on the server, which is much faster than uploading for a large collection already sitting on that machine. It is off unless the operator turns it on, restricted to administrators and to a folder they nominate, and the button is hidden where it does not apply.
Where images live
Uploaded images are stored in cloud object storage and served to your campaign members.
An image URL is currently a link that works for anyone who has it. Do not treat uploaded art as private. ‹This changes when private image storage ships.›
Art attached to a specific character or token — portraits, alternates, tokenizing, background removal — is Artwork, which is a separate thing.