Games & fun · Step
Start a match
Start a game between players: who plays, an optional board (rows and columns) and who goes first. It waits for players until every seat is taken. Starting on a key whose match is over starts a fresh one (a rematch).
match.start
In a flow
“When a button is clicked, start a match.”
Accept clicked → Start a match Connect 4 for {origin.user.id} and {user.id}, 6 rows 7 columns → Edit message with the board.
What it does
Start a game between players: who plays, an optional board (rows and columns) and who goes first. It waits for players until every seat is taken. Starting on a key whose match is over starts a fresh one (a rematch). It's a step: it runs when the white wire reaches it, then the flow carries on from its Then pin. It gives 7 values later steps can use. Find it under Games & fun in the palette.
When to use it
Use it for games and fun: start a game between players: who plays, an optional board (rows and columns) and who goes first. It waits for players until every seat is taken. Starting on a key whose match is over starts a fresh one (a rematch).
When not to
If nothing should change in Discord, a value node or a check is lighter.
Typical wiring
Sockets: settings you can wire
- Match Text
-
Which match: the message it's played on, like {message.id} on a button, or Sent message's id.
What goes there: Type it in the side panel, or wire in text. e.g. Hello there
If it's empty: Optional. Left empty and unwired, it uses {message.id}.
Connects fromA member's variablesAccept applicationAdd a Notion pageAdd a Trello cardAdd an emojiAdd to number in objectAdd up timesAdd working daysand 844 more
- Game Text
-
Its name, shown in results and logs, like Connect 4.
What goes there: Type it in the side panel, or wire in text. e.g. Hello there
If it's empty: Optional. Left empty and unwired, it uses Game.
Connects fromA member's variablesAccept applicationAdd a Notion pageAdd a Trello cardAdd an emojiAdd to number in objectAdd up timesAdd working daysand 844 more
- Players Text
-
Who plays, as mentions or ids, like {origin.user.id} {user.id}. Leave empty to let people Join a match.
What goes there: Type it in the side panel, or wire in text. e.g. Hello there
If it's empty: Optional. Left empty and unwired, it uses {user.id}.
Connects fromA member's variablesAccept applicationAdd a Notion pageAdd a Trello cardAdd an emojiAdd to number in objectAdd up timesAdd working daysand 844 more
- Seats Number
-
How many players it needs.
What goes there: Type it in the side panel, or wire in a number. e.g. 42
If it's empty: Optional. Left empty and unwired, it uses 2.
Connects fromA member's variablesAccept applicationActive membersAddAdd a forum tagAdd a labelAdd a row to a Google SheetAdd a staff noteand 501 more
- Rows Number
-
Board rows; 0 for a game without a board, like rock paper scissors.
What goes there: Type it in the side panel, or wire in a number. e.g. 42
If it's empty: Optional. Left empty and unwired, it uses 0.
Connects fromA member's variablesAccept applicationActive membersAddAdd a forum tagAdd a labelAdd a row to a Google SheetAdd a staff noteand 501 more
- Columns Number
-
Board columns; 0 for no board.
What goes there: Type it in the side panel, or wire in a number. e.g. 42
If it's empty: Optional. Left empty and unwired, it uses 0.
Connects fromA member's variablesAccept applicationActive membersAddAdd a forum tagAdd a labelAdd a row to a Google SheetAdd a staff noteand 501 more
- Marks Text
-
Each player's piece in order, separated by spaces, like 🔴 🟡 or ❌ ⭕.
What goes there: Type it in the side panel, or wire in text. e.g. Hello there
If it's empty: Optional. Left empty and unwired, it uses 🔴 🟡.
Connects fromA member's variablesAccept applicationAdd a Notion pageAdd a Trello cardAdd an emojiAdd to number in objectAdd up timesAdd working daysand 844 more
- Replace one still going Yes / no
-
On: start over even when a match on this key hasn't ended. Off: say it's still going.
What goes there: Type it in the side panel, or wire in true or false. e.g. true
If it's empty: Optional. Left alone, it's off.
Connects fromAdd a labelAdd to a leaderboardAge from birthdayAI check a messageAnagram checkAndAnswer a deadlineAnti-nuke guardand 269 more
Values it gives
- Started Yes / no
-
On when the match was made. e.g. on
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAdd a forum tagAdd onboarding questionAdd to a counterAlarms that are dueAndAutoMod: Discord's word listsBluesky latest postBoard as emojiand 572 more
- Whose turn Member
-
The player to move now. e.g. @Sam
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toA member's variablesAdd a labelAdd a staff noteAdd answer to formAdd to a counterAdd to a leaderboardAdd to threadAdd to ticketand 647 more
- Their mark Text
-
The turn player's piece, like 🔴. e.g. 🔴
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAccept applicationAdd a forum tagAdd a labelAdd a Notion pageAdd a row to a Google SheetAdd a staff noteAdd a stickerAdd a Trello cardand 577 more
- Players List
-
Their ids, in seat order. e.g. ["123", "456"]
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAdd onboarding questionAdd to listAdd up timesAutoMod: add or remove allowed wordsAutoMod: add or remove wordsAutoMod: block wordsBar chartBest by a fieldand 88 more
- Players as text Text
-
Their mentions joined by vs. e.g. @Sam vs @Alex
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAccept applicationAdd a forum tagAdd a labelAdd a Notion pageAdd a row to a Google SheetAdd a staff noteAdd a stickerAdd a Trello cardand 577 more
- Playing Yes / no
-
On when every seat is taken; off while it waits for players. e.g. on
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAdd a forum tagAdd onboarding questionAdd to a counterAlarms that are dueAndAutoMod: Discord's word listsBluesky latest postBoard as emojiand 572 more
- Why not Text
-
When it didn't happen, the reason in words for the member (empty when it did). e.g. It's not your turn yet.
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAccept applicationAdd a forum tagAdd a labelAdd a Notion pageAdd a row to a Google SheetAdd a staff noteAdd a stickerAdd a Trello cardand 577 more