jpmschweitzer/settled-reach
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(assets): 3D-model+texture catalog, glb-gen production path, conventions (T-1050)

Browse Source 
Instantiates the five D-244 catalog files (models/textures/artwork/icons/
effects — icons carries the 13 as-built SVGs, stance icons traced to their
consumer and marked final), creates client/assets/models/{furniture,props}
with a schema-documented manifest.json mirroring the character manifest,
fixes glb-gen SKILL.md's stale 'path does not exist' paragraph, and authors
docs/assets/visual/conventions.md: category-first model naming (araminta
ruling), mask sidecars per the character convention, D-235-token-keyed
texture naming, footprint_tiles as manifest metadata. Door-state and
TileSet conventions are recorded as explicit deferrals (Phase-5 owned).
visual/README.md carries both this ticket's count/link updates and
T-1052's palette-section rewrite (shared file, committed here).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
jpmschweitzer
2026-07-25 20:20:04 +02:00
co-authored by Claude Fable 5
parent 3b3ef392c5
commit f77e15d075
12 changed files with 429 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/assets/visual/README.md
+9 -3
View File
@@ -7,7 +7,8 @@ status: active
# Visual Asset Pipeline
Status: **Stub** — awaiting first visual sprint.
Status: **Active** — catalog structure instantiated (T-1050); awaiting first
model/texture/artwork/effects production sprint.
Per **[D-244](../../../governance/decisions/architecture.md#d-244)**: the in-world view renders **3D objects directly**. The only flattened 2D content is **textures** (PBR maps on 3D surfaces) and **flat 2D artwork** (paintings, flags, billboards, signage) applied as textures/decals on flat surfaces *within* the 3D world. **There is no per-object sprite layer** — game objects are not pre-rendered to sprites.
@@ -19,12 +20,17 @@ Per **[D-244](../../../governance/decisions/architecture.md#d-244)**: the in-wor
| Characters | — | — | 3D meshes composited at runtime via `CharacterVisualDescriptor` — see [character-asset-organization.md](../../architecture/character-asset-organization.md) |
| Textures | [textures.md](textures.md) | 0 | PBR surface maps (BaseColor / Normal / Roughness) for 3D models |
| Artwork | [artwork.md](artwork.md) | 0 | Flat 2D art — paintings, flags, billboards, signage, screen content — applied as textures/decals (via the `/sprite-gen` 2D-artwork generator) |
| Icons | [icons.md](icons.md) | 0 | UI icons, status indicators (2D, UI layer only) |
| Icons | [icons.md](icons.md) | 13 | UI icons, status indicators (2D, UI layer only) — as-built inventory of `client/assets/icons/` |
| Effects | [effects.md](effects.md) | 0 | Shaders, particles, overlays |
Naming, mask-sidecar, D-235-keyed texture, and multi-tile footprint
conventions: [conventions.md](conventions.md).
## Palette
See [palette.md](palette.md) for art direction, "the angle", and colour relationships.
See [palette.md](palette.md) for art direction: camera (D-148 gameplay / D-019
offline-render), the toon-vs-PBR rendering treatment for environment props, the
D-235 ObjectTag color/material register, and entity colour relationships (D-033).
## Pipeline