docs/TEXTURE_PACK_STRATEGY.md

AfterBlock Texture Pack Strategy

Current Asset Set

• 3,200 generated relic textures
• 3,200 generated 3D item model JSON files
• 3,200 minecraft:paper custom model data overrides
• 70 everyday object archetypes
• 10 material finishes: paper fiber, brushed metal, soft plastic, painted wood, canvas cloth, glass glow, rubber grip, enamel badge, aged brass, and screen phosphor
• 6 variant display profiles: pedestal, wall-left, wall-right, tabletop, showcase, and handheld
• 32 contact-sheet screenshots
• browser gallery for all 3,200 materialized isometric previews
• searchable/filterable full-library HTML with copyable /give commands
• Gradio Object Atlas for paging through the pack inside the live Space

Open locally:

assets/afterblock_textures/gallery/index.html

Screenshots:

assets/afterblock_textures/gallery/contact_sheet_01.png
assets/afterblock_textures/gallery/contact_sheet_02.png
...
assets/afterblock_textures/gallery/contact_sheet_32.png
assets/afterblock_textures/gallery/library_report.json

Resource pack skeleton:

resource-pack/AfterBlockMuseum/

Minecraft Rendering Strategy

Each museum relic maps to:

• a 64x64 item texture with deterministic material marks
• a 3D model JSON with blocky elements
• material and finish metadata exposed in the manifest and Gradio inspection wall
• GUI/ground/fixed/first-person/third-person display transforms
• per-variant display profile and orientation metadata
• a custom_model_data ID on minecraft:paper
• a museum packet field under minecraft.resource_pack_item

This lets the server use one base item, minecraft:paper, while rendering thousands of different relics.

Why 3D Models Matter

PNG-only items feel like flat stickers. AfterBlock uses model JSON shapes so different relic categories read differently:

• books and notebooks: thin rectangular slabs
• monitors: screen + stand geometry
• bags: box body + handle
• bottles: tall body + cap
• lamps: shade + stem + base
• controllers: wide body + grips
• keys: ring + shaft
• mugs: cup + handle

The textures carry color, material, and symbolic detail; the model geometry carries silhouette and orientation.

Scale Strategy

To reach thousands of objects without hand-drawing every file:

1. Classify object into an archetype.
2. Pick base geometry for the archetype.
3. Generate color palette from object/memory/image fingerprint.
4. Add deterministic variant marks.
5. Emit PNG + model JSON + manifest row.
6. Map custom_model_data into the Minecraft bridge packet.
7. Render a browser/Gradio preview that shows material, shape, pose profile, and /give command together.

The current generator does this deterministically, so an object can be recreated from prompt, owner, and artifact metadata.

Inspection Strategy

The repo now exposes the pack in three ways:

1. assets/afterblock_textures/gallery/index.html shows every item with search, kind filters, model path, and copyable /give commands.
2. assets/afterblock_textures/gallery/contact_sheet_01.png through contact_sheet_32.png provide screenshot-friendly proof pages.
3. The Gradio app includes an Object Atlas and collapsed inspection appendix so judges can inspect PNG previews, materials, model paths, shapes, pose profiles, and CustomModelData values without leaving the Space.

Next Upgrade

Use a real vision model for uploaded images:

photo -> object class -> palette -> archetype geometry -> resource-pack item -> Minecraft pedestal

The app already accepts an optional relic image and stores an image fingerprint. The next step is replacing the local color fingerprint with a VLM classifier.