Close the v0.6.0 graphics plan and record the release
- TODO now tracks only the visual-alignment pass and optional future ideas; the completed Blender/graphics plan moved out - DONE records the six published v0.6.0 artifacts and final verification counts - header updated to v0.6.0 / 222 headless / 69 Python tests
This commit is contained in:
1 parent
d872034388
commit
d307746351
2 files changed
+18
-74
No files matched your search
@@ -878,3 +878,12 @@ Completed 2026-11-01 (v0.6.0). Headless **222/222**, Python **69/69**, all smoke
|
|||||||
deferred.
|
deferred.
|
||||||
- [x] Recaptured `docs/screenshots/` and ran `compare` + `judge`; no regressions.
|
- [x] Recaptured `docs/screenshots/` and ran `compare` + `judge`; no regressions.
|
||||||
- [x] Fixed the library marquee text/face alignment and added the library AO/triangle tests.
|
- [x] Fixed the library marquee text/face alignment and added the library AO/triangle tests.
|
||||||
|
|
||||||
|
## v0.6.0 Release
|
||||||
|
|
||||||
|
Completed 2026-11-01. `config/version` = `0.6.0`; ADR-0013 marked Accepted; CI published six
|
||||||
|
artifacts (Linux, Windows, macOS, NSIS installer, AppImage, Web) for tag `v0.6.0`.
|
||||||
|
|
||||||
|
- [x] Bumped the version and synchronised README/architecture/blender-assets/plan docs.
|
||||||
|
- [x] Headless **222/222**, Python **69/69**, all smokes, `compare` **11 good / 0 bad**.
|
||||||
|
- [x] Release verified: `https://git.allucanget.biz/zwitschi/security-game/releases/tag/v0.6.0`.
|
||||||
@@ -1,85 +1,16 @@
|
|||||||
# TODO
|
# TODO
|
||||||
|
|
||||||
Godot 4.3 prototype. Latest release **v0.5.0** (NPC characters and player movement). Headless
|
Godot 4.3 prototype. Latest release **v0.6.0** (Blender character/gear/prop library, baked AO, environment lift).
|
||||||
suite **222/222** plus **68** Python tooling tests; the session, PLAN-verb, crowd, emergency,
|
Headless suite **222/222** plus **69** Python tooling tests; the session, PLAN-verb, crowd, emergency,
|
||||||
timeline, audio, scenario-content, props, NPC-budget, movement, and windowed focus/radial smokes
|
timeline, audio, scenario-content, props, NPC-budget, movement, and windowed focus/radial smokes
|
||||||
pass. Anonymous downloads are enabled on the host.
|
pass. Anonymous downloads are enabled on the host.
|
||||||
|
|
||||||
The scheduled presentation pass is complete (see `DONE.md`). The next scheduled pass is the
|
The scheduled presentation pass is complete (see `DONE.md`). The next scheduled pass is the
|
||||||
graphics-quality work in [`docs/plan-graphics-v0.6.md`](docs/plan-graphics-v0.6.md).
|
graphics-quality work in [`docs/plan-graphics-v0.6.md`](docs/plan-graphics-v0.6.md).
|
||||||
|
|
||||||
> **Blender asset library integrated (2026-11-01):** 8 NPC character variants, 18 gear pieces,
|
> **v0.6.0 shipped (2026-11-01):** the Blender character/gear/prop library is integrated, AO maps
|
||||||
> and 20 street/venue props are now loaded by `NpcAvatar` and `WorldBuilder` from
|
> are baked and wired, and the environment textures were lifted to 1024² with normal maps. See
|
||||||
> `assets/models/blender/` (manifest as source of truth, see
|
> `DONE.md` for the completed graphics plan.
|
||||||
> [`docs/blender-assets.md`](docs/blender-assets.md)). The procedural rig and primitive props
|
|
||||||
> remain offline fallbacks; AO/ORM baking is the remaining Phase 4 follow-up.
|
|
||||||
|
|
||||||
## Graphics quality — Blender-authored NPC characters (v0.6.0)
|
|
||||||
|
|
||||||
Detailed plan: [`docs/plan-graphics-v0.6.md`](docs/plan-graphics-v0.6.md) · [ADR-0013](docs/adr/0013-blender-authored-npc-characters.md)
|
|
||||||
|
|
||||||
### Phase 0 — Toolchain spike and contract freeze
|
|
||||||
|
|
||||||
- [x] Verify `flatpak run org.blender.Blender --version` reports Blender 5.2.x and runs headless in this shell.
|
|
||||||
- [x] Run a minimal headless Blender export using an absolute `--python` path (sandbox cwd is `/app/blender`); confirm the output file lands where expected.
|
|
||||||
- [x] Record the exact working invocation (flatpak + absolute paths) in `MEMORY.md`.
|
|
||||||
- [x] Freeze the NPC asset contract in `docs/plan-graphics-v0.6.md` and ADR-0013: file paths, bone names, material slots, triangle budget.
|
|
||||||
- [x] Fix the material-slot set (`skin` / `cloth` / `pants` / `accessory` / `hair`) and the ORM packing (R=occlusion, G=roughness, B=metallic).
|
|
||||||
- [x] Choose and record the initial tier-0 triangle/vertex budget (≤ ~6000 tris / ~4000 verts) in the plan.
|
|
||||||
- [x] Spike: Godot 4.3 imports the `.glb` as a `PackedScene` with a `Skeleton3D`; no clips are needed because `_animate()` drives the bones at runtime.
|
|
||||||
|
|
||||||
### Phase 1 — Blender authoring + export pipeline
|
|
||||||
|
|
||||||
- [x] Author the low-poly base humanoid in Blender: torso, articulated arms/legs, head with a face front, hands, shoes.
|
|
||||||
- [x] Rig with an armature whose bones mirror the node contract (`Head`, `HipL/R`, `KneeL/R`, `ShoulderL/R`, `ElbowL/R`, `HandL/R`); origin at the feet, +Y up.
|
|
||||||
- [x] UV-unwrap the mesh into a power-of-two layout, one region per material slot.
|
|
||||||
- [x] Save the editable source as `assets/models/npc/npc_base.blend` (committed).
|
|
||||||
- [x] Add `tools/npc_pipeline.py` with `list` / `build` / `audit` subcommands, run through the Blender flatpak.
|
|
||||||
- [x] `build` exports `assets/models/generated/npc_base.glb` plus the material textures.
|
|
||||||
- [x] Bake neutral albedo per slot, normal maps (fabric weave, denim, knit), and the packed ORM map.
|
|
||||||
- [x] Bake ambient occlusion into the albedo or the ORM R channel (the Compatibility renderer has no SSAO).
|
|
||||||
- [x] `audit` enforces UVs in [0,1], expected bone names, triangle/vertex budget, feet at y≈0, and material-slot presence.
|
|
||||||
- [x] Reuse the `model_pipeline.py` colour-space discipline (linear factors vs sRGB textures) in the exporter.
|
|
||||||
- [x] Run `godot --headless --path . --import` and confirm `npc_base.glb` imports without errors.
|
|
||||||
|
|
||||||
### Phase 2 — AI-assisted texturing
|
|
||||||
|
|
||||||
- [x] Generate seamless clothing albedos (shirt, trousers, jacket, hi-vis vest, coat, dress) with `tools/asset_pipeline.py generate` (OpenRouter, `openai/gpt-5-image-mini`) — written to `assets/textures/npc/ai/` (512×512).
|
|
||||||
- [x] Tile-edge blending on each fabric — applied automatically by `generate --role tile` (`make_seamless`); the `tile` audit's edge check confirms continuity.
|
|
||||||
- [x] Run `asset_pipeline.py audit` on the outputs — 6 good, 0 bad (role `tile`).
|
|
||||||
- [x] Commit the validated textures under `assets/textures/npc/ai/` (tracked in the v0.6.0 asset commit).
|
|
||||||
- [x] Derive per-role outfit palettes via `model_pipeline.dominant_colors` — written to `assets/textures/npc/palette.json` (`npc_pipeline.py palette`).
|
|
||||||
- [x] Bake normal/roughness procedurally and layer the AI albedos on top — `npc_pipeline.py prepare` + Blender `build` keeps the AI albedo for `cloth`/`pants` and regenerates normal/ORM; GLB audit ok (1204 tris / 2488 verts).
|
|
||||||
- [x] Regenerate the staged captures and run `screen_designs.py judge` after the Phase 3 integration (11 good / 0 bad in `compare`; judge: no diff).
|
|
||||||
|
|
||||||
### Phase 3 — Godot integration
|
|
||||||
|
|
||||||
- [x] Add `NpcAvatar._load_model()` that instantiates the imported `npc_base.glb` `PackedScene`.
|
|
||||||
- [x] Keep `_build_body()` as the offline fallback; choose per-avatar and record `loaded_model` / `fallback_avatar` for tests.
|
|
||||||
- [x] Map `outfit_for()` onto the model's material slots so seed variety, `layer_for`, `hand_item_for`, and archetype colors survive.
|
|
||||||
- [x] Keep accessory attachments (cap / hood / backpack / sunglasses / lanyard) under `Rig` / `Head`.
|
|
||||||
- [x] Add `SurfaceMaterials` baked-map recipes (`npc()` / `skin()` / `cloth()`); stop calling `Materials.flat()` for the body.
|
|
||||||
- [x] Add `_set_limb_rotation()` so `_animate()` / `_idle_layer()` write to bones or pivots; keep `Rig/Head` findable by the focus cone.
|
|
||||||
- [x] Update `test_npc_character`, `test_npc_theater`, and `test_target_cycle` for the skinned path (or document why they stay on the fallback).
|
|
||||||
- [x] Re-measure `smoke_npc_budget.gd`; tune `LOD_TIERS` if the skinned rig is heavier up close.
|
|
||||||
- [x] Re-verify the focus-cone smoke (`smoke_focus_radial.gd`) and the movement smoke.
|
|
||||||
|
|
||||||
### Phase 4 — Environment and lighting lift ✅
|
|
||||||
|
|
||||||
- [x] Bake AO for the prop set through the Blender library (replacements above) or into the ORM/albedo maps behind the existing `WorldBuilder` contract; keep the procedural fallback.
|
|
||||||
- [x] Regenerate higher-resolution brick / concrete / asphalt textures via `asset_pipeline.py` with normal maps, keeping the current UV scales; apply the same map discipline to the library's street materials.
|
|
||||||
- [x] Evaluate a desktop-only Forward+ export preset (SSAO/SSIL/volumetrics); keep the Web preset on GL Compatibility with `thread_support=false`.
|
|
||||||
- [x] Record the renderer decision in an ADR addendum or `MEMORY.md`.
|
|
||||||
- [x] Regenerate `docs/screenshots/` with `capture_screenshots.gd` and run `screen_designs.py compare`.
|
|
||||||
|
|
||||||
### Phase 5 — Verification and release
|
|
||||||
|
|
||||||
- [x] Headless suite green: fallback build, outfit determinism, `Rig/Head` presence, material recipe assertions, `npc_pipeline.py audit`, and `blender_assets.py audit` + manifest tests (skip Blender builds with a reason when Blender is absent).
|
|
||||||
- [x] Windowed smokes pass: `smoke_npc_budget.gd`, `smoke_movement.gd`, `smoke_focus_radial.gd`, `smoke_props.gd`.
|
|
||||||
- [x] `screen_designs.py compare` and `judge` show no regressions; `blender_assets.py sheet` contact sheets reviewed for the character/gear/prop library.
|
|
||||||
- [ ] Bump `config/version` to `0.6.0`.
|
|
||||||
- [ ] Update `README.md`, `docs/architecture.md` (Level 2 gains `tools/npc_pipeline.py`), and mark ADR-0013 Accepted.
|
|
||||||
- [ ] Publish the release per `docs/RELEASING.md`.
|
|
||||||
|
|
||||||
## Visual alignment with rendered mockups
|
## Visual alignment with rendered mockups
|
||||||
|
|
||||||
@@ -129,6 +60,10 @@ and scene visuals with those mockups — verified with
|
|||||||
- [ ] Run `screen_designs.py judge` and clear every `diff` verdict (target `match`/`review`).
|
- [ ] Run `screen_designs.py judge` and clear every `diff` verdict (target `match`/`review`).
|
||||||
- [ ] Add the capture + compare step to CI or a repeatable smoke so drift is caught early.
|
- [ ] Add the capture + compare step to CI or a repeatable smoke so drift is caught early.
|
||||||
|
|
||||||
|
## Fix mouse movement bug
|
||||||
|
|
||||||
|
- [ ] Investigate why mouse input is not being captured or processed correctly in the game window.
|
||||||
|
|
||||||
## Improve in-game pop-ups
|
## Improve in-game pop-ups
|
||||||
|
|
||||||
- [ ] Improve the visual appearance of in-game pop-ups (layout, button style, palette, icons, and text styling).
|
- [ ] Improve the visual appearance of in-game pop-ups (layout, button style, palette, icons, and text styling).
|
||||||
|
|||||||
Reference in new issue
Block a user