LOCKSTEP NAVIGATION FOR .NET
Give every agent the same way forward.
Trailblazer combines immutable GridForge-backed maps, deterministic A* and flow fields, explicit traversal actions, controller services, and fixed-point heightmaps inside world-owned contexts.
Build and publish navigation truth
Own the world
Keep the clock, GridForge binding, pathing state, guide services, and heightmaps isolated inside one explicit context.
Author immutable maps
Give physical cells complete navigation meaning, connections, and semantic transitions in canonical order.
Publish deterministic changes
Admit maps, policies, removals, and overlays for fixed-step application without search-time callbacks.
Query, guide, and move
Describe one exact request
Choose endpoints, body geometry, traversal media, area policy, algorithm, finite work budget, and action permission explicitly.
Acquire A* or Flow guidance
Consume immutable-payload leases with acquisition-local cursors and completion-safe action instructions.
Compose a controller
Bring steering, turning, motor, locomotion, occupancy, heightmap grounding, and explicit serialization together when your host needs them.
Package family
| Package | Serialization profile |
|---|---|
Trailblazer |
Standard LSF dependencies with JSON and MemoryPack support |
Trailblazer.Lean |
Lean LSF dependencies and JSON without the MemoryPack transport |
Use one package family throughout the complete LSF dependency graph.
Part of the LSF stack
Trailblazer builds navigation and controller policy on focused lower layers:
- FixedMathSharp for deterministic fixed-point math, transforms, and geometry.
- SwiftCollections for low-allocation collections, pools, and retained storage.
- GridForge for world topology, physical cell identity, prisms, contacts, and geometry proofs.
- Chronicler for explicit state transfer, JSON, MemoryPack, and record schemas.
Resources
- Behavioral guides and getting started
- v1 to v2 migration guide
- Source, issues, and releases
- Core test-suite coverage
The API reference is generated from Trailblazer's XML documentation. The wiki explains world ownership, authoring, publication, pathing, guides, transitions, controllers, serialization, and troubleshooting in task-oriented prose.