IsoDelve

Home › Developer guide › Glossary

Glossary

Developer guide · updated

Anchor — the point in a sprite frame (ax, ay) that sits on the piece’s footprint centre on the floor. Placing frames by their anchors makes every piece line up.

Angle / facing — one of the four isometric views, iso0, iso90, iso180, iso270, a quarter turn apart. The map JSON has no angle; you choose one when drawing. Map north is fixed; see Compass.

API key — your secret credential, iso_test_… or iso_live_…, sent as Authorization: Bearer <key>.

Art pack — a versioned set of sprites (and later 3D models) for every piece. Ink Stone is the first and is free forever.

Atlas — a large PNG holding many sprite frames, plus a JSON file listing each frame’s position and anchor. One set exists per angle and scale.

Bounds — a room’s rectangle, [x, y, width, height] in cells.

Breach — a wall knocked through by decay (portal.breach.open), at most one per map.

Cell — one 5 ft square of the grid (1.524 m in the art).

Clue — in gen-1.3.0, something the party can notice or find that points toward a secret door: a sign in the room (scratches, a draft), a found item (a note, a map scrap) or a life snippet (a journal, a letter, a ledger). Its text is for players; its gm note is not. See False clue.

Compass / map north — north is the top of the grid (row 0, decreasing y); east is increasing x. In the isometric views north is up-left on screen at iso0 and turns with the view. gen-1.3.0 maps with clues record this in orientation, and their PNGs show a small compass with an N.

Critical path — the rooms in order from the entrance to the boss room.

Cutaway (short walls) — a wall shown at 3 ft instead of full height so you can see into rooms. Server renders use it by default (walls=cutaway).

Decay — the knob (0 to 1) for ruin: cracks, crumbled or collapsed walls, rubble, broken props.

Edge — a wall line between two cells. edgeH holds horizontal lines, edgeV vertical ones. Walls and doors live on edges, not in cells.

False clue — a clue that points at nothing (falseClue: true, targets: []). It reads like a true one; only the gm note, starting “False clue:”, gives it away. Keep both from players.

Footprint — how many cells a prop covers, [w, d]. Most are 1 × 1.

Frame — one sprite’s rectangle inside an atlas.

Generator version — the exact generator that built a map, such as gen-1.2.0. Pin it to keep a seed’s map stable.

Isometric — a view from above at an angle in which a square cell becomes a 2:1 diamond, with no perspective shrinking.

Knobs — the tuning parameters: loopiness, prop density, required roles, secret rooms, decay, clutter, and in gen-1.3.0 secret doors plus the secrets and props on/off switches.

Manifest — manifest.json, the list of a pack’s pieces, atlases, frame sizes and units.

Map JSON — the isodelve-map@1 document describing a map: grid, rooms, doors, props, lights, paths.

Orientation — the gen-1.3.0 map field { "north": "-y", "east": "+x", "south": "+y", "west": "-x", "note": … } that says which grid direction each compass point is. Text about walls (“the north wall”) always uses this map north, never the screen.

Palette — the list of piece ids a map uses; the grid layers store indexes into it, with 0 meaning nothing.

Piece — one kit element, such as floor.slab.a, wall.seg.full.a, portal.door.closed, prop.throne.a.

Portal — any opening on an edge: door, arch, doorway, portcullis, secret door or breach.

Render — a finished PNG of a map from the API’s /v1/maps/{id}.png.

Room details — gen-1.3.0’s 1 to 3 read-aloud lines for every room (rooms[].details, knobs.flavor). Pure atmosphere, never a hint.

Scale — sprite resolution: 1 (a cell is 256 px wide), 0.5 or 0.25.

Secret door / trigger — a door that looks like wall; its trigger is the prop that opens it, a game-master note. In gen-1.3.0 doors[].opens says how it opens: a pivoting stone leaf or a bookshelf door that slides aside.

Hallway cache / secret passage — gen-1.3.0 secrets: a 3 × 3 hidden room off a corridor (paths.secretCaches), and a hidden corridor between two rooms with a secret door at each end (corridors[].secret, paths.secretPassages).

Seed — the string that drives every random choice. Same seed, settings and generator version give the same map.

Topological draw order — drawing standing pieces so anything behind another along a grid axis is drawn first.

Vertex — a grid corner where walls meet; it holds a wall post (end, straight, corner, T or cross).