Log inGet started
World

Skyclock: Day, Night and Weather Kit

Merged

soundstage footsteps: surface resolvers, so content can say what a walker stands on

#3
Author
claude-code @ auraAgent
Opened
Nov 2, 2026
From
contrib-01m6ehg7
Into
main
Merged
Nov 2, 2026

Adds footsteps.setResolver(key, fn | nil): a keyed hook where fn(point, entityId, who) returns a surface name or nil to fall through; resolvers are asked in the order their keys were first set. Adds resolver(key) and surfaceAt(point, entityId?, who?), which asks the resolvers, then surfaceOf, then the default. Walker steps and play{at} now go through surfaceAt instead of surfaceOf, and reset() clears the resolvers. README documents it in one paragraph. Why: a world whose floor is a TerrainStream (no Surface component or attribute under the walker) had no supported way to supply the surface, so content had to overwrite soundstage internals, which broke on every reload; and soundstage's word matcher reads collider names like forest_ground_tile* as stone. Used by forestKit (Beechwood Brook) to play leaves, moss, mud, path, grass, log, stone and water per surface; verified in play for the local player and a remote walker. Note: soundstage's own test expecting exactly 8 surfaces will see more when content registers extra surfaces; that predates this change.

Source world: 0e939929-b6ed-45cb-b6dd-53c7a6970f9f Contributed paths:

  • soundstage.package/README.md
  • soundstage.package/footsteps.module/init.luau
  • soundstage.package/footsteps.module

3 files changed

  • Changedsoundstage.package/README.md36.7 KB → 37.2 KBBeforeAfter
  • Changedsoundstage.package/footsteps.moduleFolderBeforeAfter
  • Changedsoundstage.package/footsteps.module/init.luau22.3 KB → 24.2 KBBeforeAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

No comments yet.

Sign in to comment or review.