Document Living Canvas Minecraft bridge

CODEX_BUILD_LOG.md

@@ -24,3 +24,4 @@ This file records how Codex was used to build the hackathon entry.
 - Improved Living Graffiti with prompt-derived names, explicit 32x32 block sizing, 10-frame footprint metadata, and staged growth from seed sketch to server myth.
 - Added Living Moving Canvas mode: a multi-prompt 12x12 Minecraft wall simulation with neighbor fusion, attention weather, growth stages, and a `living_canvas.mc.v1` packet.
 - Upgraded Living Moving Canvas into an animated wall: stable Minecraft coordinates, pulsing timeline frames, visible fusion links, evolution events, and a clearer Thousand Token Wood demo runbook.
+- Added per-tile Minecraft origins/bounds and documented the Paper bridge path for placing Living Canvas tiles and representing motion through particles, map updates, or block-frame updates.

README.md

@@ -74,6 +74,8 @@ The MVP emits:
 - a named Gradio API endpoint: `living_graffiti`
 - a named Gradio API endpoint: `living_canvas`
 
+Each `living_canvas.mc.v1` tile includes a stable `minecraft_origin` and `minecraft_bounds`, so the Paper bridge can place it directly on the 384x384 wall.
+
 The repo also includes a Paper plugin scaffold in [`paper-plugin/`](paper-plugin/) that can reach the live Space and is ready to extend into block placement.
 
 ### API Shape

app.py

@@ -787,6 +787,19 @@ def summarize_wall_tile(prompt: str, index: int, wall_zone: str, tick: int) -> d
         "prompt": prompt,
         "creator": player,
         "plot": plot,
+        "minecraft_origin": {
+            "x": plot["world_x"],
+            "y": 80,
+            "z": plot["world_z"],
+        },
+        "minecraft_bounds": {
+            "x1": plot["world_x"],
+            "y1": 80,
+            "z1": plot["world_z"],
+            "x2": plot["world_x"] + PLOT_SCALE - 1,
+            "y2": 80 + PLOT_SCALE - 1,
+            "z2": plot["world_z"],
+        },
         "moods": moods,
         "palette": palette_names,
         "value": value["creative_value"],
@@ -965,6 +978,12 @@ def living_wall_canvas(prompt_block: str, wall_zone: str, tick: int):
             "growth_stage_unlocks",
             "server_packet_export",
         ],
+        "minecraft_animation_plan": {
+            "v1": "place stable 32x32 tiles as map art or wool blocks",
+            "v2": "pulse fusion links with particles between tile centers",
+            "v3": "periodically update tile frames from the GIF timeline",
+            "redstone_required": False,
+        },
         "fusion_links": links,
         "evolution_events": events,
         "tiles": tiles,

docs/MINECRAFT_SERVER_BLUEPRINT.md

@@ -65,12 +65,35 @@ total canvas: 384 x 384 blocks
 2. Install Paper and WorldEdit.
 3. Upload DreamWall bridge jar.
 4. Run `/dreamwall fetch`.
-5. Manually place one generated row-run mural on a test wall.
-6. Record a 20-second proof clip.
+5. Call the `living_canvas` Space endpoint and copy the `living_canvas.mc.v1` packet.
+6. Manually place one generated 32x32 tile from `tiles[].minecraft_origin` on a test wall.
+7. Add signs for title, creator, stage, weather, and value.
+8. Record a 20-second proof clip.
+
+## Living Canvas Packet
+
+The main demo packet is `living_canvas.mc.v1`.
+
+It gives the server:
+
+- stable tile coordinates
+- per-tile `minecraft_origin`
+- per-tile `minecraft_bounds`
+- `stage`, `weather`, `value`, and `mutation_rate`
+- `fusion_links` between tiles
+- `evolution_events` for narration
+- a `minecraft_animation_plan`
+
+The wall does not need physical redstone for V1. Use the Space GIF as proof of motion, then represent motion in Minecraft with one of:
+
+- animated map updates
+- particles between linked tiles
+- block-frame updates on a timer
+- lamps or command-block pulses around high-stage artifacts
 
 ## Second Server Milestone
 
-Implement real block placement from `grid.row_runs`:
+Implement real block placement from one `living_canvas.mc.v1` tile or one `dreamwall.mc.v1` `grid.row_runs` packet:
 
 ```text
 world_x = canvas_origin_x + plot.x * 32 + run.x

paper-plugin/README.md

@@ -9,6 +9,7 @@ The hackathon Space is the official submission surface. This plugin scaffold is
 - `/dreamwall` shows the configured Space endpoint.
 - `/dreamwall fetch` calls the Space app domain and confirms the bridge can reach Hugging Face.
 - A scheduled task can be extended to poll approved wall jobs.
+- The Space now emits `living_canvas.mc.v1`, a multi-prompt wall packet for the main hackathon demo.
 
 ## Planned Placement Behavior
 
@@ -25,6 +26,21 @@ The Space emits a `dreamwall.mc.v1` JSON packet with:
 - `grid.row_runs`
 - WorldEdit preview lines
 
+The stronger cash-prize path uses `living_canvas.mc.v1` from the `living_canvas` endpoint:
+
+- `tile_size_blocks`: `32 x 32`
+- `canvas_size_tiles`: `12 x 12`
+- `minecraft_wall_size_blocks`: `384 x 384`
+- `tiles[].minecraft_origin`
+- `tiles[].minecraft_bounds`
+- `tiles[].stage`
+- `tiles[].weather`
+- `fusion_links`
+- `evolution_events`
+- `minecraft_animation_plan`
+
+The plugin should treat each tile as a stable wall address. Motion comes from particles, map updates, or block-frame updates, not from moving the artifact to a new plot.
+
 The next plugin step is converting `grid.row_runs` into wall block placement:
 
 ```text
@@ -41,10 +57,12 @@ The Space also emits a `neuropets.mc.v1` packet from the `hatch_pet` endpoint. T
 
 For the hackathon video, the safest route is:
 
-1. Generate art in the Space.
-2. Copy the bridge packet or call the Gradio API.
-3. Use the Paper plugin to place the packet at a fixed gallery wall.
-4. Walk through the server gallery.
+1. Run Living Moving Canvas in the Space.
+2. Copy the `living_canvas.mc.v1` packet or call the Gradio API.
+3. Place one or more `tiles[]` at their `minecraft_origin`.
+4. Add signs for creator, title, value, stage, and weather.
+5. Use particles or a command-block pulse to show fusion links.
+6. Walk through the server gallery.
 
 ## Flat World Canvas
 
@@ -62,6 +80,8 @@ The Space assigns the plot. The plugin should trust the packet and place the mur
 canvas_origin + plot.x * plot_size, y=80, canvas_origin_z + plot.z * plot_size
 ```
 
+For `living_canvas.mc.v1`, the packet already includes `tiles[].minecraft_origin`, so the plugin can skip recomputing the address.
+
 ## Build
 
 ```bash