> For the complete documentation index, see [llms.txt](https://humble-development.gitbook.io/advancedgearx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://humble-development.gitbook.io/advancedgearx/documentation/effects-and-usage.md).

# Effects & Usage

Effects

| Key               | Trigger        | Default target                               | Value       | Notes                                                                    |
| ----------------- | -------------- | -------------------------------------------- | ----------- | ------------------------------------------------------------------------ |
| `INCREASE_DAMAGE` | ATTACK         | attacker                                     | % increase  | Multiplies outgoing damage. `50` = +50%                                  |
| `REDUCE_DAMAGE`   | DEFENSE        | victim (fixed)                               | % reduction | Reduces incoming damage. Target cannot be changed.                       |
| `REMOVE_HEALTH`   | ATTACK DEFENSE | victim                                       | HP amount   | Bypasses damage system. Useful for thorns effects on DEFENSE.            |
| `ABILITY_DAMAGE`  | ATTACK DEFENSE | victim                                       | HP amount   | Like `REMOVE_HEALTH` but respects target's physical armor resistance.    |
| `HEAL`            | ATTACK DEFENSE | <p>victim (DEFENSE)<br>attacker (ATTACK)</p> | HP amount   | On ATTACK, specify `target=attacker` explicitly to heal yourself on hit. |
| `FIRE`            | ATTACK DEFENSE | victim                                       | seconds     | Sets target on fire for the given duration.                              |
| `FREEZE`          | ATTACK DEFENSE | victim                                       | seconds     | Freezes target for the given duration.                                   |
| `MESSAGE`         | ATTACK DEFENSE | victim                                       | `{message}` | Sends a chat message. Supports `&a` `&c` `&6` color codes.               |
| `HEALTH_BOOST`    | BUFF           | wearer (fixed)                               | HP amount   | Passively adds max HP while gear is equipped. Removed on unequip.        |

Optional parameters

| Parameter   | Default       | Description                                                               | Example           |
| ----------- | ------------- | ------------------------------------------------------------------------- | ----------------- |
| `target=`   | varies by key | Who the effect applies to. `attacker` or `victim`. Not available on BUFF. | `target=attacker` |
| `chance=`   | `100`         | Percentage chance the effect fires each trigger. Not available on BUFF.   | `chance=50`       |
| `cooldown=` | `0`           | Minimum seconds between activations per player. Not available on BUFF.    | `cooldown=10`     |
| `delay=`    | `0`           | Delay in seconds before the effect gets executed                          | `delay=3`         |

DSL format

| Part                                     | Required  | Example                                      |
| ---------------------------------------- | --------- | -------------------------------------------- |
| `TRIGGER`                                | Yes       | `ATTACK`, `DEFENSE`, `BUFF`                  |
| `KEY`                                    | Yes       | `INCREASE_DAMAGE`, `FIRE`, `MESSAGE` etc.    |
| `VALUE`                                  | Most keys | `50` or `{your message here}` for MESSAGE    |
| `target=` `chance=` `cooldown=` `delay=` | No        | `target=victim chance=25 cooldown=5 delay=5` |
|                                          |           |                                              |

### Example effect lines

| Goal                                          | Effect                                                |
| --------------------------------------------- | ----------------------------------------------------- |
| +50% damage on attack                         | `ATTACK:INCREASE_DAMAGE:50 target=attacker`           |
| Set enemy on fire for 5s                      | `ATTACK:FIRE:5 target=victim`                         |
| Freeze enemy for 3s, 35% chance, 6s cooldown  | `ATTACK:FREEZE:3 target=victim chance=35 cooldown=6`  |
| Deal 20 ability damage (armor-reduced)        | `ATTACK:ABILITY_DAMAGE:20 target=victim`              |
| Heal yourself 15 HP on hit                    | `ATTACK:HEAL:15 target=attacker`                      |
| Message yourself on attack                    | `ATTACK:MESSAGE:{&6Holy Strike!} target=attacker`     |
| Reduce incoming damage by 25%                 | `DEFENSE:REDUCE_DAMAGE:25 target=victim`              |
| Heal 10 HP when hit, 25% chance, 10s cooldown | `DEFENSE:HEAL:10 target=victim chance=25 cooldown=10` |
| Thorns — deal 5 HP to attacker when hit       | `DEFENSE:REMOVE_HEALTH:5 target=attacker`             |
| Freeze attacker when hit, 8s cooldown         | `DEFENSE:FREEZE:2 target=attacker cooldown=8`         |
| Passively add 50 max HP                       | `BUFF:HEALTH_BOOST:50`                                |