Verifying access…
Access denied.
← Back to homeAPI Showcase
Try the Creator API Here. Every request goes through the public endpoints using your own Bearer token.
Stored in
sessionStorage only — never sent to the server by this page.API Rate Limits
Slots allocate per-minute capacity · enter your key and click Refresh to see live quota
compose
—
recolor
—
dress
—
undress
—
slice
—
check
—
roll
∞ unlimited
lookup
∞ unlimited
Enter your API key above and click Refresh to see live quota.
Debug Log 0 entries
POST
/api/creator/utils/check
Validate an .item or .generator JSON record against the lexicon.
Resolves the handle → DID → PDS, fetches record(s), displays a visual summary, and runs validation.
▸ Raw JSON / manual check
POST /api/creator/utils/recolor Apply sentinel-marker recolor to a base layer. Returns the recolored image and the extracted subtractive mask.
Lists all
equipment.rpg.item records — click one to load its blob and colorway automatically.Loading blobs…
No image loaded
No map loaded
POST
/api/creator/utils/dress
Merge an equipment.rpg.item into a actor.rpg.generator, returning the combined generator ready for compose.
Click an item to select it and populate color pickers from its channel defaults.
▸ Raw JSON (advanced)
POST
/api/creator/utils/undress
Remove a layer from an actor.rpg.generator by category. Complement of /dress — also strips the slug from gen.items[].
› Raw JSON (advanced)
POST
/api/generator/compose
Render a player’s sprite from their live generator record. Pass a DID or handle to get their current look, or pass modified layers from /dress or /undress to preview equipping or removing an item. The server fetches all blobs. Returns binary PNG directly — no base64 needed.
► Override layers (optional — paste output from /dress or /undress)
POST
/api/creator/utils/compose/raw
Composite raw layer PNGs (supplied as base64) into a 144×192 sprite. For asset creation workflows when you have locally-produced PNGs that don’t yet exist on a PDS — e.g. previewing a freshly recolored item before publishing. See /api/generator/compose above for the DID-based path.
Loads the
actor.rpg.generator record and lists all layers. Click Fetch all blobs to download each PNG to your browser (they’re then base64-encoded and sent to the API). Or use /api/generator/compose above for the DID-based path where the server fetches blobs for you.▸ Manual layer builder (advanced fallback)
POST /api/creator/utils/slice Cut a sprite sheet into the individual PNG frames it contains, using the sprite record’s width, height, rows, columns, and per-frame sizing. Great for animating new characters or previewing every pose from a single sheet.
A sprite sheet is one PNG holding every pose in a grid. This endpoint does the cutting server-side, so instead of opening an image editor you get each cell back as its own PNG. The grid comes from the .sprite record’s columns, rows, frameWidth, and frameHeight.
How frames are numbered
Indexing starts at 0. The formula is index = row × columns + col, and frames run left-to-right across each row.
For the standard 3 × 4 sprite sheet:
- Rows map to facing direction:
0= down,1= left,2= right,3= up. - Columns map to pose:
0= step,1= idle/standing,2= opposite step. - The default standing pose is row 0, col 1, which is frame 1.
A walk cycle uses the row’s standard order 0, 1, 2, 1. If a sheet is not 3 columns wide, the API still reads the real grid from the record and image dimensions instead of assuming a standard layout.
Resolves the actor’s
actor.rpg.sprite record from their PDS, downloads the sheet blob, and fills the JSON below for you. Loads your own sprite automatically on first open.The record supplies the grid. When you load by handle the sheet itself stays on the PDS — the API fetches the blob for you, so you only send this small record.
Bulk selection, leave blank to use the single
Frame/Row+Col below. all returns every frame; a list like 3,4,5 returns just those (that example is the whole left-facing walk cycle).datauri drops straight into an <img src>; base64 is the bare payload for writing files or uploading as a blob.One frame by index. Defaults to
1, the standing, viewer-facing portrait pose on a 3-column sheet.The same cell addressed as direction (row) and step (col) —
0 / 1 is that portrait pose. See the labeled sheet reference above.Precedence:
Frames wins whenever it is set (all or a list). Clear it to target a single frame with Frame or Row/Col.POST /api/creator/utils/roll Resolve a character’s roll formula or dice pool for any named check — D&D 5e, DCC, WoD, Cyberpunk 2020, and any custom stat system.
Looks up a character’s actor.rpg.stats record and resolves the given check name to a dice
formula (1d20+N, Xd10) plus metadata. Designed for dice bots and social tools.
Handle or DID of any registered character with stats.
Natural language check — skill, ability, save, or stat. Use
+ for WoD pools.► Example checks by system
| System | Check input | Result shape |
|---|---|---|
| D&D 5e | perception | 1d20+N |
| D&D 5e | str save / strength saving throw | 1d20+N |
| D&D 5e | initiative | 1d20+N |
| DCC | reflex / fortitude / will | 1d20+N |
| DCC | agility / agi | 1d20+N |
| DCC | spell check | d20+N |
| WoD (Mage / VTM) | perception | Xd10 |
| WoD (Mage / VTM) | wits+perception or wits + perception | Xd10 |
| Cyberpunk 2020 | int / ref / cool / Intelligence | 1d10+N |
POST /api/creator/utils/lookup Look up raw stat values for any character — HP, AC, Speed, Spell DC, or any named stat across all RPG systems.
Handle or DID of any registered character with stats.
Combat
Ability scores
Walk the stats object directly — e.g.
dnd.combat.ac or reverie.vitality.Narrows to
{system}.{category}.{stat} when set.