/tg/ Station 13 - Modules - Types — Var Details - Proc Details

navmap

Vars

active_cost_searchesWeighted DM fallback searches that have consumed terrain costs.
generating_station_navmapTrue while generating a station bake file.
ground_repBaseline movers used to bake static ground and flying edges.
nav_cost_generationChanges when turf terrain-cost flags or their passability dependencies are invalidated.
nav_groupsLayered navigation groups and z-level lookup.
nav_links_by_sourceNavigation links indexed by their source turf for the DM fallback search.
published_nav_cost_flagsNonzero terrain costs and later changes, keyed by coordinate.
startup_dirty_costsTerrain cost changes collected during startup.
startup_dirty_currentrunStartup dirties being baked. Kept across subsystem recovery.
startup_dirty_turfsStartup dirties keyed by "x,y,z", since turfs can be replaced.
startup_finalization_pendingTrue until startup changes have been baked.
startup_publication_batchNative updates waiting to be sent during startup.

Procs

InitializeInitializes bake representatives, blocker caches, and existing z-level data.
RecoverPreserves baked navigation-link state when the subsystem is replaced.
current_map_fingerprintHashes the loaded map config and DMM files.
export_station_navmapSaves static station edges, marking turfs that need baking at startup.
fireBakes queued turfs until the tick budget is exhausted.
flush_startup_dirty_turfsBakes turfs changed during startup.
groups_reachableChecks whether two turfs are connected by z-levels and navigation links.
is_auto_dirty_zlevelChecks whether a level uses the automatic bake policy.
mark_startup_turf_bakedRemembers a bake only when this coordinate is already dirty.
navmap_cache_layer_validChecks a layer's size and palette before restoring its tiles.
navmap_cache_run_validChecks one run as it is read from the cache.
on_new_zlevelEnables automatic dirtying for a newly relevant z-level.
prebake_zBakes and bulk-publishes every non-space turf on a z-level.
publish_nav_cost_flagsPublishes effective turf cost flags and notifies fallback searches using changed groups.
publish_startup_navmap_batchSends a batch to the native cache.
publish_topologyPublishes the current z-level topology to the native cache.
queue_startup_dirty_coordinateQueues startup work only on the auto spots
queue_turf_bakeQueues a dirty turf once for asynchronous baking.
read_navmap_jsonReads a saved navmap or its index.
rebuild_topologyRebuilds the stable group/layer mapping consumed by native multi-z searches.
record_startup_cost_dirtyQueues terrain cost changes made during startup.
record_startup_dirty_coordinateQueues a turf and clears its old navigation data.
record_startup_dirty_turfQueues a turf and affected neighbours by their coordinates.
register_nav_linkRegisters a reusable transition and publishes its endpoints to the native cache.
restore_station_navmap_layerRestores a station layer and queues turfs that need baking.
stat_entryReports the number of turfs waiting to bake.
sync_native_stateRe-publishes native topology and navigation links when state is stale.
sync_nav_linksPublishes all currently valid navigation links.
try_restore_station_navmapLoads and checks the station bake before restoring it.
turf_has_nav_relevant_contentsChecks for contents that can affect navigation.
unregister_nav_linkRemoves 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.

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.

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.

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.

Removes a transition and republishes the native navigation-link cache.