Skyhook Race Kit: Co-op Sky-Island Race
- 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
- 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.