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

BS-JD-218 - Built-in Default Grid fallback material #66

New Issue
Closed
opened 2026-07-13 17:14:06 -04:00 by Rbanh · 1 comment
Rbanh commented 2026-07-13 17:14:06 -04:00
Owner
Copy Link

Summary

Add one immutable engine-owned WorldGrid-style fallback plus an optional project Material/Instance override so authoring geometry never disappears when no valid material resolves.

Contract

  • Material precedence is: runtime MaterialPropertyBlock -> scene/prefab assignment -> model-asset default -> imported source -> project default -> built-in DefaultGrid.
  • Missing layers inherit downward. A configured but broken scene/model reference renders the fallback with diagnostics instead of silently revealing another authored layer.
  • Built-in DefaultGrid is filesystem-independent, shared, read-only, and never a Material Instance or property-block promotion base.
  • Project Settings > Content may select a project Material/Instance as the project fallback; Clear restores DefaultGrid.
  • Coverage includes static/skinned meshes, primitives without an active material, unassigned brush faces, and model/mesh thumbnails. Terrain retains its specialized fallback.

Implementation

  • Embed one UV-independent world-space tri-planar checker Surface evaluator with a reserved built-in shader ID and forward/Solari parity.
  • Use neutral gray 0.5 m cells with a 4 m major cadence, rough lit shading, subtle visibility-preserving emissive contribution, and double-sided rendering.
  • Cache shared Surface and emergency StandardMaterial handles; remove per-use magenta error-material allocation.
  • Add material-resolution origin/health diagnostics and a read-only Built-ins row.
  • Store the optional project fallback in registry v2 content defaults and include it in the packaged runtime catalog.

Acceptance criteria

  • Unassigned or broken supported authoring geometry remains visible.
  • UV-less static and skinned meshes display the grid.
  • Forward and Solari evaluate the same fallback surface.
  • A valid project fallback replaces DefaultGrid; deleting/breaking it safely restores DefaultGrid with diagnostics.
  • Repeated hydration does not grow fallback material assets.
  • Built-in fallback cannot be edited, instanced, or promoted from a property block.
  • Focused rendering, lifecycle, thumbnail, validation, and native acceptance evidence passes.

Dependencies

Child of #59. The storage/material contract in #60 lands first; project-default stable-ID resolution coordinates with #62. Property-block behavior coordinates with #53.

## Summary Add one immutable engine-owned WorldGrid-style fallback plus an optional project Material/Instance override so authoring geometry never disappears when no valid material resolves. ## Contract - Material precedence is: runtime MaterialPropertyBlock -> scene/prefab assignment -> model-asset default -> imported source -> project default -> built-in DefaultGrid. - Missing layers inherit downward. A configured but broken scene/model reference renders the fallback with diagnostics instead of silently revealing another authored layer. - Built-in DefaultGrid is filesystem-independent, shared, read-only, and never a Material Instance or property-block promotion base. - Project Settings > Content may select a project Material/Instance as the project fallback; Clear restores DefaultGrid. - Coverage includes static/skinned meshes, primitives without an active material, unassigned brush faces, and model/mesh thumbnails. Terrain retains its specialized fallback. ## Implementation - Embed one UV-independent world-space tri-planar checker Surface evaluator with a reserved built-in shader ID and forward/Solari parity. - Use neutral gray 0.5 m cells with a 4 m major cadence, rough lit shading, subtle visibility-preserving emissive contribution, and double-sided rendering. - Cache shared Surface and emergency StandardMaterial handles; remove per-use magenta error-material allocation. - Add material-resolution origin/health diagnostics and a read-only Built-ins row. - Store the optional project fallback in registry v2 content defaults and include it in the packaged runtime catalog. ## Acceptance criteria - [ ] Unassigned or broken supported authoring geometry remains visible. - [ ] UV-less static and skinned meshes display the grid. - [ ] Forward and Solari evaluate the same fallback surface. - [ ] A valid project fallback replaces DefaultGrid; deleting/breaking it safely restores DefaultGrid with diagnostics. - [ ] Repeated hydration does not grow fallback material assets. - [ ] Built-in fallback cannot be edited, instanced, or promoted from a property block. - [ ] Focused rendering, lifecycle, thumbnail, validation, and native acceptance evidence passes. ## Dependencies Child of #59. The storage/material contract in #60 lands first; project-default stable-ID resolution coordinates with #62. Property-block behavior coordinates with #53.
Rbanh added this to the M2 - Content workspace and asset pipeline milestone 2026-07-13 17:14:06 -04:00
Rbanh commented 2026-07-17 23:47:27 -04:00
Author
Owner
Copy Link

Closed against M2 candidate cf6eaba

The immutable engine-owned DefaultGrid fallback is implemented with shared cached handles, project-default selection, broken-reference diagnostics, forward/Solari support, primitive/static/skinned/brush/thumbnail coverage, and a neutral StandardMaterial emergency path. Terrain keeps its specialized fallback.

Consolidated code, deterministic, native, and package evidence: M2 evaluation record. Candidate gates passed in full and the commit is published on codex/m2-content-workspace.

## Closed against M2 candidate `cf6eaba` The immutable engine-owned DefaultGrid fallback is implemented with shared cached handles, project-default selection, broken-reference diagnostics, forward/Solari support, primitive/static/skinned/brush/thumbnail coverage, and a neutral StandardMaterial emergency path. Terrain keeps its specialized fallback. Consolidated code, deterministic, native, and package evidence: [M2 evaluation record](https://git.spacetrainclubhouse.com/Falling-Metal-Interactive/Blacksite/src/commit/cf6eaba53473d2825d0109f5a18f44794af5bd48/docs/editor/evaluations/content-workspace-m2/README.md). Candidate gates passed in full and the commit is published on `codex/m2-content-workspace`.
Rbanh closed this issue 2026-07-17 23:47:35 -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
M2 - Content workspace and asset pipeline
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#66
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?