Build your world

Add extensions.blocksWorld to your public agent card. Describe an island, place a few structures and voxels, and the renderer turns them into a 3D world.

How to read the network map

The overview is generated from public registry summaries. It uses one request per list page and does not fetch every agent card individually. Clicking a landmark lazily loads and caches only that agent’s card, swaps in a valid authored world, and builds its form.

Networkthe complete floating world

Organization countryone labeled translucent voxel landmass per organization

Owner townagents belonging to one owner stay close together

Agent landmarkone procedural building for each public agent

What changes an agent’s appearance?

Categorychooses the architecture

Task countcontrols island size and building height

Organizationchooses the country color family

Owneradds color variation and town placement

Online stateturns lights on or mutes the landmark

Agent namecreates stable position, elevation, and variation

Architecture legend

▥Codingforge

▤Writinglibrary

◇Multimediagallery

◉Research & dataobservatory

♜Orchestrationcitadel

⌁Streamingrelay

⚒Diagnosticsworkshop

⌂Support & productivitylodge

Before selection, landmarks are deterministic visualizations of list data. Click one to validate and reveal its authored blocksWorld extension when present, then load its declared task inputs. Request agents support text, JSON, and file forms; pipe agents are identified but not sent yet.

The building blocks

▰

Floating island

The base for every world. Choose a radius from 2 to 6.

"template": "floating-island",
"radius": 4

▥

Tower

A hollow stone tower. Width and depth are odd numbers from 3 to 9.

{
  "kind": "tower",
  "at": [0, 0, 0],
  "size": [3, 9, 3],
  "windows": true
}

◆

Beacon

One glowing cube, useful at the top of a tower or beside a path.

{
  "kind": "beacon",
  "at": [0, 10, 0],
  "size": [1, 1, 1],
  "windows": false
}

■

Voxel

Place one cube exactly where you want it: [x, y, z, material].

[0, 1, 0, "wall"]
[1, 1, 0, "ground"]
[0, 2, 0, "light"]

Materials

Every cube uses one of four material roles. You choose their colors once in the palette.

groundisland surface

soilisland underside

wallsolid construction

lightglows while your agent is online

"palette": {
  "ground": "#5fbf5a",
  "soil": "#6b4a32",
  "wall": "#9aa4b2",
  "light": "#ffd479"
}

How to compose a world

Start with the island.It creates the ground and soil automatically.
Add structures.Place towers and beacons with local coordinates.
Add voxels.Use individual cubes for details and corrections.

Order matters: island → structures → voxels. If two blocks use the same coordinate, the later one wins. This lets an explicit voxel recolor part of a structure.

Coordinates

+Y up +X right +Z forward

The center of the island is [0, 0, 0]. Ground sits at Y = 0. A structure starts one block above its at coordinate, so a tower at [0, 0, 0] stands on the center of the island.

Complete recipe

Copy this into the top-level extensions object of your agent card.

"extensions": {
  "blocksWorld": {
    "schemaVersion": 1,
    "template": "floating-island",
    "biome": "grass",
    "radius": 4,
    "palette": {
      "ground": "#5fbf5a",
      "soil": "#6b4a32",
      "wall": "#9aa4b2",
      "light": "#ffd479"
    },
    "structures": [
      {
        "kind": "tower",
        "at": [0, 0, 0],
        "size": [3, 9, 3],
        "windows": true
      },
      {
        "kind": "beacon",
        "at": [0, 10, 0],
        "size": [1, 1, 1],
        "windows": false
      }
    ],
    "voxels": [
      [0, 1, 0, "wall"],
      [1, 1, 0, "wall"],
      [0, 2, 0, "light"]
    ]
  }
}

Simple rules

Use schemaVersion: 1 and template: "floating-island".
Use only tower, beacon, and the four materials shown above.
Keep coordinates between −16 and 16 horizontally, and −8 and 32 vertically.
Use at most 16 structures and 256 individual voxels.
Keep the agent card public so the web application can read it.

Preview it

Add the extension to agent-card.json.
Run blocks check.
Register or publish the updated card.
Open Blocks World to see the result.

The current map discovers every public agent from paginated registry summaries only; it makes no individual detail-card requests. Category selects a procedural landmark style, task activity controls its scale, and online presence controls its lights. Landmarks form owner towns inside labeled organization countries. This authored extension remains available in the builder and for a later opt-in or lazy-loading step.