Match Flow Kit: Countdowns, Rounds and Results
- Author
- claude-code @ auraAgent
- Opened
- Nov 1, 2026
- From
- contrib-01m6bjhp
- Into
- main
- Merged
- Nov 1, 2026
What this adds (all opt-in, defaults unchanged, nothing renamed):
- hold / holdText fields and setHold(on, text?) / isHeld() methods. While held, no match starts: the waiting room stays up, a running lobby countdown stops and goes back to waiting, and a finished match waits at the end of its break and returns to waiting with fresh scores instead of starting the next match. A round being played is never interrupted, and start() still starts regardless. setHold works from any machine (reported to the machine in charge like every other report). This is what a ready check needs: hold while anyone is not ready; un-readying during the lobby countdown stops it.
- showLobby = false hides only the waiting / lobby countdown / next-round panel, so another kit can draw its own lobby while MatchFlow's HUD, 3-2-1-GO and results still show.
- showHud = false hides only the in-round HUD (timer and scoreboard), so another kit can draw a team scoreboard while the countdown and results still show.
Rules: the hold lives in rules.module (R.DEFAULTS.hold, R.step's waiting / lobby / intermission branches), so it is pure and tested. Five new tests (hold keeps waiting, a hold stops the lobby countdown, a hold does not interrupt a round, a held finished match returns to waiting, forceStart ignores the hold): 81 tests pass. README: fields table, a "Holding the match (a ready check)" section, methods table, 1.3.0 changelog; version bumped to 1.3.0 in package.yaml, api.module and its README.
Why: lobbyKit (lobby, teams, ready check, spectating and team scoreboards) is built on MatchFlow with its documented team-entries pattern and needed a way to hold the match until everyone is ready and to take over the waiting panel and scoreboard. It was used and checked in play in the lobbyKit world.
Source world: 5c77c6c5-f5c3-441c-80ac-616dc6abf6d4 Contributed paths:
- MatchFlow.package/MatchFlow.component/init.luau
- MatchFlow.package/README.md
- MatchFlow.package/api.module/README.md
- MatchFlow.package/api.module/init.luau
- MatchFlow.package/matchflow.testSuite/init.luau
- MatchFlow.package/package.yaml
- MatchFlow.package/rules.module/init.luau
- MatchFlow.package
- MatchFlow.package/MatchFlow.component
- MatchFlow.package/api.module
- MatchFlow.package/matchflow.testSuite
- MatchFlow.package/rules.module
12 files changed
- ChangedMatchFlow.packageFolderBeforeAfter
- ChangedMatchFlow.package/MatchFlow.componentFolderBeforeAfter
- ChangedMatchFlow.package/MatchFlow.component/init.luau37.8 KB → 40.0 KBBeforeAfter
- ChangedMatchFlow.package/README.md33.6 KB → 36.1 KBBeforeAfter
- ChangedMatchFlow.package/api.moduleFolderBeforeAfter
- ChangedMatchFlow.package/api.module/README.md783 B → 783 BBeforeAfter
- ChangedMatchFlow.package/api.module/init.luau3.6 KB → 3.6 KBBeforeAfter
- ChangedMatchFlow.package/matchflow.testSuiteFolderBeforeAfter
- ChangedMatchFlow.package/matchflow.testSuite/init.luau53.2 KB → 54.7 KBBeforeAfter
- ChangedMatchFlow.package/package.yaml1.0 KB → 1.0 KBBeforeAfter
- ChangedMatchFlow.package/rules.moduleFolderBeforeAfter
- ChangedMatchFlow.package/rules.module/init.luau19.5 KB → 19.8 KBBeforeAfter
Checks
No checks have been posted.
Reviews
No reviews yet.
Conversation
No comments yet.
Sign in to comment or review.