Played

Counts how many of the targeted nodes have played during the current visit to the scene the argument belongs to. For a node argument the result is always 0 or 1. For a tag argument the result is the number of distinct nodes carrying that tag that have played this visit, capped at the count of tagged nodes in the project. For session-global “have they ever played this?” use PlayedEver.

Category: Play history Returns: int (boolean-coerces, see Boolean coercion)

Signature

Played(nodeOrTag)

The argument is either a node ID (node_intro) or a tag ID (tag_secret). For a node, the result is 1 if the node played this visit and 0 otherwise. For a tag, the result is the count of distinct nodes carrying that tag that have played this visit. A node that plays more than once (because it is set to repeat) still contributes one to that count. Played(tag_X) answers “how many of the tagged nodes has the player seen play through,” not “how many plays have fired.”

Examples

Played(node_intro)              // 1 if node_intro was played this visit, else 0
Played(tag_revealed_truth)      // count of distinct revealed-truth nodes played this visit
Played(tag_combat_won) >= 3     // gate on three or more distinct combat-won nodes played
!Played(node_warning)           // gate on never-played-this-visit (0 coerces to false)

Notes

Played is scoped to the current scene visit. Re-entering the same scene allocates a fresh visit-state. The prior visit’s plays don’t carry over. See Expressions for the rule, and PlayedEver for the session-global form.

For arguments: use the ID, not the UUID; see Expressions.