|
|
|
## Description
|
|
|
|
A condition that checks checks if the target has a velocity matching the given parameters.
|
|
|
|
|
|
|
|
If the X, Y, or Z velocity is not specified, that component of the velocity is not checked. The 'absx', 'absy', and 'absz' options determine whether the absolute value of the corresponding velocity is used in the check. If 'relative' is true, the velocities are considered relative to the entity's orientation.
|
|
|
|
|
|
|
|
## Attributes
|
|
|
|
|
|
|
|
| Attribute | Aliases | Description | Default |
|
|
|
|
|-----------|-----------|----------------------------------------------------------------------|---------|
|
|
|
|
| x | | The X velocity | NONE |
|
|
|
|
| y | | The Y velocity | NONE |
|
|
|
|
| z | | The Z velocity | NONE |
|
|
|
|
| absx | | Use the absolute value of the X velocity | false |
|
|
|
|
| absy | | Use the absolute value of the Y velocity | false |
|
|
|
|
| absz | | Use the absolute value of the Z velocity | false |
|
|
|
|
| relative | | If true, X is forward/backward and Z is side-to-side | false |
|
|
|
|
| x | | The X velocity. Can be a range. Isn't checked by the condition if not set | |
|
|
|
|
| absx | ax, abss, as | Whether to use only the absolute values for the X velocity | `relative`'s value|
|
|
|
|
| y | up, down, vertical, v | The Y velocity. Can be a range. Isn't checked by the condition if not set | |
|
|
|
|
| absy | ay | Whether to use only the absolute values for the Y velocity | false |
|
|
|
|
| z | | The Z velocity. Can be a range. Isn't checked by the condition if not set | |
|
|
|
|
| absz | az, absf, af | Whether to use only the absolute values for the Z velocity | false |
|
|
|
|
| relative | rel | Whether the check should be relative to the entity's orientation and not to the world axis. If true, X is forward/backward and Z is side-to-side | false |
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
### X, Y and Z Attributes
|
|
|
|
They check against the velocity of the entity along those axis. But this also means that the velocity itself can be either positive or negative depending on the direction itself.
|
|
|
|
> - If you are moving **towards `positive` X values**, you will have a **`positive` X velocity**.
|
|
|
|
> - If you are moving **towards `negative` X values**, you will have a **`negative` X velocity**
|
|
|
|
> - If you are **jumping `up`**, you will have **`positive` Y velocity**
|
|
|
|
> - If you are **falling `down`**, you will have **`negative` Y velocity**
|
|
|
|
|
|
|
|
### Absx, Absy and Absz Attributes
|
|
|
|
Despite the former, you may not want to check against the *direction* of the movement, but its *magnitude*. For that, you have to enable those attributes, and once you do their respective X, Y or Z attribute will only check against absolute values (will be positive regardless of the actual direction)
|
|
|
|
> - If you are **jumping `up`**, you will have **`positive` Y velocity**
|
|
|
|
> - If you are **falling `down`**, you will have **`positive` Y velocity**
|
|
|
|
|
|
|
|
In this example, we check if the players X velocity is under an absolute value of 5.
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
In this example, we check if the players y velocity is under an absolute value of 5.
|
|
|
|
```yaml
|
|
|
|
Conditions:
|
|
|
|
- directionalVelocity{x=<5;absx=true} true
|
|
|
|
- directionalVelocity{y=<0;absx=true} true
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## Aliases
|
|
|
|
- [x] dvelocity |
|
|
\ No newline at end of file |
