MATT Check Entity Count - ironmonk88/monks-module-wiki GitHub Wiki
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.
- The various
- 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.
Use this to directly target an entity; the following entity types are able to be targeted.
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
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
Use this to count the number of tokens within the triggering tile, then continue based on the result.
Use this to count the number of player tokens on the scene, then continue based on the result.
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.
- 95% of the time,
- Current Users Collection
- Current Walls Collection
- This one can be used with door triggers for various effects.
Use this to count the number of entities that exist with this Tag according to your Use Tagger settings.
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.
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.
- 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.
- 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
MATT 11.26