From the city to the object

Every world is one tree. A city holds buildings, a building holds floors, a floor holds rooms, and a room holds objects. Each level has a stable id and typed fields, so “the armchair in the living room on the ground floor of the corner building” is a path, not a search.

Rooms carry their bounds in metres and their connections to other rooms and to the exterior. Objects carry the primitives that draw them and the semantics that make them usable.

Geometry: convex primitives

Interiors are described as a flat list of entities. Each entity is one convex primitive with a position, a size and an optional rotation, in metres, Y up. There are four shapes: box, rounded box, cylinder and sphere. Nothing is a merged or planar mesh, so every entity is also a collider.

An entity names its material, its group (architecture or objects) and the room it belongs to. Entities flagged as cut are the ones a cutaway view slices at the cut height.

{
  "id": "p339",
  "shape": "rounded",
  "pos": [6.4, 0.3, 5.8],
  "size": [4.6, 0.35, 1.1],
  "material": "walnut",
  "group": "objects",
  "room": "living"
}

Materials are named, not baked. The world ships a material table (colour, roughness, texture name) that you map to your own PBR library.

Objects: the semantic record

An object groups primitives and gives them meaning. Names and uses are bilingual. Every field below is a fact an agent can query or a change you can ask for.

{
  "kind": "hinge",
  "parts": ["p273"],
  "axis": [0, 1, 0],
  "pivot": [0.36, 1.2, 3.41],
  "rangeRad": [0, 1.45],
  "direction": 1,
  "states": {
    "closed": { "value": 0 },
    "ajar":   { "value": 0.22 },
    "open":   { "value": 1.45 }
  },
  "current": "open"
}

A door’s articulation. The hinge sits on the real jamb, the leaf swings into the room, and its state persists: an agent that closes it leaves it closed.

Navigation contract

The demo agent walks, sits, lies down, opens and closes, picks up and puts down. It does so from the data above, with no hand-placed waypoints. These are the rules the data guarantees, so your own agents can rely on them.

• Every usable object has an access point outside all footprints: in front of the seat for a chair or sofa, on the declared approach side for everything else.
• Seats are entered and left through their access point. Those two steps are the only ones that touch the furniture footprint.
• Footprints are never ignored when planning. If there is no free path, the agent stays put and says so instead of crossing anything.
• Whatever is picked up stays in hand between destinations. It can be put down only on a declared surface, or returned to where it came from.
• Doors and windows keep the state the last action left them in.

Delivery formats

The same world is delivered in the representation your project needs.

Opening it in your engine

Blender, Unreal Engine, Unity, Godot, Houdini, Omniverse and three.js all read at least one of the formats above. What you map on your side:

• Materials: named entries to your PBR library.
• Primitives: the four shapes instance well; group by shape and material for batching.
• Articulation: hinges and slides to your joint or constraint system; the pivot and axis are already in world units.
• Collision: each primitive is a convex collider as is. No physics is baked; mass and states travel as data for whoever simulates.

Early access

The model is versioned and will grow as more of the catalogue carries these fields. If you are building agents, a simulation or a game world and want to read this data directly, ask for early access on the product page and tell us what you want to build.

Get early access↗