---
title: DreamWall AfterBlock Museum
emoji: 🧱
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 5.29.0
python_version: "3.10"
app_file: app.py
pinned: false
license: apache-2.0
tags:
  - minecraft
  - gradio
  - small-models
  - art
  - game
  - agent-trace
  - codex
  - openai-codex
  - build-small-hackathon
  - thousand-token-wood
  - adventure-in-thousand-token-wood
  - tiny-titan
  - off-brand
  - best-demo
  - field-notes
  - sharing-is-caring
  - community-choice
---

# DreamWall: AfterBlock Museum

AfterBlock Museum is a Minecraft-native memory museum for the Build Small Hackathon.

## Submission Metadata

- **Relevant tags:** `minecraft`, `gradio`, `small-models`, `build-small-hackathon`, `thousand-token-wood`, `openai-codex`, `tiny-titan`, `off-brand`, `best-demo`, `field-notes`, `sharing-is-caring`, `community-choice`
- **Demo video recording:** https://youtu.be/3Lmuy-rJ588
- **Social media link:** https://x.com/bitepdf/status/2066671156393128099?s=20
- **Team HF usernames:** @Wildstash

Visitors scan a relic, memory, animal spirit, or prompted painting. The app assigns a museum hall, computes a curation score, awakens a tiny artifact spirit, prints a shareable passport card, and emits a `dreamwall.museum.v1` packet for the Minecraft server.

Living Graffiti and Living Moving Canvas remain as secondary modes. They power museum placement, resonance, and Minecraft wall mechanics.

The main cash-prize demo is now simple: relic -> hall -> passport/profile -> live Paper handoff -> exact-coordinate Minecraft museum placement.

The Gradio demo now opens with a clean museum preview: 100 labeled demo artifacts, nine hall wings, curation scores, coordinates, generated Minecraft-style item textures, a live 3D artifact model tied to the same `CustomModelData` used by the server packet, and a visible **Run in Minecraft** card for `/dreamwall import object | story | @owner`. Social tags are optional; if a visitor leaves the tag blank, the museum uses the owner name or anonymous label.

The main placement form accepts a visitor signature in the fourth field. A value like `@wildstash` becomes the hover/social tag; a plain value like `Arnav` becomes the owner label without adding a social badge.

The Space also includes a **Living Map** tab for the `YOU ARE HERE` route, a **Demo Path** tab with the critique and shot order for the three-minute hackathon video, plus a **Join Minecraft** tab that leads with the server address and already-built world proof. Server ZIPs, raw packets, SFTP details, and install files stay in collapsed appendices instead of the main story.

## Why This Is Different

Most hackathon apps stop at chat or image generation. AfterBlock turns language and memory into a place visitors can walk through.

- **Museum-native:** every input becomes an artifact with a hall, plaque, passport, and Minecraft coordinates.
- **Spirit-bearing:** each artifact awakens a constrained spirit that speaks only from its object and lore.
- **Resonance-based:** curation score replaces market/auction language.
- **Off-brand:** the Gradio app feels like a Minecraft museum terminal.
- **Rendered preview:** a floor-map image shows the museum populated with 100 demo artifacts.
- **3D artifact preview:** the selected relic renders in a Three.js cuboid scene inside Gradio, using the same model profile, material finish, and `CustomModelData` that the Minecraft bridge receives.
- **Less clutter:** the wall is organized by hall and by "when this becomes art" rather than dumping every relic as a noisy card grid.
- **Texture path:** 3,200 generated PNG textures plus 3,200 3D item model JSONs are generated for a Minecraft resource pack, with 70 object families and 10 material finishes.
- **Texture review links:** see `docs/TEXTURE_LINKS.md` for the searchable gallery, contact sheets, proofs, manifest, and resource-pack URLs.
- **Animated:** each prompt becomes a 10-frame artifact, not a static image.
- **Grows:** artifacts unlock stages from seed sketch to server myth based on value and mutation.
- **Collective:** many prompts become one shared moving canvas, not isolated images.
- **Alive:** the wall has attention weather, timeline ticks, fusion links, and growth stages: myth storm, mutation wind, fusion bloom, quiet ruins, and steady glow.
- **Minecraft-native:** the output is a wall packet, block palette, and row-run placement plan, not just a picture.
- **Creature-native:** prompts hatch named pets with survival odds, lineage, and server state.
- **Identity-aware:** the same prompt changes when the player signature or gallery zone changes.
- **Social artifact:** every prompt becomes part of a public server museum.
- **Creative fusion:** nearby concepts combine into more valuable artifacts.
- **Value without compliance risk:** auction/voting uses demo points, not real money or blockchain.
- **Small by design:** no giant remote model API is required for the core experience.
- **Demo-first:** the video can show prompt -> Space preview -> live Paper handoff -> exact Minecraft plot.

## Hackathon Fit

- **Track:** An Adventure in Thousand Token Wood
- **Small model constraint:** the app uses a local semantic fingerprint engine, far below the 32B limit, with no cloud API dependency.
- **Built on Gradio:** this Space is the official Gradio submission surface.
- **Show, don't tell:** the demo is scan relic -> 3D artifact model -> hall placement -> passport -> Minecraft pedestal.

## Bonus Quests

- **Off-Brand:** custom Minecraft museum terminal UI styling.
- **Tiny Titan:** local deterministic semantic curator is far below the 32B limit and can be swapped for a <=4B model for the interpretation step.
- **Best Demo:** real object/prompt -> 3D preview -> passport/profile -> Paper handoff -> in-world relic.
- **Community Choice:** passport cards are shareable and social tags are optional.
- **Sharing is Caring:** the app emits open museum and bridge packets for each artifact.
- **Field Notes:** see [`docs/FIELD_NOTES.md`](docs/FIELD_NOTES.md).

## Minecraft Server Layer

The MVP emits:

- WorldEdit-style row instructions
- a `dreamwall.museum.v1` artifact/passport/spirit packet
- a `living_graffiti.mc.v1` animated wall packet
- a `living_canvas.mc.v1` multi-prompt animated wall packet
- a `dreamwall.mc.v1` JSON bridge packet
- a `dreamwall.market.v1` demo valuation packet
- a `neuropets.mc.v1` creature spawn/simulation packet
- a named Gradio API endpoint: `generate_art`
- a named Gradio API endpoint: `hatch_pet`
- a named Gradio API endpoint: `living_graffiti`
- a named Gradio API endpoint: `living_canvas`
- a named Gradio API endpoint: `quick_curate`
- generated texture PNGs in `assets/afterblock_textures/items/`
- resource-pack skeleton in `resource-pack/AfterBlockMuseum/`
- searchable full texture gallery in `assets/afterblock_textures/gallery/index.html`
- Gradio Object Atlas endpoint: `browse_textures`

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 in [`paper-plugin/`](paper-plugin/) and a prebuilt jar/world in [`server-kit/`](server-kit/). The demo path is `/dreamwall pack`, `/dreamwall museum check`, then the generated visitor command from the Space; `/dreamwall museum build` is only needed if you skip the prebuilt world or want to refresh the campus. `/dreamwall import object | story | @owner` places that visitor's live Space packet at its generated XYZ with an atlas marker, route compass, lit floor path, engraved nameplate, lectern passport, and profile button.

### Demo Proof

Run the packaged-demo verifier before recording:

```bash
.venv/bin/python tools/verify_afterblock_demo.py
```

It writes [`artifacts/stress/afterblock_demo_proof_manifest.json`](artifacts/stress/afterblock_demo_proof_manifest.json), which verifies the 13-output Space flow, live Paper handoff, per-relic server kit ZIP, 3,200 resource-pack textures/models/overrides, plugin/world checksums, entry-atlas source contract, and 12 x 12 coordinate contract.

### API Shape

Use the Space API with the named endpoint:

```text
POST https://build-small-hackathon-dreamwall-mc.hf.space/gradio_api/call/quick_curate
```

Input order:

```json
[
  "white AirPods from my first year of university",
  "They carried private worlds through public noise during my first year away.",
  "@Wildstash",
  null
]
```

The final output is a plugin-ready museum packet with artifact title, hall, coordinates, palette/materials, resource-pack model path, `CustomModelData`, plaque text, spirit first line, optional social tag, owner label, and passport payload. The Paper bridge turns that packet into a placed relic, item hover lore, a readable lectern passport, a right-click spirit button, a route compass, and a lit route from `YOU ARE HERE` to the generated plot in Minecraft.

## Design Docs

- [`docs/COMPETITION_GOAL.md`](docs/COMPETITION_GOAL.md)
- [`docs/MINECRAFT_SERVER_BLUEPRINT.md`](docs/MINECRAFT_SERVER_BLUEPRINT.md)
- [`docs/MUSEUM_CURATION.md`](docs/MUSEUM_CURATION.md)
- [`docs/TEXTURE_PACK_STRATEGY.md`](docs/TEXTURE_PACK_STRATEGY.md)
- [`docs/FIELD_NOTES.md`](docs/FIELD_NOTES.md)
- [`docs/HALL_PRESENTATION.md`](docs/HALL_PRESENTATION.md)
- [`docs/LIVING_GRAFFITI_MVP.md`](docs/LIVING_GRAFFITI_MVP.md)
- [`docs/NEUROPETS_MVP.md`](docs/NEUROPETS_MVP.md)
- [`docs/DEMO_RUNBOOK.md`](docs/DEMO_RUNBOOK.md)

## How This Can Win

DreamWall MC is aimed at **An Adventure in Thousand Token Wood** plus the **OpenAI Codex Track**.

Judging fit:

- **Genuinely delightful:** ordinary objects become Minecraft museum artifacts with tiny spirits.
- **AI is load-bearing:** semantic curation chooses halls, spirits, plaques, resonance, and placement.
- **Originality:** it is a memory museum ritual, not a chatbot wrapper.
- **Polish:** custom Gradio skin plus Minecraft bridge packet.
- **Visual worldbuilding:** the UI answers "when is this art?" through nine museum halls, not just "what object is this?"
- **Server parity:** the Gradio 3D preview, resource-pack item, and `dreamwall.museum.v1` packet point at the same artifact model.

Bonus quests:

- **Off-Brand:** custom UI beyond default Gradio.
- **Sharing is Caring:** open trace + server packet per generation.
- **Field Notes:** this repo includes [`docs/FIELD_NOTES.md`](docs/FIELD_NOTES.md).

Next high-impact demo step: use PebbleHost Paper to place one AfterBlock artifact from the `dreamwall.museum.v1` packet, then record the three-minute Space-to-Minecraft proof. If PebbleHost access is not available, record the locally verified Paper world and call out that the live upload is password-gated.

## Codex Track

This project is being built with Codex as the coding agent.

Public GitHub repo with Codex-attributed commits:

https://github.com/Arnie016/dreamwall-mc