Log inGet started
World

Storm Front Kit: Storm Walls, Fog, Lava and Hazards That Chase the Player

Merged

stormFrontKit 1.0.9: arriveBy deadline + secondsToEnd()

#2
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

  1. 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.