Storm Front Kit: Storm Walls, Fog, Lava and Hazards That Chase the Player
- Author
- claude-code @ auraAgent
- Opened
- Nov 16, 2026
- From
- contrib-3031dqe5
- Into
- main
- Merged
- Nov 16, 2026
Adds a deadline for the front so a game clock and the storm tell the same story.
- New field arriveBy (seconds, 0 = off): the front reaches the END of its route exactly that many seconds after it starts moving under steady, speedUp or catchUp. The pacing speeds up when it would be late and holds back (never closer to the end than minSpeed covers in the time left) when it would be early, so there is no jump at the deadline. Ignored with loop and checkpoints pacing (no deadline can be promised there).
- New read secondsToEnd(): exact with arriveBy, an estimate from the current speed otherwise; the same on every peer (computed from the published run anchor).
- pacing.module: arrivalTime(cfg), secondsToEnd(st, cfg).
- Why: in Skyhook (two-player race) catchUp at minSpeed 2.5 reached the end of a 599 m route in under 4 minutes while the MatchFlow clock said 10:00, and the game ended the race on the storm's finished phase while a runner was still 9-18 m ahead of the front. With arriveBy = 234 and roundSeconds = startDelay + arriveBy, both clients read the same seconds all race (97.4 s clock vs 97.5 s storm mid-race) and 0:00 is the storm reaching the finish.
- Tests: 2 new (every pacing x runners racing/stuck/absent finishes within 0.05 s of a 180 s deadline, max 1.5 m per frame, secondsToEnd reads 90 at 90 s; arriveBy off with loop/checkpoints). stormFrontKit suite 34/34 passing.
- Docs: README field + API + changelog, how-to guide section 4 'Make the clock and the storm agree'. Version 1.0.9 (package.yaml, api, catalog). Without arriveBy behaviour is unchanged.
Source world: aa31ef3f-b5f9-4800-93c0-996aa7f12819 Contributed paths:
- stormFrontKit.package/README.md
- stormFrontKit.package/README.md
- stormFrontKit.package/StormFront.component/init.luau
- stormFrontKit.package/StormFront.component/init.luau
- stormFrontKit.package/api.module/init.luau
- stormFrontKit.package/api.module/init.luau
- stormFrontKit.package/catalog.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/guides/how-to-make-a-storm-or-hazard-wall-chase-the-player.guide/guide.md
- stormFrontKit.package/pacing.module/init.luau
- stormFrontKit.package/pacing.module/init.luau
- stormFrontKit.package/package.yaml
- stormFrontKit.package/package.yaml
- stormFrontKit.package/tests/stormFrontKit.testSuite/init.luau
- stormFrontKit.package/tests/stormFrontKit.testSuite/init.luau
- 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/flood_race.scene/authoring/entities/page-01.json
- scenes/flood_race.scene/authoring/state.json
- scenes/flood_race.scene/build.luau
- scenes/flood_race.scene/entrypoint.luau
- scenes/flood_race.scene/scene.json
- scenes/storm_run.scene/authoring/state.json
- scenes/storm_run.scene/build.luau
- scenes/storm_run.scene/entrypoint.luau
- scenes/storm_run.scene/scene.json
- stormFrontKit.package/gallery/StormGallery.component/init.luau
- stormFrontKit.package/gallery/layout.module/init.luau
- stormFrontKit.package/stormGallery.scene/authoring/state.json
- stormFrontKit.package/stormGallery.scene/scene.json
- stormFrontKit.package/swallow.module/init.luau
- stormFrontKit.package/visuals.module/init.luau
15 files changed
- ChangedstormFrontKit.packageFolderBeforeAfter
- ChangedstormFrontKit.package/README.md18.3 KB → 19.5 KBBeforeAfter
- ChangedstormFrontKit.package/StormFront.componentFolderBeforeAfter
- ChangedstormFrontKit.package/StormFront.component/init.luau46.5 KB → 47.9 KBBeforeAfter
- ChangedstormFrontKit.package/api.moduleFolderBeforeAfter
- ChangedstormFrontKit.package/api.module/init.luau10.3 KB → 10.3 KBBeforeAfter
- ChangedstormFrontKit.package/catalog.moduleFolderBeforeAfter
- ChangedstormFrontKit.package/catalog.module/init.luau11.3 KB → 11.3 KBBeforeAfter
- ChangedstormFrontKit.package/guides/how-to-make-a-storm-or-hazard-wall-chase-the-player.guideFolderBeforeAfter
- ChangedstormFrontKit.package/guides/how-to-make-a-storm-or-hazard-wall-chase-the-player.guide/guide.md11.8 KB → 12.6 KBBeforeAfter
- ChangedstormFrontKit.package/pacing.moduleFolderBeforeAfter
- ChangedstormFrontKit.package/pacing.module/init.luau8.2 KB → 9.9 KBBeforeAfter
- ChangedstormFrontKit.package/package.yaml1.3 KB → 1.3 KBBeforeAfter
- ChangedstormFrontKit.package/tests/stormFrontKit.testSuiteFolderBeforeAfter
- ChangedstormFrontKit.package/tests/stormFrontKit.testSuite/init.luau30.6 KB → 32.8 KBBeforeAfter
Checks
No checks have been posted.
Reviews
No reviews yet.
Conversation
- claude-code @ auraAgentNov 16, 2026
Tested before sending: stormFrontKit suite 34/34 passing (tests.run 'stormFrontKit', in Skyhook's engine with these exact files), including the 2 new arriveBy tests. Live: two-player Skyhook race on two clients, StormFront arriveBy=234 on a 699 m catchUp route: clock and secondsToEnd() agreed to 0.3 s all race on both peers; the front reached the end at 0:00.
Sign in to comment or review.