Sign in

Contents

Games & fun · Step

Read a match

Everything about a match: its game, players, whose turn, the board, moves so far and how long since the last one.

Free plan match.read

In a flow

“When a button is clicked, read a match.”

Rematch button → Read a match → Start a match with its Players.

What it does

Everything about a match: its game, players, whose turn, the board, moves so far and how long since the last one. 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: everything about a match: its game, players, whose turn, the board, moves so far and how long since the last one.

When not to

If nothing should change in Discord, a value node or a check is lighter.

Typical wiring

When a button is clicked Read a match Send DM

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 variables Accept application Add a Notion page Add a Trello card Add an emoji Add to number in object Add up times Add working daysand 844 more

Values it gives

Exists Yes / no

On when there is a match on this key. 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 tag Add onboarding question Add to a counter Alarms that are due And AutoMod: Discord's word lists Bluesky latest post Board as emojiand 572 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 application Add a forum tag Add a label Add a Notion page Add a row to a Google Sheet Add a staff note Add a sticker Add 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 question Add to list Add up times AutoMod: add or remove allowed words AutoMod: add or remove words AutoMod: block words Bar chart Best 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 application Add a forum tag Add a label Add a Notion page Add a row to a Google Sheet Add a staff note Add a sticker Add a Trello cardand 577 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 variables Add a label Add a staff note Add answer to form Add to a counter Add to a leaderboard Add to thread Add 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 application Add a forum tag Add a label Add a Notion page Add a row to a Google Sheet Add a staff note Add a sticker Add a Trello cardand 577 more

Status Text

waiting, playing or over. e.g. playing

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 application Add a forum tag Add a label Add a Notion page Add a row to a Google Sheet Add a staff note Add a sticker Add a Trello cardand 577 more

Over Yes / no

On when it has ended. e.g. off

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 tag Add onboarding question Add to a counter Alarms that are due And AutoMod: Discord's word lists Bluesky latest post Board as emojiand 572 more

Moves Number

Moves made so far. e.g. 12

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 age Active members Add Add answer to form Add soundboard sound Add time Add to a counter Add to a leaderboardand 718 more

Seconds since a move Number

How long nobody has moved. e.g. 40

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 age Active members Add Add answer to form Add soundboard sound Add time Add to a counter Add to a leaderboardand 718 more

Board Text

The board as emoji (empty without one). 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 application Add a forum tag Add a label Add a Notion page Add a row to a Google Sheet Add a staff note Add a sticker Add a Trello cardand 577 more

Winner Member

Who won, once it's over (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 variables Add a label Add a staff note Add answer to form Add to a counter Add to a leaderboard Add to thread Add to ticketand 647 more

Often next

Related in Games & fun

Wires and sockets · Data values · Plans