Troubleshooting
- I get 401 unauthorized on every call
- My map id returns 404 map_not_found
- 400 “size: too small for N rooms”
- 400 “knobs.decay: needs gen-1.2.0 or later”
- 422 generation_failed
- The same seed gave me a different map
- My drawing is misaligned
- Walls cover props, or props show through walls
- The browser says the atlas canvas is “tainted”
- Calling map endpoints from the browser
- Images look blurry
- The download is huge
- I asked for a .glb model or a preview and got 404
- Still stuck?
I get 401 unauthorized on every call
- The header must be exactly
Authorization: Bearer iso_test_…(oriso_live_…): the word Bearer, one space, the key. - Keys are 41 characters:
iso_test_oriso_live_plus 32 lowercase letters and digits. A stray newline or quote from a copy-paste makes the key invalid. In PowerShell, read the key file with(Get-Content path -Raw).Trim(). - Pack endpoints and
/healthzwork without a key; if those work and maps don’t, it’s the key. - The key may have been revoked. Ask for a new one through the contact page.
My map id returns 404 map_not_found
Maps belong to the key that created them. If you generated it with another key (for example a test key) or mistyped the id, you get map_not_found. Use the original key, or keep the JSON yourself.
400 “size: too small for N rooms”
Each room needs space, about 25 squares, and the rooms together may fill only about 60% of the grid. Use a bigger size or lower rooms. Six rooms fit well in 36 × 30.
400 “knobs.decay: needs gen-1.2.0 or later”
You pinned gen-1.0.0 or gen-1.1.0 and sent a newer knob (secretRooms, decay, clutter). Remove the knob or pin gen-1.2.0. The same goes for the gen-1.3.0 knobs (secretDoors, secrets, props): send "generatorVersion": "gen-1.3.0" with them.
422 generation_failed
The generator tried and couldn’t satisfy every rule. The issues array says why. Try another seed, a bigger grid or fewer rooms.
The same seed gave me a different map
Check generatorVersion and params. A newer generator version changes output for the same seed; pin the version (see Generate parameters). Any change to size, rooms or knobs also changes the map.
My drawing is misaligned
- Place each frame at
projected point × scale − anchor. Forgetting to subtractax/ay, or to multiply by the scale before subtracting, shifts everything. - Use the frames and atlases from the same scale, and the pack version in
map.pack. - Edges use rotation 0 (horizontal) and 1 (vertical), not the palette rotation.
- Draw frames at their native size; resizing a sprite blurs it and breaks alignment. Pick another scale instead.
Walls cover props, or props show through walls
Sorting everything by depth alone isn’t enough for long walls. Draw floors first, then sort standing pieces topologically as in Drawing a map. The example code does this.
The browser says the atlas canvas is “tainted”
Set img.crossOrigin = "anonymous" before setting img.src. Pack files send Access-Control-Allow-Origin: *, so canvas export then works.
Calling map endpoints from the browser
CORS is open, so it works technically, but your key would be visible to anyone. Generate and fetch maps on your server; let the browser load only the pack files.
Images look blurry
Draw at the scale you display, or larger. Turn off smoothing when scaling the canvas up (ctx.imageSmoothingEnabled = false, CSS image-rendering: pixelated), or use a bigger scale.
The download is huge
Download only one scale and only the angles you show. All four angles at 0.25 are 1.26 MB; at full scale 13.73 MB. Cache them forever.
I asked for a .glb model or a preview and got 404
3D models aren’t served in phase 1 (they come later), and Ink Stone has no preview images yet.
Still stuck?
Send the request (without your key), the response and the map id through the contact page.