---
title: "Models — Visual Assets"
description: "3D object/furniture/prop asset catalog — status table for the Trellis glb-gen pipeline"
type: design
status: active
---

# Models — Visual Assets

3D objects and furniture/props rendered directly in-world as `.glb` meshes
(D-244 — no per-object sprite layer). Produced via the Trellis image→3D
pipeline (`/glb-gen`), promoted per D-241 into `client/assets/models/`.

## Generation Approach

- **Concept image:** `/image-gen` produces a concept PNG (square, plain dark
  background, single object centered, 3/4 front view — see
  `.claude/skills/glb-gen/SKILL.md` "Input Requirements").
- **Image → 3D:** Trellis (`tower-of-joy:11510`) converts the concept image
  to a raw `.glb` (`/glb-gen`).
- **Post-process:** Blender normalizes scale, centers the mesh, generates the
  recolor mask sidecar, and sets up materials for toon rendering
  (`.claude/skills/glb-gen/scripts/postprocess_glb.py`).
- **Promotion:** the finished `.glb` (+ mask, if tintable) lands in
  `client/assets/models/{furniture,props}/` and is registered in
  `client/assets/models/manifest.json` — that registration + placement act
  **is** the promotion (D-241); it does not stay a "promoted" spike artifact.

Naming, mask-sidecar, and multi-tile footprint conventions:
[conventions.md](conventions.md).

## Assets

| ID | Filename | Status | Category | Footprint | Notes | Sprint/Ticket |
|----|----------|--------|----------|-----------|-------|---------------|
| table_baroque | `furniture/table_baroque.glb` | planned | furniture | [1, 1] | Promoted from spike (`baroque_table.glb`, renamed category-first); mask sidecar present; spike README flags the mask as "too aggressive — tints the whole model bright white", not yet re-tuned | T-1204 |
| chair_modernist | `furniture/chair_modernist.glb` | planned | furniture | [1, 1] | Promoted from spike (`modernist_chair.glb`, renamed category-first); mask sidecar present | T-1204 |
| desk_scifi | `furniture/desk_scifi.glb` | planned | furniture | [1, 1] | Promoted from spike (`scifi_desk.glb`, renamed category-first); mask sidecar present | T-1204 |
| lion_statue | `props/lion_statue.glb` | planned | props | [1, 1] | Promoted from spike as-is (no rename); "fixed" mode, non-tintable — no mask sidecar per brief §3 | T-1204 |

These four rows are the first promoted assets (T-1204, `furniture-props.md`
brief's first acceptance) — the 3 in-scope spike furniture GLBs plus
`lion_statue`, already Blender-postprocessed (`mat_primary`,
roughness=1.0/specular=0.0 confirmed via Blender headless inspection) in the
spike, so no re-run of `postprocess_glb.py` was needed at promotion time.
`vw_beetle.glb` stays excluded (Q-067 car deferral). Footprint is `[1, 1]`
for all four — the spike GLBs are Blender-normalized to `target-width=1.0`
(max dimension ≤ 1m on every axis after normalization), so none of the actual
promoted meshes has real-world geometry spanning more than one tile; the
brief's `[2, 1]` table example is illustrative of the convention, not a
derived value for these specific assets. Further rows are added as new
assets are promoted/generated; keep this table's `Status` column in sync with
the manifest's `status` field (shared vocab: planned / in-progress /
placeholder / final, `docs/assets/README.md`).

## Cross-References

- [conventions.md](conventions.md) — naming, mask sidecars, footprint metadata
- `client/assets/models/manifest.json` — the machine-readable per-asset registry
- `.claude/skills/glb-gen/SKILL.md` — production pipeline
- [D-244](../../../governance/decisions/architecture.md#d-244-asset-rendering--3d-objects-in-world-2d-limited-to-textures--flat-artwork), [D-241](../../../governance/decisions/process.md#d-241-spike-binary-artifacts-are-local-only--gitignored-never-tracked)