Files
healer-man/scripts/runewaker-pipeline/RUNEWAKER_NAVIGATION_GAP_REPORT.md
T
2026-08-14 15:56:39 -04:00

8.5 KiB

RuneWaker navigation gap analysis

This diagnostic is offline-only. It measures source-authored entrance/objective positions against every raw Recast surface component and against the retained runtime surface. The current boss sequence is HealerMan's distance-from-entrance fallback, not a claimed source-authored order. It does not create links or infer doors/teleports.

Unreachable heuristic legs analyzed: 19 across 8 dungeons.

Dungeon Ordered leg Geometry classification From raw comp/dist To raw comp/dist Retained distances
cave-water-dragon Template 104161 -> Lytfir separate-recast-surface-components 0/0m 8/0m 0m -> 153.578m
hoto entrance -> Medusa separate-recast-surface-components 1/0m 0/0m 60.041m -> 0m
hoto Geba -> Bloodthirsty Claw separate-recast-surface-components 0/0m 1/0m 0m -> 30.954m
hoto Bloodthirsty Claw -> Jiasha separate-recast-surface-components 1/0m 0/0m 30.954m -> 0m
ice-dwarf-kingdom Pangkor -> Crasset Hairyfoot separate-recast-surface-components 0/0m 3/0m 0m -> 31.719m
ice-dwarf-kingdom Crasset Hairyfoot -> Thynos separate-recast-surface-components 3/0m 0/0m 31.719m -> 0m
kalins-shrine entrance -> Iron Rune Warrior entrance-or-prior-objective-outside-live-start-limit 5/0m 5/0m 293.32m -> 307.606m
kalins-shrine Iron Rune Warrior -> Yusalien separate-recast-surface-components 5/0m 2/0m 307.606m -> 245.55m
kalins-shrine Yusalien -> Locatha separate-recast-surface-components 2/0m 12/0m 245.55m -> 122.731m
kalins-shrine Locatha -> Goddess of Art's Disciple separate-recast-surface-components 12/0m 3/0m 122.731m -> 12.741m
kalins-shrine Goddess of Art's Disciple -> Ensia separate-recast-surface-components 3/0m 0/0m 12.741m -> 0m
raksha-temple entrance -> Shadoj missing-primary-environment-geometry-source-support-pad 41/0m 165/0m 0.203m -> 200.079m
the-origin entrance -> Life Leecher missing-primary-environment-geometry-source-support-pad 106/0m 302/0m 466.405m -> 234.143m
the-origin Life Leecher -> Holy Tree Falynum missing-primary-environment-geometry-source-support-pad 302/0m 305/0m 234.143m -> 361.263m
treasure-trove entrance -> Lookout Luke missing-primary-environment-geometry-source-support-pad 487/0m 854/0m 0.184m -> 519.5m
treasure-trove Lookout Luke -> Snow Blake missing-primary-environment-geometry-source-support-pad 854/0m 490/0m 519.5m -> 525.287m
treasure-trove Snow Blake -> Boulder Sidaar missing-primary-environment-geometry-source-support-pad 490/0m 489/0m 525.287m -> 565.311m
ystra-labyrinth-boss1 Specter Guardian Creator -> Raichika the Destroyer separate-authored-wdb-room-placements 0/0m 1/0m 0m -> 305.636m
ystra-labyrinth-boss1 Raichika the Destroyer -> Rune Guardian Leader separate-authored-wdb-room-placements 1/0m 2/0m 305.636m -> 317.303m

Per-dungeon surface inventory

  • cave-water-dragon: 510 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 17285 welded nodes discarded by largest-surface retention.
  • hoto: 260 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 5777 welded nodes discarded by largest-surface retention.
  • ice-dwarf-kingdom: 599 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 6237 welded nodes discarded by largest-surface retention.
  • kalins-shrine: 93 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 4858 welded nodes discarded by largest-surface retention.
  • raksha-temple: 167 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 1262 welded nodes discarded by largest-surface retention.
  • the-origin: 306 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 1678 welded nodes discarded by largest-surface retention.
  • treasure-trove: 1025 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 16502 welded nodes discarded by largest-surface retention.
  • ystra-labyrinth-boss1: 36 raw vertex-connected surfaces; 1 shared-edge corridors inside the retained surface; 901 welded nodes discarded by largest-surface retention.

Reviewed dispositions

cave-water-dragon

  • Disposition: gated-wave-and-door-review.
  • Safe automatic link: no.
  • Finding: Template 104161 runs the ten-add water-elemental controller, creates a blocking door, and removes it only after the counter reaches ten. Lytfir is on a lower isolated surface, so a permanent link would bypass the preserved gate/drop sequence.
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01562.lua:1
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01562.lua:21
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01562.lua:42

hoto

  • Disposition: source-order-required-before-linking.
  • Safe automatic link: no.
  • Finding: The distance fallback crosses the same 6.65m vertical surface break three times. Preserved local configuration supplies boss anchors but no authoritative encounter order, so these heuristic legs cannot justify a link.
  • Evidence: scripts/runewaker-pipeline/build-population.mjs:634
  • Evidence: scripts/runewaker-pipeline/recipes/hoto-population.json

ice-dwarf-kingdom

  • Disposition: door-gated-room-review.
  • Safe automatic link: no.
  • Finding: Crasset's isolated surface is separated by a 1.64m/0.60m gap, but his preserved death hook creates an orb that finds and hides door 112321. A permanent bidirectional link would erase that gate state.
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01356.lua:16
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01356.lua:36
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01356.lua:46
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01356.lua:54

kalins-shrine

  • Disposition: teleport-room-mechanic.
  • Safe automatic link: no.
  • Finding: The preserved server scripts register six Kalin locations as separate keeper rooms and advance with a group teleport. The vertical component gaps are therefore encounter state, not wall seams.
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/03246.lua:713
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/03246.lua:1298
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/03246.lua:1363

raksha-temple

  • Disposition: missing-modular-environment-assembly.
  • Safe automatic link: no.
  • Finding: The environment recipe explicitly adds isolated source-anchor support pads because the single primary ROS does not cover the modular WDB combat anchors. Secondary environment pieces must be assembled before route authoring.
  • Evidence: scripts/runewaker-pipeline/recipes/raksha-temple.json:16

the-origin

  • Disposition: missing-modular-environment-assembly.
  • Safe automatic link: no.
  • Finding: Both objectives and the entrance sit on isolated source-anchor support pads. The WDB contains many separately placed cathedral, slope, bridge, and connector ROS pieces that the primary-only environment package does not yet assemble.
  • Evidence: scripts/runewaker-pipeline/recipes/the-origin.json:16

treasure-trove

  • Disposition: missing-modular-environment-plus-bridge-door-mechanics.
  • Safe automatic link: no.
  • Finding: Boss anchors are isolated support pads, while preserved Lua requires a boss-enabled drawbridge switch and a key-gated hold door. The modular environment and stateful bridge/door must precede navigation links.
  • Evidence: scripts/runewaker-pipeline/recipes/treasure-trove.json:16
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01159.lua:1
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01159.lua:38
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/01159.lua:50

ystra-labyrinth-boss1

  • Disposition: separate-authored-room-placements.
  • Safe automatic link: no.
  • Finding: The package intentionally clones three distinct WDB room placements hundreds of meters apart; the preserved travel catalog also treats the boss-room destinations separately. Connecting them through open space would invent geometry.
  • Evidence: scripts/runewaker-pipeline/recipes/ystra-labyrinth-boss1.json:16
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/03246.lua:1423
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/03246.lua:1425
  • Evidence: ../rom-pvt-server-backups/Runewaker/Resource/luascript/03246.lua:1426