# Targets
Targets are the entities or blocks that will be affected by an ability. Examples of targets include the player using the ability, the victim of an attack, or a block that has been broken.
Here are some examples of targets:
* `@Victim`: Applies the effect to the victim of an event (such as an attack).
* `@Attacker`: Applies the effect to the attacker of an event (such as an attack).
* `@Block`: Applies the effect to the block that was interacted with (such as right-clicking).
* `@NearestPlayer{radius=0}`: Applies the effect to the nearest player within the specified radius.
You can use multiple targets in a single effect, separated by a space. For example:\
`@Victim @Attacker` would apply the effect to both the victim and the attacker of an event.
### Target Configuration
Targets can be configured with additional options. For example, you can use the `radius` option to specify the radius around a target to search for another target.
Here's an example of a target configuration using the `radius` option:
```yaml
effects:
- 'MESSAGE:you are the nearest player! @NearestPlayer{radius=10}'
```
This would apply the effect to the nearest player within a radius of 10 blocks.
### Target Reference Table
Here is a table of all available targets, along with their descriptions:
| Name | Description |
| --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@Victim` | Applies the effect to the victim of an event (such as an attack). |
| `@Attacker` | Applies the effect to the attacker of an event (such as an attack). |
| `@Self` | Applies the effect to main entity (who activated it) |
| `@Block` | Applies the effect to the block that was interacted with (such as right-clicking). |
| `@NearestPlayer{radius=0}` | Applies the effect to the nearest player within the specified radius. |
| `@EyeHeight` | Applies the effect at entity's eye location |
| @Trench{radius=0}
@Trench{radiuscustom=0x0x0}
| Applies effect in square (e.g. 3x3x3) size area (commonly used for Trench). Only odd numbers allowed (e.g. 3, 5, 7, 9 etc..)
Use {ignoretool=true} to allow trench with tools which are not allowed to break blocks with. E.g. shovel on cobblestone
|
| `@Tunnel{radiuscustom=1x3x5,mode=UP}` | Applies effects in tunnels and staircases areas. Available Modes: `UP, DOWN, STRAIGHT, AUTO`. Works very similarly to the Trench target and shares the same arguments. |
| `@BlockInDistance{distance=1}` | Gets block within distance (closest one or the furthest away location if no block is within distance) |
| `@Veinmine{depth=75}` | Vein mine blocks. You must define whitelist of materials in settings.whitelist in the same block as chance, cooldown, etc.. Example here.
Default depth is 75
|
| `@Add{x=0.0,y=0.0,z=0.0}` | Add distance to main entity's location |
| `@Aoe{radius=1,target=all}` | Area of effect target. Radius is in what radius around a location entities are searched for. Targets are:
- ALL
- MOBS
- DAMAGEABLE (all entities that can damaged by user)
- UNDAMAGEABLE (all entities that can't be harmed by user, e.g. allies)
--------------------------------------------
You can also define a limit for number of entities affected adding option e.g. limit=1
|
| `@EntityInSight{distance=20,angle=40,limit=5,target=ALL}` | Target entities in sight, specify max distance, limit of entities, targets and angle of vision for targeted entities. |
| `@AllPlayers` | All players on the server |
You can use aliases for parameters, which are more concise.
| Name | Alias | |
|---|
| ignoretool | it | |
| radius | r | |
| radiuscustom | rc | |
| target | t | |
| limit | p | |
| distance | d | |
| depth | dp | |
| points | p | |
| angle | a | |
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://wiki.advancedplugins.net/abilities/targets.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.