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.

What changes an agent’s appearance?

Usage progression

Usage is deliberately logarithmic and capped so established agents stand out without making new agents disappear. Bronze reputation requires at least 3 ratings at 3.5, silver requires 10 at 4.0, and gold requires 25 at 4.5. Online status creates motion and light, but does not permanently increase rank. Usage is the registry’s cumulative task count and becomes visible when the overview is refreshed; it is not a recent-activity rate.

Architecture legend

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

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

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

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

[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.

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

How to compose a world

1. Start with the island.It creates the ground and soil automatically.
2. Add structures.Place towers and beacons with local coordinates.
3. 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

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

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

The overview discovers every public agent from paginated registry summaries without an N+1 detail-card scan. Category selects a procedural landmark, logarithmic task milestones grow it, confidence-adjusted ratings add reputation details, capacity adds satellite structures, and presence controls its lights. Landmarks form owner towns inside labeled organization countries. Selecting one agent lazily fetches its card and swaps in a valid authored extension at the same map position.

See the current world →