Targeters

Targeters are used to determine what a skill targets when it is fired.

While targeters are technically optional (as the default targeter will usually be @trigger), forgetting a targeter is probably one of the most common mistakes people who are new to MythicMobs make.

When a targeter is used on the Skill mechanic, all of the skills inside of the meta-skill inherit the initial targeter. You can still overwrite the parent targeter for individual mechanics inside of the meta-skill by giving them their own targeter to use.

• Targeters
  • Entity Targeters
    • Single-Entity Targeters
    • Multi-Entity Targeters
    • ThreatTable Targeters
  • Location Targeters
    • Single-Location Targeters
    • Multi-Location Targeters
  • Special Targeters
• Common Attributes
  • All Targeters
  • Location Targeters
• Targeter Options
  • Target Filters
  • Target Limits

Entity Targeters

Single-Entity Targeters

Multi-Entity Targeters

ThreatTable Targeters

These targeters only work if the mob has Threat Tables enabled.

Location Targeters

Single-Location Targeters

Multi-Location Targeters

Special Targeters

The targeters below are called "meta-targeters". They target relative to an inherited targeter. For example:

# Mob file
Laser:
  Type: CREEPER
  Display: 'Laser'
  Health: 12
  AITargetSelectors:
  - 0 clear
  - 1 players
  Skills:
  - skill{s=Laser} @target

# Skill file
Laser:
  Skills:
  - ignite @EntitiesInLine{r=1}

In the example skill above, the "ignite" mechanic will target entities between the caster and the targeter specified in - skill{s=Laser} @target, i.e. a line between the caster and the caster's target.

Some meta-targeters also allow the mechanic to be casted "fromOrigin". This will change the starting location of the meta-targeter to be @Origin rather than the caster, which can allow for some complex effects, particularly when used with Projectiles.

Common Attributes

There are some common attributes that can be used in most of the Targeters, depending on the targeter's returned value

All Targeters

Location Targeters

Targeter Options

Target Filters

Target Filters allow you to filter out certain targets, and makes targeters a lot more flexible.

They are used with two options (available on ANY entity-targeter):

• ignore=X
• target=X

For example, to make a targeter that will ignore any players or non-hostile mobs, you'd use this:

damage{a=20} @EntitiesInRadius{r=10;ignore=players,animals}

To make a targeter ONLY target players, you'd do something like this:

skill{s=ASkill} @EntitiesInRadius{r=5;target=players}

Possible filters include:

• self
• animals (non-hostile mobs)
• armorstands/armor_stands
• creative (ignored by default)
• creatures (any type of sentient entity)
• flyingmobs
• marker
• monsters (hostile mobs)
• NPCs (Citizens NPCs, ignored by default)
• players
• samefaction (mobs marked with the same faction type)
• spectators (ignored by default)
• vanilla
• villager
• watermobs
• owner
• More coming later...

You can also turn off specific filters by just adding the option targetXXXXX replacing XXXXX with the filter name, e.g. targetPlayers=false or targetcreative=true

Note: As of MM 4.15 or MM 5.0, you can set the default target filters in MythicMobs/config.yml

Target Limits

All entity and location targeters also support target limits (as of v5.0.4). With this you can limit how many entities/locations are targeted, including the order in which they are selected.

This is done with the options:

• limit=#
• sort=X

Lets say you want your ability to only target the 2 nearest players within 30 blocks. To do this, you'd simply set the limit 2 to and sort by nearest:

• @PlayersInRadius{r=30;limit=2;sort=NEAREST}

Currently, sort can have the following values:

General sorters:

• NONE (usually sorts by how long the entity has existed)
• RANDOM
• NEAREST
• FURTHEST

Entity Only Sorters

• HIGHEST_HEALTH
• LOWEST_HEALTH
• HIGHEST_THREAT
• LOWEST_THREAT