For AI agents

Read this first. The cell (16 x 16 x 16 m, metres, y up, positions are object CENTRES from the north-west corner), angles in degrees, where visitors arrive, the avatar and what it can climb, shapes, materials, collision, helpers, prefabs and every limit. Changes nothing.

No arguments.

The drafts this wallet keeps for agents: id, plot, name, objects, when and by whom each was last saved, and which one is open. Changes nothing.

No arguments.

Start an empty draft of the creator's own plot of the mainland and work on it from now on: every cell of the plot, coordinates in metres from its north-west corner, the street entrance and the neighbours as describe_rules tells them. plot is only for the island host, who may name any plot by number; anyone else builds on the plot their wallet owns. Returns the link the owner opens it with.

• name — Draft name.
• description — A sentence about the scene.
• plot — Host only: the plot number, e.g. "5". Default: the wallet’s own plot.

Work on another of this wallet’s drafts, by id or exact name (list_drafts). The owner may have changed it from the plot editor since; describe_scene shows what is there now.

• draft required — Draft id or name.

What is built now, in one screen of text: each group with its bounds, a walk test from the arrival point with the game’s own movement (which floors a visitor reaches and which they cannot), the ground still free, and things resting on nothing or frames hanging on nothing. Call it after each round of changes. Changes nothing.

No arguments.

A picture of the scene to check your work: by default a ground-floor plan, an upper-floor plan (or the roof), and the south and east elevations, with a 1 m grid. Plans are cut 1.4 m above their level like an architect’s plan (walls cut dark, what is above left out); green marks where a visitor can stand, red floors they cannot reach. Changes nothing.

• views — Panels, up to four: top (everything from above), plan (cut at each of levels), south, north, east, west (elevations).
• levels — Floor levels for plan panels, e.g. [0, 3.71]. Default: the levels found.
• highlight — Ids to draw strongly, with everything else faded.
• format — png (default, an image) or svg (text).

The objects in the cell: id, label, shape, position (centre), size, yaw in degrees (or rotation when tilted), color, material, collider (solid), group, and locked for scenery the creator has locked. Filter by group or shape. Changes nothing.

• group — Only objects of this group name.
• shape — Only objects of this shape.

The fastest way to rough out a building: four solid walls whose OUTER faces sit on the footprint x..x+width, z..z+depth (x, z = north-west corner), standing on level y, with a door (default on the south side, 1.2 x 2.3 m), windows, a floor slab (default) and optionally a ceiling with holes for stairs. One group. Returns the inside faces of the walls (for add_frames), the door and where the next storey starts (y + height + ceiling thickness).

• x required — West edge of the footprint (minimum x), metres.
• z required — North edge of the footprint (minimum z), metres.
• width required — Size along x, metres.
• depth required — Size along z, metres.
• height required — Wall height above the floor, metres.
• y — Floor level the room stands on, default 0. For an upper storey use the nextStorey a lower room returned.
• thickness — Wall thickness, default 0.25 m.
• doorSide — Wall with the door: south (default, facing arriving visitors), north, east, west or none.
• door — Door size and place; at is measured from the wall’s west or north end. Default centred, 1.2 x 2.3 m.
• windows — Windows per wall, spread evenly.
• windowSides — Walls that get windows; default every wall but the door wall.
• window — Size of counted windows (default 1 m wide, 1.2 m tall, sill at 0.9 m).
• floor — Floor slab under the room, its top at y. Default true.
• ceiling — Ceiling slab on top of the walls, default false. Give it a hole over a stair.
• color — Hex colour such as "#b9ab92". Defaults to the material’s colour (warm stone).
• material — Surface finish; color still tints it. glass is see-through.
• label — Name shown in the Objects list, e.g. "North wall".
• group — Group name. A group is selected and moved as one in the editor; an existing group with this name is joined.

One straight solid wall along its centreline from [x, z] to [x, z], standing on level y, cut for an optional door and windows (sills and lintels are added). One group.

• from required — Start of the centreline [x, z].
• to required — End of the centreline [x, z].
• height required — Wall height, metres.
• thickness — Wall thickness, default 0.25 m.
• y — Floor level the wall stands on, default 0.
• door — true for a centred 1.2 x 2.3 m door, or { at, width, height }.
• windows — A count spread evenly, or a list of { at, width, height, sill }.
• window — Size of counted windows (default 1 m wide, 1.2 m tall, sill at 0.9 m).
• color — Hex colour such as "#b9ab92". Defaults to the material’s colour (warm stone).
• material — Surface finish; color still tints it. glass is see-through.
• label — Name shown in the Objects list, e.g. "North wall".
• group — Group name. A group is selected and moved as one in the editor; an existing group with this name is joined.

A solid slab whose TOP is the walking surface at y, over x..x+width, z..z+depth, with holes left open (for stairs). One group.

• x required — West edge (minimum x).
• z required — North edge (minimum z).
• width required — Size along x.
• depth required — Size along z.
• y — Height of the walking surface, default 0.
• thickness — Slab thickness, default 0.2 m.
• hole — A hole to leave open, usually the hole add_stairs returned.
• holes — Several holes.
• color — Hex colour such as "#b9ab92". Defaults to the material’s colour (warm stone).
• material — Surface finish; color still tints it. glass is see-through.
• label — Name shown in the Objects list, e.g. "North wall".
• group — Group name. A group is selected and moved as one in the editor; an existing group with this name is joined.

A straight solid flight a visitor walks up, climbing rise metres toward direction from 'from' (the middle of its bottom edge). Risers stay at or under 0.18 m by default (a visitor climbs up to 0.28 m). Returns the footprint: leave it open in the floor or ceiling above (hole) for headroom, and the point where a visitor steps off at the top.

• from required — Middle of the bottom edge of the first step [x, z].
• direction required — The way up: north, south, east or west.
• rise required — Height to climb, usually the next floor level minus y.
• y — Level the stair starts from, default 0.
• width — Width, default 1.2 m.
• tread — Tread depth, default 0.3 m.
• maxRiser — Largest riser, default 0.18 m, at most 0.28.
• color — Hex colour such as "#b9ab92". Defaults to the material’s colour (warm stone).
• material — Surface finish; color still tints it. glass is see-through.
• label — Name shown in the Objects list, e.g. "North wall".
• group — Group name. A group is selected and moved as one in the editor; an existing group with this name is joined.

Hang count empty picture frames evenly along a wall face, for the creator to fill with Tezos NFTs from the Art tab after import. from and to are two points ON THE WALL’S FACE (the insideFaces add_room returns, or a wall’s face line) and must run along x or along z; facing is the way the pictures look (into the room). Frames are not solid and join the group "Frames" unless you name another.

• from required — One end of the wall face [x, z].
• to required — The other end of the wall face [x, z].
• facing required — The way the pictures face: north, south, east or west.
• count required — How many frames, spread evenly.
• width — Frame width, default 2 m.
• height — Frame height, default 1.6 m.
• centreHeight — Height of the frames’ centres above the floor level, default 1.6 m.
• y — Floor level of the room, default 0.
• label — Name shown in the Objects list, e.g. "North wall".
• group — Group name. A group is selected and moved as one in the editor; an existing group with this name is joined.

Ready old-town pieces to place with add_prefab: three small buildings (studio, loggia, gallery room), walls with plinths and cornices, doorways, windows, floors, stairs and a landing, columns, an arcade bay, a portico, roofs, a balustrade, a bench, a cypress planter, a lemon tree, a lamp post and a fountain. Each with its id, size [x, y, z] in metres at yaw 0 (front facing south), the height its lowest part sits above the level it is placed on, and its piece count. Changes nothing.

• category — Only this category.

Place one prefab from list_prefabs as one new group. at is the centre of its footprint [x, z]; y is the floor level it stands on (default 0), and its parts keep their real height above it, so a roof lands on 3.5 m walls built at the same level. yaw turns it in degrees (default 0: its front faces south, toward arriving visitors; 90 east, 180 north, -90 west). scale (default 1) resizes it uniformly. Returns its bounds, doorways and stair ends in cell coordinates.

• prefab required — Prefab id from list_prefabs, e.g. "loggia".
• at — Centre of the footprint [x, z]. Default the middle of the cell, [8, 8], or in a plot scene of its middle cell.
• y — Floor level it stands on, default 0.
• yaw — Turn in degrees; 0 faces south (+z). Quarter turns keep it on the grid.
• scale — Uniform scale, default 1.
• group — Group name; default the prefab’s name, numbered if taken.
• models — Use the prefab’s model files where it has them (roof tiles), as the Prefabs shelf does. Default true; false places plain primitives only.

Add a batch of primitives in one step: box, cylinder, sphere, torus, vault, foliage or frame (an empty picture frame for an NFT). Each needs shape and position; size, yaw, color, material, collider, collisionOnly, label, group and id are optional. position is the CENTRE in metres from the cell’s north-west corner: x and z 0–16, y is height, so a box of height h on the ground has y = h / 2. size is [x width, y height, z depth] before yaw; yaw is degrees (90 turns the +x side to face north). The whole object must stay inside the cell. Solid objects (default for box, cylinder, vault) block walking and can be stood on. Example, a 10 x 8 m stone floor and its back wall: {shape:"box", position:[8,0.1,8], size:[10,0.2,8], material:"stone", group:"Room"}, {shape:"box", position:[8,1.7,4.1], size:[10,3,0.2], group:"Room"}. repeat makes rows (posts, slats, columns) in one item. All or nothing: if any object is wrong nothing is added and the reply lists every problem. One Undo step. In a plot scene (new_plot) coordinates run across the whole plot from its north-west corner; a box that crosses a 16 m cell border is cut into one piece per cell, and anything else must lie inside one cell.

• objects required — The objects to add, each { shape, position, ... }.

Change existing objects by id in one step. Give each id with only the fields to change: position (new centre), offset (added to the centre, e.g. [2,0,0] moves 2 m east), size, yaw or rotation (degrees), color, material (null clears it), collider, collisionOnly, label, group (a name to join or create, null to leave the group) or shape (between box, cylinder, sphere, torus, vault and foliage). Same coordinates and limits as add_objects. All or nothing, one Undo step. Locked scenery cannot be changed.

• changes required — One { id, ...fields to change } per object.

Move or turn a whole group as one, the way the editor does: offset adds [dx, dy, dz] (e.g. [0, 0.15, 0] lifts it onto a 15 cm slab), to puts the middle of its footprint at [x, z], and yaw turns it in degrees about the vertical axis through that middle. One Undo step; locked scenery cannot move.

• group required — The group’s name, from describe_scene or list_objects.
• offset — Metres to move it [dx, dy, dz].
• to — New centre of its footprint [x, z], instead of offset.
• yaw — Turn in degrees, counter-clockwise seen from above, about its middle.

Delete objects by id, every member of a group by its name, or both, in one step (one Undo step). Locked scenery cannot be removed.

• ids — Objects to delete, from list_objects.
• group — Delete every object of this group.

Undo the last change (up to 30 steps). A whole add, update, remove, helper or prefab call is one step.

No arguments.

Check the open draft the way the site will: the plot and each cell’s limits, whether the wallet still owns the plot, and which model files the owner’s browser must hold. describe_scene tells what a visitor can reach. Changes nothing.

No arguments.

Only when the creator asks: check the draft the way the site will and give the creator the link that opens it in their plot editor on the site. There they walk it, change what they like and publish it with their wallet; nothing is published without that signature, and this server never holds a key or publishes. Changes nothing here.

No arguments.