The Best Token Generator for Foundry VTT

Make a token from an actor's portrait right in Foundry: a frame, a background, the head, weapon or wings over the frame, or a subject for the Dynamic Token Ring. Crop and resize the actor portrait too. Free, MIT licensed, the same editor as on the website.

Install

Foundry VTT V13 or V14. In Setup → Add-on Modules → Install Module paste the manifest URL:

https://thebesttokengenerator.joxter.me/foundry/latest/module.json

Then enable it in your world: Game Settings → Manage Modules. Updates come as usual, with the Update button in Setup.

Open the editor

Right-click an actor in the Actors sidebar → Token and Portrait.
On the actor sheet: the ⋮ menu in the header (sheets like dnd5e) or the Token and Portrait button in the header (older sheets like pf2e).
From a macro: game.modules.get("best-token-generator").api.open(actor)

Available to the actor's owner with the Upload New Files permission (Trusted Player and above by default).

The editor in a Foundry window: a cockatrice token, its wings, head and tail over a stone frame, and the token on a battle map — How this token was made: video on YouTube. Cockatrice art: The Illustrated Bestiary by Gourdin Konbo Club, CC BY-SA 4.0; the screenshot is under the same license.

What it does

Token: The portrait in a frame on a background, with brushes: Above frame for parts sticking out over the edge, Under frame, Erase and Restore. Ready-made frames, or your own from Foundry's file picker. A preview on a battle map shows how the token will look on the scene.
Dynamic Token Ring: Tick Foundry dynamic ring: no frame or background, the portrait sits inside the ring and the parts you mark “above” pop out over it. The preview uses your world's ring in the prototype's colors.
Save token: Writes worlds/<world>/tokens/<actor>-<id>-token.webp (with the ring: -subject.webp) into the actor's prototype token and its tokens on the current scene, and turns the ring on or off to match. Next time the editor opens with your last edit (brushes, positions, frame and background; not the undo history).
Portrait: The actor's image, separate from the token: crop it (free, 1:1, 4:5, 3:4, 2:3) and set the size. Save portrait writes <actor>-<id>-portrait.webp and sets it as the actor image; the next crop starts from the original picture.

The module writes only to worlds/<world>/tokens/, one set of files per actor, overwritten on each save. Everything runs inside your Foundry: no analytics, your images never leave it.

Feedback

Bugs and ideas: Discord. A screenshot and errors from the browser console (F12) help a lot.

Changelog

1.0.0, November 1, 2026

First release for the official Foundry package list: a cover, a screenshot and this page in the manifest. The editor is the same as in 0.3.9.

0.3.9, November 1, 2026

Foundry V13 support.
The window is taller (800 px, never larger than the screen) and can be resized in height in V13 too.
The Actors sidebar menu entry works in V13.
MIT license.

0.1.0 to 0.3.8, October 23 to 30, 2026

The editor in a Foundry window for an actor: frame, background, brushes above and under the frame; Save token into the prototype token and the actor's tokens on the current scene.
Reopening the editor brings back your last edit.
Dynamic Token Ring: a subject for the ring, previewed with your world's ring at Foundry's scale.
The Portrait tab: crop and resize the actor image separately from the token.
The Token and Portrait button on older sheets (pf2e and others); a macro API.
Canvas: the wheel pans, Cmd/Ctrl+wheel zooms, + and − resize the selected image.

License

MIT. The name and logo are not covered. The battle map in the preview: Map by 2-Minute Tabletop, CC BY-NC 4.0. Frame textures: Poly Haven, CC0.

Made by Joxter.