MATT Check Entity Count

Check Entity Count

Depending on how you use this, it can be used to do slightly different things.

• Checks to see if any previous Filters are met, and then continues or doesn't based on the result.
  • The various Filter actions require this one to be following the filter/group of filters in the action list.
• Counts the number of tokens within the tile.
• Counts the number of entities with a specific Use Tagger Tag.

When running a basic filter on the triggering token, just leave this at Current Tokens with a value of > 0; or Current Tile if you're filtering the tile instead.

Select Entity

Use this to directly target an entity; the following entity types are able to be targeted.

• Drawings
• Lights
• Sounds
• Tiles
• Tokens
• Walls

There's no reason to ever use Select Entity on this action that I can think of. If you can target the entity with this action, it exists, there isn't much need to check. -Crow

Triggering Token

Use this to check whether the triggering token exists.

There's also next to no reason to ever use this. If a player triggered the tile, 99% of the time there's going to be a triggering token. It's main use cases are if you want certain actions to not run if the GM triggers a tile without a token selected, and even then, Current Token will work too. -Crow

Tokens Within Triggering Tile

Use this to count the number of tokens within the triggering tile, then continue based on the result.

Player Tokens

Use this to count the number of player tokens on the scene, then continue based on the result.

Current Action Collection

Use this to check whether an entity exists; and whether the entity meets any filters preceding this action if applicable.

By default this starts on Current Tokens. Click the button again to have the dropdown appear to select other collections.

• Current Actors Collection
• Current Drawings Collection
• Current Items Collection
• Current Journals Collection
• Current Macros Collection
• Current Scenes Collection
• Current Tiles Collection
  • Use this if you're filtering an attribute on tiles.
• Current Tokens Collection
  • 95% of the time, Current Tokens is what you'll want to leave this on.
• Current Users Collection
• Current Walls Collection
  • This one can be used with door triggers for various effects.

Use Tagger

Use this to count the number of entities that exist with this Tag according to your Use Tagger settings.

• Drawings ^Tagger
• Lights ^Tagger
• Sounds ^Tagger
• Tiles ^Tagger
• Tokens ^Tagger
• Walls ^Tagger

Count

The number of Current Entities this action needs to look for to decide whether to continue or not.

• < > = are all operators that can be used to tune your tile trigger.
  • ≤ ≥ Do not work, use >= and <=.
  • != works here.
• You need a space between your operators and the value.
• {{value.text.[0]}} can be used with this action following a Roll Table action, then continues depending on the result.
• {{value.totalPlayers}} can be used with this action and a macro to continue depending on the player count, see Reference Player Count.
• {{variable.name}} to reference a MATT Variable.

If None Exist Go To

Optional: Enter the exact name of a Landing that will be jumped to if the desired count isn't met. If left blank, the action thread will instead stop if the count isn't met.

Notes

• This action used to display as Continue if in the action list; you may still see this in older screenshots or videos.
• $\color{red}{\textsf{Warning}}$: This action can result in Infinite Loops and crash your Foundry. Use responsibly.

Sample Tiles That Use This Action

• Boss Music
• Combat State Filter
• Chess Piece Capture
• Death Save Script
• Door w/ Open, Closed, and Secret Images
• Elevation Filter
• Hidden Path
• Item Filter
• Language Filter, D&D 5E
• Language Filter, PF 2E
• Motion Activated Door
• Name Filter
• Ooze Splitter
• Passive Skill Filter
• Random Gravestone Generator
• Request Roll, Count Success & Failures
• Reset Scene
• Rotation Puzzle, Basic
• Tag Filter
• Token Magic FX on Hover
• Trigger Happy
• UI Button

Page Last Updated

MATT 11.26