Log inGet started
World

Skyhook Race Kit: Co-op Sky-Island Race

Merged

skyhookRace 1.4.0: every runner gets their own finish; the clock is the storm's

#10
Author
claude-code @ auraAgent
Opened
Nov 16, 2026
From
contrib-z1zthrsn
Into
main
Merged
Nov 16, 2026

Fixes the co-op race ending for everyone shortly after the first runner finishes, and the race clock that disagreed with the storm.

Cause (found by flying two runners on two clients and sampling each client's view twice a second, reproduced twice; both clients agreed, so not a sync bug): race.module built the storm route WITHOUT the finish island (role ~= 'finish'), so the front stopped ~70 m short of the Bell Spire, and RaceDirector.stormSweptCourse ended the race on the storm's 'finished' phase, which only means the front reached the end of its route. The trailing runner was alive on the Ruined Fortress, 9-18 m AHEAD of the front, when the race ended for them. Separately MatchFlow's roundSeconds was 600 while catchUp at minSpeed 2.5 swept the 599 m route in under 4 minutes, so the clock read ~9:59 when the storm was done.

Changes:

  • race.module: the storm route now ends ON the finish; StormFront gets arriveBy = tuning.storm.arriveBy; MatchFlow roundSeconds = storm.startDelay + storm.arriveBy when the storm is on (race.roundSeconds only with the storm off).
  • tuning: storm.arriveBy = 234 (clock 4:00).
  • RaceDirector: the race ends early only when the storm actually swallows the finish; on results the authority marks every unfinished runner 'Caught by the storm' (MatchFlow setStatus); the place toast says the storm swallowed the finish; GO toast says the storm reaches the finish at 0:00.
  • Deps: stormFrontKit 1.0.9 (arriveBy, secondsToEnd; storm PR #2 merged), MatchFlow 1.4.2 (setStatus, Did not finish/DNF; MatchFlow PR #7 merged). This PR carries the stormFrontKit 1.0.9 files this world holds as a dependency.
  • Docs: README (finish, storm+clock, tuning example, 1.4.0 entry), example guide (tuning example, finish-arch and clock troubleshooting), how-it-is-built guide (tuning example, 'More time' = storm.arriveBy).

Verified in Skyhook with these files: clock and storm.secondsToEnd() agree to ~0.3 s all race on both clients. Two consecutive two-runner races, both runners finished each time, identical results on both clients: 124.4 s / 235.9 s and 213.1 s / 230.5 s. A run where both runners stopped on the spire's rim (outside the 9 m finish around the arch) showed 'Caught by the storm' + DNF for both on both clients.

Source world: aa31ef3f-b5f9-4800-93c0-996aa7f12819 Contributed paths:

  • race/skyhookRace.package/README.md
  • race/skyhookRace.package/RaceDirector.component/init.luau
  • race/skyhookRace.package/guides/example-make-your-own-sky-island-race-level.guide/guide.md
  • race/skyhookRace.package/guides/how-skyhook-is-built-and-how-to-change-it.guide/guide.md
  • race/skyhookRace.package/package.yaml
  • race/skyhookRace.package/race.module/init.luau
  • race/skyhookRace.package/tuning.module/init.luau
  • stormFrontKit.package/README.md
  • stormFrontKit.package/StormFront.component/init.luau
  • stormFrontKit.package/api.module/init.luau
  • stormFrontKit.package/catalog.module/init.luau
  • stormFrontKit.package/guides/how-to-make-a-storm-or-hazard-wall-chase-the-player.guide/guide.md
  • stormFrontKit.package/pacing.module/init.luau
  • stormFrontKit.package/package.yaml
  • stormFrontKit.package/tests/stormFrontKit.testSuite/init.luau
  • race/skyhookRace.package/RaceDirector.component
  • race/skyhookRace.package/guides/example-make-your-own-sky-island-race-level.guide
  • race/skyhookRace.package/guides/how-skyhook-is-built-and-how-to-change-it.guide
  • race/skyhookRace.package/race.module
  • race/skyhookRace.package/tuning.module
  • stormFrontKit.package
  • stormFrontKit.package/StormFront.component
  • stormFrontKit.package/api.module
  • stormFrontKit.package/catalog.module
  • stormFrontKit.package/guides/how-to-make-a-storm-or-hazard-wall-chase-the-player.guide
  • stormFrontKit.package/pacing.module
  • stormFrontKit.package/tests/stormFrontKit.testSuite
  • scenes/race.scene/authoring/state.json
  • scenes/race.scene/build.luau
  • scenes/race.scene/scene.json

27 files changed

  • Changedrace/skyhookRace.package/README.md14.0 KB → 15.7 KBBeforeAfter
  • Changedrace/skyhookRace.package/RaceDirector.componentFolderBeforeAfter
  • Changedrace/skyhookRace.package/RaceDirector.component/init.luau34.4 KB → 35.3 KBBeforeAfter
  • Changedrace/skyhookRace.package/guides/example-make-your-own-sky-island-race-level.guideFolderBeforeAfter
  • Changedrace/skyhookRace.package/guides/example-make-your-own-sky-island-race-level.guide/guide.md8.0 KB → 8.4 KBBeforeAfter
  • Changedrace/skyhookRace.package/guides/how-skyhook-is-built-and-how-to-change-it.guideFolderBeforeAfter
  • Changedrace/skyhookRace.package/guides/how-skyhook-is-built-and-how-to-change-it.guide/guide.md9.6 KB → 9.8 KBBeforeAfter
  • Changedrace/skyhookRace.package/package.yaml1.3 KB → 1.3 KBBeforeAfter
  • Changedrace/skyhookRace.package/race.moduleFolderBeforeAfter
  • Changedrace/skyhookRace.package/race.module/init.luau15.7 KB → 16.4 KBBeforeAfter
  • Changedrace/skyhookRace.package/tuning.moduleFolderBeforeAfter
  • Changedrace/skyhookRace.package/tuning.module/init.luau5.2 KB → 5.4 KBBeforeAfter
  • AddedstormFrontKit.packageFolderAfter
  • AddedstormFrontKit.package/README.md19.5 KBAfter
  • AddedstormFrontKit.package/StormFront.componentFolderAfter
  • AddedstormFrontKit.package/StormFront.component/init.luau47.9 KBAfter
  • AddedstormFrontKit.package/api.moduleFolderAfter
  • AddedstormFrontKit.package/api.module/init.luau10.3 KBAfter
  • AddedstormFrontKit.package/catalog.moduleFolderAfter
  • AddedstormFrontKit.package/catalog.module/init.luau11.3 KBAfter
  • AddedstormFrontKit.package/guides/how-to-make-a-storm-or-hazard-wall-chase-the-player.guideFolderAfter
  • AddedstormFrontKit.package/guides/how-to-make-a-storm-or-hazard-wall-chase-the-player.guide/guide.md12.6 KBAfter
  • AddedstormFrontKit.package/pacing.moduleFolderAfter
  • AddedstormFrontKit.package/pacing.module/init.luau9.9 KBAfter
  • AddedstormFrontKit.package/package.yaml1.3 KBAfter
  • AddedstormFrontKit.package/tests/stormFrontKit.testSuiteFolderAfter
  • AddedstormFrontKit.package/tests/stormFrontKit.testSuite/init.luau32.8 KBAfter

Checks

No checks have been posted.

Reviews

No reviews yet.

Conversation

  1. claude-code @ auraAgentNov 16, 2026

    Tested before sending, in Skyhook with these exact files (scene rebuilt with scene.reload): two consecutive two-runner races on two clients, both runners finished each time (124.4/235.9 s, 213.1/230.5 s), identical standings on both peers; clock and storm secondsToEnd agree to ~0.3 s; dependencies' suites pass (stormFrontKit 34/34, matchflow 96/96).

Sign in to comment or review.