Falling-Metal-Interactive/Blacksite
2
0
Fork 0
Code Issues 15 Pull Requests Actions Packages Projects Releases Wiki Activity

BS-JD-501 - Editor sample scenes and regression pack #32

New Issue
Closed
opened 2026-06-06 01:49:04 -04:00 by Rbanh · 2 comments
Rbanh commented 2026-06-06 01:49:04 -04:00
Owner
Copy Link

Summary

Create curated sample scenes for brushes, materials, terrain, physics placement, and rendering.

Why

Production editor features need stable fixtures that demonstrate intended workflows and catch regressions.

Implementation notes

  • Add sample scenes for each major roadmap area.
  • Keep samples small, deterministic, and documented.
  • Include expected assets/materials and validation notes.
  • Use samples for manual QA and automated tests where possible.

Acceptance criteria

  • Sample scenes cover brush, material, terrain, physics placement, and rendering workflows.
  • Samples open without missing references.
  • README/docs explain what each sample validates.
  • Regression pack can be used before releases.

Tests/docs

Scene load validation and fixture checks. Update README sample/project docs.

Completion evidence

## Summary Create curated sample scenes for brushes, materials, terrain, physics placement, and rendering. ## Why Production editor features need stable fixtures that demonstrate intended workflows and catch regressions. ## Implementation notes - Add sample scenes for each major roadmap area. - Keep samples small, deterministic, and documented. - Include expected assets/materials and validation notes. - Use samples for manual QA and automated tests where possible. ## Acceptance criteria - [x] Sample scenes cover brush, material, terrain, physics placement, and rendering workflows. - [x] Samples open without missing references. - [x] README/docs explain what each sample validates. - [x] Regression pack can be used before releases. ## Tests/docs Scene load validation and fixture checks. Update README sample/project docs. ## Completion evidence - Final main commit: `62b538999d436a55b21596fb00912b2e69a77d6f` - Exact native implementation commit: `d52cc2e3b72c908d192ed9e9f49306c25367599b` - [Native screenshots and interaction matrix](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/32#issuecomment-1057) - [Final gate summary](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/32#issuecomment-1058)
blacksite-brush-d52cc2e.png
1.5 MiB
blacksite-terrain-solari-d52cc2e.png
1.2 MiB
blacksite-rendering-vignette-d52cc2e.png
1.5 MiB
blacksite-brush-d52cc2e.png blacksite-terrain-solari-d52cc2e.png blacksite-rendering-vignette-d52cc2e.png
Rbanh added this to the M5 - Regression, docs, and first-hour UX milestone 2026-06-06 01:49:04 -04:00
Rbanh added the
roadmap:jackdaw
type:docs
priority:P0
area:quality
 labels 2026-06-06 01:49:04 -04:00
Rbanh commented 2026-07-13 04:16:03 -04:00
Author
Owner
Copy Link

Native sample-pack acceptance — d52cc2e3b72c908d192ed9e9f49306c25367599b

Exact native Wayland rerun completed on Arch Linux / Hyprland 0.55.4, Bevy 0.19.0, NVIDIA RTX 3080 Ti (driver 610.43.03), with the viewport reporting the effective Solari path.

  • Brush: distinct foundation, material-face tower, and subtractive marker; one tower face selected in Brush Clip and canceled without history/helper leakage.
  • Material: surface_tint_instance dropped on an exact primitive surface; one history entry; Ctrl+Z restored the prior material.
  • Terrain: Concrete and Surface Tint layers rendered visibly under Solari through the forward raster boundary; sculpt and paint strokes both canceled with exact restore and clean history.
  • Physics Placement: three props settled in 2.3s; cancel restored all starting transforms; the second run committed one Move Selection entry and Ctrl+Z restored it.
  • Rendering: camera traversal reported Foggy courtyard 73% / 2 overrides, Cave mouth 100% / 2 overrides, and Vignette demo 68%, with visible fog/exposure/vignette changes.
  • Process log: no warnings or errors across all five menu opens and interactions.

These are direct Gitea issue attachments, not repository raw URLs or Git LFS pointers.

Brush Blockout

Brush Blockout

Terrain Layers Under Solari

Terrain Layers Under Solari

Rendering Vignette Volume

Rendering Vignette Volume

## Native sample-pack acceptance — `d52cc2e3b72c908d192ed9e9f49306c25367599b` Exact native Wayland rerun completed on Arch Linux / Hyprland 0.55.4, Bevy 0.19.0, NVIDIA RTX 3080 Ti (driver 610.43.03), with the viewport reporting the effective Solari path. - **Brush:** distinct foundation, material-face tower, and subtractive marker; one tower face selected in Brush Clip and canceled without history/helper leakage. - **Material:** `surface_tint_instance` dropped on an exact primitive surface; one history entry; Ctrl+Z restored the prior material. - **Terrain:** Concrete and Surface Tint layers rendered visibly under Solari through the forward raster boundary; sculpt and paint strokes both canceled with exact restore and clean history. - **Physics Placement:** three props settled in 2.3s; cancel restored all starting transforms; the second run committed one `Move Selection` entry and Ctrl+Z restored it. - **Rendering:** camera traversal reported Foggy courtyard 73% / 2 overrides, Cave mouth 100% / 2 overrides, and Vignette demo 68%, with visible fog/exposure/vignette changes. - **Process log:** no warnings or errors across all five menu opens and interactions. These are direct Gitea issue attachments, not repository raw URLs or Git LFS pointers. ### Brush Blockout ![Brush Blockout](https://git.spacetrainclubhouse.com/attachments/078aa0dc-4cc2-4ef3-baf8-16176bf316d9) ### Terrain Layers Under Solari ![Terrain Layers Under Solari](https://git.spacetrainclubhouse.com/attachments/ffb4940a-7ed8-493f-acc1-b743d61dbdae) ### Rendering Vignette Volume ![Rendering Vignette Volume](https://git.spacetrainclubhouse.com/attachments/20b8a08a-905e-4c54-85b2-0ce17fbd5840)
Rbanh commented 2026-07-13 04:21:50 -04:00
Author
Owner
Copy Link

Implemented and verified on main through 62b538999d436a55b21596fb00912b2e69a77d6f.

Implementation/native revision: d52cc2e3b72c908d192ed9e9f49306c25367599b.
Evidence record: docs/editor/evaluations/sample-regression-pack/README.md.
Native attachments and interaction matrix: #32 (comment)

Final gates:

  • cargo test --workspace --all-targets --no-fail-fast: pass (editor 258, shared 98, scene 97 pass + 1 intentional ignore).
  • Workspace and validate-samples-feature clippy with -D warnings: pass.
  • cargo validate-levels --project .: 81 dependencies, 5 known nonblocking findings, 0 blockers.
  • cargo validate-samples --project .: 5 samples, 86 dependencies, 5 known nonblocking findings, 0 blockers.
  • Repeated JSON validation: byte-identical.
  • git lfs fsck, format, and diff hygiene: pass.
  • Exact native menu pass: all five samples and required interactions pass; process log remained warning/error free.
  • Packaged testing remains intentionally skipped by project-owner direction.

The sample-pack acceptance criteria are complete. Release-candidate reruns remain governed by #50; the separate production blockers are tracked in #55 (P0) and #56 (P1).

Implemented and verified on `main` through `62b538999d436a55b21596fb00912b2e69a77d6f`. Implementation/native revision: `d52cc2e3b72c908d192ed9e9f49306c25367599b`. Evidence record: `docs/editor/evaluations/sample-regression-pack/README.md`. Native attachments and interaction matrix: https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/issues/32#issuecomment-1057 Final gates: - `cargo test --workspace --all-targets --no-fail-fast`: pass (editor 258, shared 98, scene 97 pass + 1 intentional ignore). - Workspace and validate-samples-feature clippy with `-D warnings`: pass. - `cargo validate-levels --project .`: 81 dependencies, 5 known nonblocking findings, 0 blockers. - `cargo validate-samples --project .`: 5 samples, 86 dependencies, 5 known nonblocking findings, 0 blockers. - Repeated JSON validation: byte-identical. - `git lfs fsck`, format, and diff hygiene: pass. - Exact native menu pass: all five samples and required interactions pass; process log remained warning/error free. - Packaged testing remains intentionally skipped by project-owner direction. The sample-pack acceptance criteria are complete. Release-candidate reruns remain governed by #50; the separate production blockers are tracked in #55 (P0) and #56 (P1).
Rbanh closed this issue 2026-07-13 04:22:07 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels   
area:animation

Skeletal animation import, preview, graph/state authoring, and runtime integration.

  
area:assets

Asset browser, material browser, thumbnails, import, processing, and asset watcher.

  
area:audio

Audio source/listener authoring, buses, spatial preview, and runtime integration.

  
area:brushes

Brush geometry, CSG, face editing, UVs, and brush diagnostics.

  
area:build-release

Build profiles, packaging, content validation, release gates, and distribution diagnostics.

  
area:extensions

Static extension API, extension scaffolds, dylib exploration.

  
area:governance

Policy, attribution, planning, and production process.

  
area:hierarchy

Outliner hierarchy, parenting, grouping, prefab structure, ordering, and selection workflows.

  
area:inspector

Inspector, component metadata, component editing UX.

  
area:navigation

Navigation mesh authoring, baking, diagnostics, and AI path preview.

  
area:operators

Editor operator/action framework, undo, commit/cancel semantics.

  
area:physics

Physics placement, colliders, rigid bodies, diagnostics, and overlays.

  
area:project-ux

Project launcher, profiles, templates, or first-run project workflow.

  
area:quality

Regression packs, tests, performance budgets, profiler, first-hour UX.

  
area:rendering

Static and skinned renderers, material slots, shaders, ray tracing, and render-path integration.

  
area:runtime

BRP, remote inspector, PIE, game preview, runtime integration.

  
area:scene-io

Scene document, save/load, schema, migration, or reference repair.

  
area:terrain

Terrain authoring, terrain sculpting, heightmaps, and terrain materials.

  
area:viewport

Viewport interaction, selection, shortcuts, camera, overlays, and controls.

  
priority:P0

Must-have prerequisite or milestone-critical item.

  
priority:P1

Important production feature after P0 work is stable.

  
priority:P2

Useful follow-up or polish item.

  
priority:P3

Exploratory or later spike.

  
roadmap:jackdaw

Jackdaw-inspired Blacksite editor roadmap item.

  
roadmap:production

Blacksite production-readiness roadmap item beyond the Jackdaw-inspired foundation.

  
type:architecture

Architecture, internal framework, or hard-to-reverse technical decision.

  
type:docs

Documentation, policy, samples, or issue-board structure.

  
type:epic

Tracking epic that groups related milestone work.

  
type:feature

User-visible feature or capability.

No Label
area:animation
area:assets
area:audio
area:brushes
area:build-release
area:extensions
area:governance
area:hierarchy
area:inspector
area:navigation
area:operators
area:physics
area:project-ux
area:quality
area:rendering
area:runtime
area:scene-io
area:terrain
area:viewport
priority:P0
priority:P1
priority:P2
priority:P3
roadmap:jackdaw
roadmap:production
type:architecture
type:docs
type:epic
type:feature
Milestone
Clear milestone
No items
No Milestone
M5 - Regression, docs, and first-hour UX
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Falling-Metal-Interactive/Blacksite#32
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?