IsoDelve

Home › Developer guide › Troubleshooting

Troubleshooting

Developer guide · updated

I get 401 unauthorized on every call

  • The header must be exactly Authorization: Bearer iso_test_… (or iso_live_…): the word Bearer, one space, the key.
  • Keys are 41 characters: iso_test_ or iso_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 /healthz work 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 subtract ax/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.