navmap 
Vars | |
| active_cost_searches | Weighted DM fallback searches that have consumed terrain costs. |
|---|---|
| generating_station_navmap | True while generating a station bake file. |
| ground_rep | Baseline movers used to bake static ground and flying edges. |
| nav_cost_generation | Changes when turf terrain-cost flags or their passability dependencies are invalidated. |
| nav_groups | Layered navigation groups and z-level lookup. |
| nav_links_by_source | Navigation links indexed by their source turf for the DM fallback search. |
| published_nav_cost_flags | Nonzero terrain costs and later changes, keyed by coordinate. |
| startup_dirty_costs | Terrain cost changes collected during startup. |
| startup_dirty_currentrun | Startup dirties being baked. Kept across subsystem recovery. |
| startup_dirty_turfs | Startup dirties keyed by "x,y,z", since turfs can be replaced. |
| startup_finalization_pending | True until startup changes have been baked. |
| startup_publication_batch | Native updates waiting to be sent during startup. |
Procs | |
| Initialize | Initializes bake representatives, blocker caches, and existing z-level data. |
| Recover | Preserves baked navigation-link state when the subsystem is replaced. |
| current_map_fingerprint | Hashes the loaded map config and DMM files. |
| export_station_navmap | Saves static station edges, marking turfs that need baking at startup. |
| fire | Bakes queued turfs until the tick budget is exhausted. |
| flush_startup_dirty_turfs | Bakes turfs changed during startup. |
| groups_reachable | Checks whether two turfs are connected by z-levels and navigation links. |
| is_auto_dirty_zlevel | Checks whether a level uses the automatic bake policy. |
| mark_startup_turf_baked | Remembers a bake only when this coordinate is already dirty. |
| navmap_cache_layer_valid | Checks a layer's size and palette before restoring its tiles. |
| navmap_cache_run_valid | Checks one run as it is read from the cache. |
| on_new_zlevel | Enables automatic dirtying for a newly relevant z-level. |
| prebake_z | Bakes and bulk-publishes every non-space turf on a z-level. |
| publish_nav_cost_flags | Publishes effective turf cost flags and notifies fallback searches using changed groups. |
| publish_startup_navmap_batch | Sends a batch to the native cache. |
| publish_topology | Publishes the current z-level topology to the native cache. |
| queue_startup_dirty_coordinate | Queues startup work only on the auto spots |
| queue_turf_bake | Queues a dirty turf once for asynchronous baking. |
| read_navmap_json | Reads a saved navmap or its index. |
| rebuild_topology | Rebuilds the stable group/layer mapping consumed by native multi-z searches. |
| record_startup_cost_dirty | Queues terrain cost changes made during startup. |
| record_startup_dirty_coordinate | Queues a turf and clears its old navigation data. |
| record_startup_dirty_turf | Queues a turf and affected neighbours by their coordinates. |
| register_nav_link | Registers a reusable transition and publishes its endpoints to the native cache. |
| restore_station_navmap_layer | Restores a station layer and queues turfs that need baking. |
| stat_entry | Reports the number of turfs waiting to bake. |
| sync_native_state | Re-publishes native topology and navigation links when state is stale. |
| sync_nav_links | Publishes all currently valid navigation links. |
| try_restore_station_navmap | Loads and checks the station bake before restoring it. |
| turf_has_nav_relevant_contents | Checks for contents that can affect navigation. |
| unregister_nav_link | Removes a transition and republishes the native navigation-link cache. |
Var Details
active_cost_searches 
Weighted DM fallback searches that have consumed terrain costs.
generating_station_navmap 
True while generating a station bake file.
ground_rep 
Baseline movers used to bake static ground and flying edges.
nav_cost_generation 
Changes when turf terrain-cost flags or their passability dependencies are invalidated.
nav_groups 
Layered navigation groups and z-level lookup.
nav_links_by_source 
Navigation links indexed by their source turf for the DM fallback search.
published_nav_cost_flags 
Nonzero terrain costs and later changes, keyed by coordinate.
startup_dirty_costs 
Terrain cost changes collected during startup.
startup_dirty_currentrun 
Startup dirties being baked. Kept across subsystem recovery.
startup_dirty_turfs 
Startup dirties keyed by "x,y,z", since turfs can be replaced.
startup_finalization_pending 
True until startup changes have been baked.
startup_publication_batch 
Native updates waiting to be sent during startup.
Proc Details
Initialize
Initializes bake representatives, blocker caches, and existing z-level data.
Recover
Preserves baked navigation-link state when the subsystem is replaced.
current_map_fingerprint
Hashes the loaded map config and DMM files.
export_station_navmap
Saves static station edges, marking turfs that need baking at startup.
fire
Bakes queued turfs until the tick budget is exhausted.
flush_startup_dirty_turfs
Bakes turfs changed during startup.
groups_reachable
Checks whether two turfs are connected by z-levels and navigation links.
is_auto_dirty_zlevel
Checks whether a level uses the automatic bake policy.
mark_startup_turf_baked
Remembers a bake only when this coordinate is already dirty.
navmap_cache_layer_valid
Checks a layer's size and palette before restoring its tiles.
navmap_cache_run_valid
Checks one run as it is read from the cache.
on_new_zlevel
Enables automatic dirtying for a newly relevant z-level.
prebake_z
Bakes and bulk-publishes every non-space turf on a z-level.
publish_nav_cost_flags
Publishes effective turf cost flags and notifies fallback searches using changed groups.
publish_startup_navmap_batch
Sends a batch to the native cache.
publish_topology
Publishes the current z-level topology to the native cache.
queue_startup_dirty_coordinate
Queues startup work only on the auto spots
queue_turf_bake
Queues a dirty turf once for asynchronous baking.
read_navmap_json
Reads a saved navmap or its index.
rebuild_topology
Rebuilds the stable group/layer mapping consumed by native multi-z searches.
record_startup_cost_dirty
Queues terrain cost changes made during startup.
record_startup_dirty_coordinate
Queues a turf and clears its old navigation data.
record_startup_dirty_turf
Queues a turf and affected neighbours by their coordinates.
register_nav_link
Registers a reusable transition and publishes its endpoints to the native cache.
restore_station_navmap_layer
Restores a station layer and queues turfs that need baking.
stat_entry
Reports the number of turfs waiting to bake.
sync_native_state
Re-publishes native topology and navigation links when state is stale.
sync_nav_links
Publishes all currently valid navigation links.
try_restore_station_navmap
Loads and checks the station bake before restoring it.
turf_has_nav_relevant_contents
Checks for contents that can affect navigation.
unregister_nav_link
Removes a transition and republishes the native navigation-link cache.