Skip to main content

Tags (Predicates)

You can use tags to blacklist/whitelist mobs with certain properties. Combining tags alongside negating them gives you a powerful filtering tool, to only blacklist/whitelist mobs you want.

Note: Tags behave the same way on Fabric and Paper/Spigot.

Available tags:

?all, ?hostile, ?baby, ?tamed, ?nametagged, ?silent, ?mob

Using Tags

To use tags, add them as a line to your blacklist/whitelist. i.E:

blacklisted_mobs:
- ?hostile
- ?nametagged
- cow

Negating Tags

You can negate tags by putting not before them. i.E:

- not ?hostile
- not ?baby

This will only negate the tag right after it.

Combining Tags

You can combine tags by putting them after each other, the mob will then only be selected if it fulfills all tags. i.E:

- ?namettaged ?hostile
- ?baby not ?hostile

Passing Arguments to Tags

Some tags (i.E. ?nametagged and ?mob can take argument(s). i.E:

- ?nametagged(Can't pick me up!)
- ?mob(creeper, zombie)

You can find more details about which arguments they take in the next section.

Tag Behavior

?all : Will select all mobs.

?hostile : Will only select hostile mobs.

?baby : Will only select baby mobs.

?tamed : Will only select tamed mobs (i.E: wolves and cats that have an owner).

?nametagged : Will only select mobs that have a custom name (are nametagged).

?nametagged(name) : Will only select mobs that have a custom name, that matches the argument name.

?silent: Will only select mobs that are silent.

?mob(type1, type2,...) : Will only select mobs that are of one of the given types. Powerful when combined with other tags.

?leashed : Will only select mobs that are leashed.

Examples

- ?mob(cow, pig, sheep) ?baby ?nametagged(Cute!) # Will only select baby cows, pigs and sheep that are named "Cute!".
- ?nametagged(Locked) # Will select all mobs that are named "Locked"
- ?hostile not ?baby # Will select hostile mobs that are not babies.
- ?mob(wolf) ?tamed # Will select tamed wolves.
- not ?hostile ?silent # Will select passive and silent mobs.
- ?mob(creeper, zombie, skeleton) # Will only select creepers, zombies, and skeletons.
- ?mob(chicken) ?leashed # Will only select chickens that are leashed.

If you want to allow only whitelisted mobs, blacklist all mobs.

whitelisted_mobs:
- cow
- pig
- sheep

blacklisted_mobs:
- ?all