Overview
A layered, non-destructive token image editor for Foundry VTT.
Click any actor portrait to open the editor, compose a token from multiple image layers, frames, and rings.
Learn more about it on it's documentation page.
Features
Layered Editing
- Non-destructive layer stack: reorder, hide, lock, duplicate, or delete layers at any time without affecting the original images.
- Multiple layer types: image layers, frame/ring layers, painted alpha mask layers, and background layers.
- Undo / Redo: 20-snapshot history (Ctrl+Z / Ctrl+Shift+Z).
- Layer persistence: the editor state is saved to actor flags and restored the next time you open the editor.
Editing Tools
| Tool | Description |
|---|---|
| Move / Transform | Manipulate and resize the layer. |
| Magic Lasso | Quick removal of similar coloured areas. |
| Freehand Lasso | Draw a freehand path to cut a region from the layer. |
| Delete | Feathered delete. |
| Clone / Heal | Clone bits of the image to fix up your tokens. |
| Liquify / Warp | Warp (pull pixels) or Blend/Smudge modes with adjustable brush size and strength. |
| Paint Mask | Paint your own custom mask. |
Mask System
Multiple masks can be stacked per layer:
- Alpha / Mask Image: luminance-based mask from any image (white = visible, black = hidden)
- Ring Shape: masks to inside or outside a configurable geometric ring
- Frame Layer Mask: Inner Window (Ray Cast) - clips to the inner window of a frame layer
- Frame Layer Mask: Outer Shape (Contour) - clips to the outer silhouette of a frame layer
Rings & Frames
- Built-in frame browser with bundled frames (marble variants, ShadowDark, inner shadow)
- Custom frames - add your own PNG/WebP frames
- Favourites and Recent tracking in the frame browser
- Programmatic rings - configurable circle, square, or hex shapes with stroke width, stroke colour, stroke opacity, glow colour, inner feather, and mask mode (decorative/clip inside/clip outside)
- Disposition-based auto-ring - automatically applies a Friendly/Neutral/Hostile ring when first opening an actor
- Foundry Dynamic Ring support - preview Foundry's native ring system without baking it into the export
- Oversized ring allows the token to spill out into surrounding spaces
Clipboard & Paste
- Paste images from the system clipboard (Ctrl+V) directly as a new layer
- Pasted images are uploaded to a configurable paste folder
Wildcards
- Detects wildcard token paths automatically
- Saving creates a new numbered variant without changing the wildcard glob path
Batch Tokenize
- Right-click any compendium pack to open the Auto Token Compendium dialog
- Process all actors or only those without a token image