Log inGet started
World

Wayfinder Studio: Minimap, Compass, Waypoint and Toast Kit

Merged

1.3.8: waypoint markers never take a tap

#5
Author
claude-code @ auraAgent
Opened
Nov 14, 2026
From
contrib-ckayqg70
Into
main
Merged
Nov 14, 2026

The waypoint marker layer (hud.module, LAYER.markers) spans the whole view but was built with holder() without passThrough, i.e. a plain full-screen panel. A panel takes every tap that lands on it, painted or not, so while any waypoint was set every click or touch over the game hit the empty marker layer: in Emerald Falls the time-of-day and weather panel under it could not be clicked.

Fix: the marker canvas gets pointerEvents = "none" and the holder is built with passThrough = true, the same path the toast layer already uses (full-screen: the canvas alone as the screen root; boxed: vertical containers with pointerEvents none). Markers draw exactly as before.

Test: navUiKitTests 'waypoint markers never take a tap' sets a waypoint, builds a full-screen and a boxed HUD and checks ui.hitTest at the centre, the four corners and one more point never lands on the marker layer. Suite: 49/56 pass; the 7 failures are pre-existing and unrelated (6 are the engine/@builtin mismatch entity.ref.__init:440 nil call, reported to the platform; 'start, stop' finds a navUiKit_hud entity owned by another peer in a shared session). Version 1.3.7 -> 1.3.8, README 'What's new' updated.

Source world: 8dfefcb6-4b09-439c-9f01-e8525ed36695 Contributed paths:

  • navUiKit.package/README.md
  • navUiKit.package/hud.module/init.luau
  • navUiKit.package/navUiKitTests.testSuite/init.luau
  • navUiKit.package/package.yaml
  • navUiKit.package
  • navUiKit.package/hud.module
  • navUiKit.package/navUiKitTests.testSuite
  • navUiKit.package/NavHud.component/init.luau
  • navUiKit.package/gallery.module/init.luau

7 files changed

  • ChangednavUiKit.packageFolderBeforeAfter
  • ChangednavUiKit.package/README.md37.8 KB → 38.5 KBBeforeAfter
  • ChangednavUiKit.package/hud.moduleFolderBeforeAfter
  • ChangednavUiKit.package/hud.module/init.luau37.7 KB → 38.0 KBBeforeAfter
  • ChangednavUiKit.package/navUiKitTests.testSuiteFolderBeforeAfter
  • ChangednavUiKit.package/navUiKitTests.testSuite/init.luau67.3 KB → 69.1 KBBeforeAfter
  • ChangednavUiKit.package/package.yaml991 B → 991 BBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 14, 2026

    Review notes (an approval is refused for the author's own account, so recorded here): the diff touches one call site in hud.module (marker canvas pointerEvents none + holder passThrough, the same path toasts use), the README, the version and one new test. navUiKitTests with the change: the new hit-test test passes; the 7 failing tests fail identically without the change (engine/@builtin entity.ref mismatch, shared-session leftover). Live: with a waypoint set, ui.hitTest at the screen centre returns an empty stack.

Sign in to comment or review.