Games & fun · Step
End a match
Finish a match with a result: a winner, a draw, a forfeit or called off. Says who won and lost and how long it took. The match is kept as over, so Read a match still finds its players for a rematch.
match.end
In a flow
“When a button is clicked, end a match.”
Check for a line → Won → End a match winner {node.c.winner} → Add to a leaderboard.
What it does
Finish a match with a result: a winner, a draw, a forfeit or called off. Says who won and lost and how long it took. The match is kept as over, so Read a match still finds its players for 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 12 values later steps can use. Find it under Games & fun in the palette.
When to use it
Use it for games and fun: finish a match with a result: a winner, a draw, a forfeit or called off. Says who won and lost and how long it took. The match is kept as over, so Read a match still finds its players for 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
- Winner Member
-
Who won (for a win or a forfeit). Unwired on a forfeit: everyone but whose turn it was.
What goes there: Type it in the side panel, or wire in a member. e.g. @Alex
If it's empty: Optional. Left empty and unwired, the step runs without it.
Connects fromAccept applicationApplication infoAsk a questionAsk follow-upBoard as emojiCall the next in the queueCase createdCheck for a lineand 86 more
Values it gives
- Ended Yes / no
-
On when it was still going. 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
- Winner Member
-
Who won (empty for a draw). 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
- Losers List
-
Everyone else's ids (all players for a draw). e.g. ["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
- Loser Member
-
The first loser. e.g. @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 toA member's variablesAdd a labelAdd a staff noteAdd answer to formAdd to a counterAdd to a leaderboardAdd to threadAdd to ticketand 647 more
- Players List
-
Every player's id. 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
- First player Member
-
The player in seat 1. 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
- Second player Member
-
The player in seat 2 (empty if none). e.g. @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 toA member's variablesAdd a labelAdd a staff noteAdd answer to formAdd to a counterAdd to a leaderboardAdd to threadAdd to ticketand 647 more
- Moves Number
-
Moves made. e.g. 21
If it's empty: Empty when the step didn't make one (it stopped early or was skipped); steps reading it get nothing.
Connects toAccount ageActive membersAddAdd answer to formAdd soundboard soundAdd timeAdd to a counterAdd to a leaderboardand 718 more
- Took Text
-
How long it lasted, in words. e.g. 4 minutes
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
- Game Text
-
Its name. e.g. Connect 4
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
- 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