Match Flow Kit 1.4.3
The bit every party game, arena shooter, racer or fighting game needs and nobody wants to write again: getting players into a lobby, a countdown to start, the round with a timer, a results screen, and a short break before the next round. The package is MatchFlow (also known as matchFlowKit, the name it was first asked for; it keeps the name MatchFlow because other kits install it by that name).
New in 1.4.3
Both guides open by naming the package and the version they describe, with its install line. Behaviour is unchanged.
New in 1.4.2
- A race that ends with runners still out says so, and why. Once a race round is over, an unfinished runner reads
Did not finishandDNFinstead ofRacingand-. Newmatch:setStatus(who, text)puts a game's own words beside a player (Skyhook marks runners the storm swallowed the finish ahead of as "Caught by the storm"), and rows fromgetStandings()carrystatus.
New in 1.4.1
- Rejoining players resume their own row. A player who leaves mid-round and comes back (under a new peer id) takes back their old row, with their score, finish and time, instead of showing twice (once as Left/DNF). Found in Skyhook, a co-op sky race.
- The HUD keeps clear of touch buttons. On a touch screen at tablet or desktop size, the engine's touch Menu button and controlsKit's corner Controls button no longer cover the scoreboard: every HUD layout moves any top panel a button would cover down below the buttons.
Play it
- Style gallery (opens first): every countdown beside a results screen, a live king-of-the-hill card with each hill look labelled under its hill, and the seven in-round HUD layouts, all readable from where you spawn. Click a countdown to hear it; Walk around puts you next to a live hill to step into.
- Orb Rush (
scenes.arena, the Play Orb Rush button): join with a friend and play a 30-second timed round. Grab the most glowing orbs, then see the podium.
Use it in your game
Install the MatchFlow package from ZeroMind: search for "MatchFlow" (or "matchFlowKit"), or install it by its id, 31cf13b4-df7d-4888-85e2-7947a7301614. It lands at /source/MatchFlow.package. Then add two lines at the end of content() in your scene's build.luau:
local MatchFlow = require("MatchFlow.api")
MatchFlow { format = "timed", seconds = 30, minPlayers = 1 }
- Formats: timed, firstToScore, bestOf, lastStanding, kingOfTheHill, race, waves, turnBased, switched with one field. The first names (scoreLimit, bestOfRounds, lastOneStanding, raceToFinish, surviveWaves) work too.
- King of the hill: drop a
Hillzone in a level and hold time counts by itself. Five looks: glowing ring, flag on a platform, sci-fi pad, rune circle, plain outline. It can move between spots during a round. - HUD layouts: top timer with scoreboard, corner timer, TV score bug, versus bar, timer strip, ranked sidebar, hold meter, each in minimal, sci-fi and cartoon and on a phone.
- Countdowns: bold, trafficLight, pixel, hologram, cartoon, minimal, fantasy, flipClock, neon, broadcast, each with its own 3-2-1-GO sounds.
- Results: podium, table, banner, recap.
- Tags: every style is in
MatchFlow.catalog, tagged retro, sci-fi, sports, fantasy, cartoon, minimal, party, arena, racing and more. - Multiplayer: one machine is in charge and everyone sees the same moment. If the host quits mid-round, another player takes over with the same clock and scores.
Two guides come with it
Installing MatchFlow also installs two guides, in MatchFlow.package/guides/. Open them with the guides tool or in the editor's Docs panel, under MatchFlow.
- How to add rounds, a countdown and a scoreboard to my game (the how-to): starting a match, the rounds and win condition of each format, scoring and teams, the king-of-the-hill zone, picking a HUD layout, countdown and results styles, and what players see when the host leaves (a short wait, then someone else takes over on the same clock and scores).
- A best-of-three arena match with a countdown, live scores and a results screen (the example): turns a small arena in a brand-new world into a best-of-three multiplayer match, step by step: an orb-grab game piece, a countdown before each round, a live score bug, score bars from barsKit, a round-by-round results screen, and a Victory or Game Over screen from menusKit at the end. MatchFlow itself needs neither kit.
The package README has every field, event and method, the full multiplayer behaviour, and the known limits.
Comments · 0
Open discussion, no rating attached. Ask questions, swap notes, follow threads.