Ship production navigation authoring workflow
This commit is contained in:
1 parent
0798aa5d57
commit
b4aa61e394
35 files changed
+3898
-602
No files matched your search
@@ -16,19 +16,36 @@ packaged games and headless validation must consume the same data and behavior.
|
||||
Use the engine-independent Rerecast crate for deterministic 3D walkable-surface generation and
|
||||
Polyanya for any-angle path queries. Blacksite owns reflected authoring components and a versioned
|
||||
generated artifact under `assets/navigation/generated/`. The artifact records the source scene,
|
||||
source fingerprint, agent profile, baked mesh, links, bounds, and diagnostics.
|
||||
source fingerprint, exact generator/toolchain ID, agent profile, baked mesh, links, bounds, polygon
|
||||
count, authored validation samples, a self-verifying payload hash, and raw/effective
|
||||
disconnected-island diagnostics. Bounds do not inject fallback geometry.
|
||||
Each bounds actor owns one artifact path derived from its stable `ActorId` when created or
|
||||
duplicated. Artifact paths remain inside `assets/navigation/generated/`; duplicate ownership is a
|
||||
blocking authoring error rather than last-writer-wins bake behavior.
|
||||
|
||||
The scene crate owns fingerprinting, bake artifact IO, and validation. The game crate owns artifact
|
||||
loading and path queries. Editor bake controls, overlays, and path preview call those shared/game
|
||||
contracts and keep all visual helpers transient. Relevant authored geometry changes mark the
|
||||
artifact stale; V1 debounces a full deterministic rebuild and reports the affected region until
|
||||
Rerecast provides production-ready tiled regeneration.
|
||||
The scene crate owns fingerprinting, bake artifact IO, the engine-independent query runtime, and
|
||||
validation. The game crate provides the Bevy `Vec3` adapter and renderer-free validation CLI.
|
||||
Editor bake controls, overlays, path preview, headless baking, and project validation call the same
|
||||
resolver/query contracts and keep all visual helpers transient. Relevant authored geometry changes
|
||||
mark the artifact stale; V1 debounces a full deterministic rebuild and reports the affected region
|
||||
until Rerecast provides production-ready tiled regeneration.
|
||||
|
||||
The authoritative resolver expands visible scene composition and recursively linked prefab sources
|
||||
from the project root. Repeated contributors receive qualified source identities. Full-value
|
||||
navigation-relevant prefab component overrides are applied deterministically. Property overrides
|
||||
apply only while their serialized source base remains current; drifted property layers and
|
||||
structural overrides are rejected with a rebase/apply/unpack repair action. Bounds inside prefabs
|
||||
are rejected so one level-scene actor remains the unambiguous artifact owner.
|
||||
|
||||
## Consequences
|
||||
|
||||
- Navigation remains usable on Bevy 0.19 without forking an older Bevy integration crate.
|
||||
- Rerecast and Polyanya versions become explicit serialized-artifact compatibility inputs; schema
|
||||
migration or rebaking is required when their representation changes.
|
||||
- Runtime queries resolve vertically overlapping surfaces by endpoint height and may traverse an
|
||||
ordered graph of multiple explicit links; reported distance is measured along the 3D route.
|
||||
- Enabled named path samples become deterministic release assertions evaluated by the same query
|
||||
core used by the editor and game.
|
||||
- Static navigation and explicit links ship first. Runtime obstacle carving, crowd avoidance, and
|
||||
partial tile rebuilding remain future work.
|
||||
- Primitive and additive-brush triangles are deterministic source geometry. Imported static meshes
|
||||
|
||||
Reference in new issue
Block a user