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.

The API for a plot's own game (teztopia-plot-game/1): events, commands, limits, house rules (no money of any kind), the plot's daily multiplayer allowance, and whether this plot has a game. Read it before set_game. Changes nothing.

No arguments.

The plot game's code as it is saved in this draft, its size and any problem that would stop it publishing. Changes nothing.

No arguments.

Save a game in this plot: your own JavaScript (source) or an example ('starter', 'lantern-collect'). It is checked (version and size) and replaces any game the plot had; a portal to the game is added near the entrance unless portal is false or one exists. The code never runs on the server: the owner tests it with preview_link (walk through the portal, choose Play) and publishes it with the plot, signed by their wallet. One Undo step.

• source — The game, written against `game` (describe_game_api).
• example
• portal — Add a portal to the game. Default true.
• portal_at — Where the portal stands, [x, z] in the scene. Default: near the entrance.

Remove the plot's game and its portal from this draft. One Undo step.

No arguments.

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

No arguments.

Replace the open draft with the plot exactly as it is published now (a draft of the owner's plot is started if none is open): to change what is live, or to throw away the changes made since. One step: undo returns to the draft before. The published plot itself is not touched.

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.

Before the owner decides: what the open draft changes against the published plot (objects and groups added, removed and changed, cell by cell, model files, NFT frames), its weight against the plot allowance, and anything that would block publishing. Tell the owner the result in plain words. Changes nothing.

No arguments.

A link for the owner to walk the open draft in place on their plot, in their browser, before deciding. Only the signed-in owner of the plot can open it; nothing is saved or published there and their own browser draft is untouched. Give it to the owner with the preview images. Changes nothing.

No arguments.

Only when the owner says to publish: check the draft the way the site will and give the owner the link that opens it in their plot editor, where they publish it with their wallet's signature. Nothing is published without that signature; this server never holds a key or publishes. Call review_changes and preview_link first, so they decide knowing what changes. Changes nothing here.

No arguments.

Only when the owner says they do not want it: delete a draft for good (the open one unless draft names another) with its undo steps. The published plot is not touched. Cannot be undone.

• draft — Draft id or exact name. Default: the open draft.