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

# combat

[All effects and shared choice parameters](/stellarskills-docs/readme.md) · [Effect math and limitations](file:///configuration/effects.md)

## minecraft.damage\_reflect\_chance

Damage reflection. Chance to reflect a configurable share of incoming mob damage.

| Property                    | Value                                                    |
| --------------------------- | -------------------------------------------------------- |
| Exact key                   | `minecraft.damage_reflect_chance`                        |
| Hook descriptor             | `living_damage`                                          |
| Optional integration owner  | None declared                                            |
| Runtime evidence            | Native consumer/source reference                         |
| Source reference            | RuntimeEffectService.java                                |
| Declared enabled-by-default | True                                                     |
| Probability flag            | True                                                     |
| Allowed operations          | `add_flat`, `add_percent_points`, `override`             |
| Value label                 | Trigger chance                                           |
| Value help                  | Use 0.10 for 10%, or ADD\_PERCENT\_POINTS with value 10. |
| Schema value example        | `0.10`                                                   |

### Accepted filters/parameters

| Exact field      | Type / role         | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ---------------- | ------------------- | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `damage_percent` | decimal; parameter  | Yes      | `25`                                                                              | Percent of final incoming damage returned to the attacker.                                            |
| `entity`         | resource; condition | No       | `minecraft:zombie`                                                                | Optional attacker filter.                                                                             |
| `damage_type`    | text; condition     | No       | `mob_attack`                                                                      | Optional damage-source filter.                                                                        |
| `display`        | text; parameter     | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`         | boolean; parameter  | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.

## minecraft.environmental\_damage\_reduction

Environmental damage taken. Modifies damage with no attacking entity, such as fire, fall, freezing, or drowning.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `minecraft.environmental_damage_reduction`                                                                                 |
| Hook descriptor             | `living_damage`                                                                                                            |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | MinecraftHooks.java                                                                                                        |
| Declared enabled-by-default | True                                                                                                                       |
| Probability flag            | False                                                                                                                      |
| Allowed operations          | `add_flat`, `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `deny`, `transform` |
| Value label                 | Damage modifier                                                                                                            |
| Value help                  | Use MULTIPLY\_FINAL 0.75 for 25% less environmental damage.                                                                |
| Schema value example        | `0.75`                                                                                                                     |

### Accepted filters/parameters

| Exact field   | Type / role         | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ------------- | ------------------- | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `damage_type` | text; condition     | No       | `fall`                                                                            | Optional damage-source filter.                                                                        |
| `dimension`   | resource; condition | No       | `minecraft:overworld`                                                             | Optional dimension filter.                                                                            |
| `display`     | text; parameter     | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`      | boolean; parameter  | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.

## minecraft.knockback\_taken

Knockback taken. Modifies the strength of knockback applied to the player.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `minecraft.knockback_taken`                                                                                                |
| Hook descriptor             | `living_knockback`                                                                                                         |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | MinecraftHooks.java                                                                                                        |
| Declared enabled-by-default | True                                                                                                                       |
| Probability flag            | False                                                                                                                      |
| Allowed operations          | `add_flat`, `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `deny`, `transform` |
| Value label                 | Knockback modifier                                                                                                         |
| Value help                  | Use MULTIPLY\_FINAL 0.50 for half knockback.                                                                               |
| Schema value example        | `0.50`                                                                                                                     |

### Accepted filters/parameters

| Exact field | Type / role        | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ----------- | ------------------ | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `display`   | text; parameter    | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`    | boolean; parameter | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.

## minecraft.lifesteal

Lifesteal. Heals the attacker for this fraction of final non-player damage.

| Property                    | Value                                        |
| --------------------------- | -------------------------------------------- |
| Exact key                   | `minecraft.lifesteal`                        |
| Hook descriptor             | `living_damage`                              |
| Optional integration owner  | None declared                                |
| Runtime evidence            | Native consumer/source reference             |
| Source reference            | MinecraftHooks.java                          |
| Declared enabled-by-default | True                                         |
| Probability flag            | True                                         |
| Allowed operations          | `add_flat`, `add_percent_points`, `override` |
| Value label                 | Healing fraction                             |
| Value help                  | 0.05 means 5% of damage dealt.               |
| Schema value example        | `0.05`                                       |

### Accepted filters/parameters

| Exact field   | Type / role         | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ------------- | ------------------- | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `entity`      | resource; condition | No       | `minecraft:zombie`                                                                | Optional target filter.                                                                               |
| `damage_type` | text; condition     | No       | `player_attack`                                                                   | Optional damage-source filter.                                                                        |
| `display`     | text; parameter     | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`      | boolean; parameter  | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.

## minecraft.melee\_damage

Melee damage. Modifies direct player melee damage against non-player entities.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `minecraft.melee_damage`                                                                                                   |
| Hook descriptor             | `living_damage`                                                                                                            |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | MinecraftHooks.java                                                                                                        |
| Declared enabled-by-default | True                                                                                                                       |
| Probability flag            | False                                                                                                                      |
| Allowed operations          | `add_flat`, `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `deny`, `transform` |
| Value label                 | Damage modifier                                                                                                            |
| Value help                  | Use MULTIPLY\_FINAL 1.20 for 20% more melee damage.                                                                        |
| Schema value example        | `1.20`                                                                                                                     |

### Accepted filters/parameters

| Exact field | Type / role         | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ----------- | ------------------- | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `entity`    | resource; condition | No       | `minecraft:zombie`                                                                | Optional target filter.                                                                               |
| `display`   | text; parameter     | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`    | boolean; parameter  | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.

## minecraft.projectile\_damage

Projectile damage. Modifies player projectile damage against non-player entities.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `minecraft.projectile_damage`                                                                                              |
| Hook descriptor             | `living_damage`                                                                                                            |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | MinecraftHooks.java                                                                                                        |
| Declared enabled-by-default | True                                                                                                                       |
| Probability flag            | False                                                                                                                      |
| Allowed operations          | `add_flat`, `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `deny`, `transform` |
| Value label                 | Damage modifier                                                                                                            |
| Value help                  | Use MULTIPLY\_FINAL 1.20 for 20% more projectile damage.                                                                   |
| Schema value example        | `1.20`                                                                                                                     |

### Accepted filters/parameters

| Exact field | Type / role         | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ----------- | ------------------- | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `entity`    | resource; condition | No       | `minecraft:skeleton`                                                              | Optional target filter.                                                                               |
| `display`   | text; parameter     | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`    | boolean; parameter  | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.

## minecraft.status\_on\_hit

Status on hit. Chance to apply a Minecraft status effect to a mob you damage.

| Property                    | Value                                                    |
| --------------------------- | -------------------------------------------------------- |
| Exact key                   | `minecraft.status_on_hit`                                |
| Hook descriptor             | `living_damage`                                          |
| Optional integration owner  | None declared                                            |
| Runtime evidence            | Native consumer/source reference                         |
| Source reference            | MinecraftHooks.java                                      |
| Declared enabled-by-default | True                                                     |
| Probability flag            | True                                                     |
| Allowed operations          | `add_flat`, `add_percent_points`, `override`             |
| Value label                 | Trigger chance                                           |
| Value help                  | Use 0.10 for 10%, or ADD\_PERCENT\_POINTS with value 10. |
| Schema value example        | `0.10`                                                   |

### Accepted filters/parameters

| Exact field      | Type / role         | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ---------------- | ------------------- | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `status_effect`  | resource; parameter | Yes      | `minecraft:slowness`                                                              | Registered Minecraft effect ID.                                                                       |
| `duration_ticks` | integer; parameter  | No       | `100`                                                                             | 20 ticks equals one second.                                                                           |
| `amplifier`      | integer; parameter  | No       | `0`                                                                               | 0 is level I, 1 is level II, and so on.                                                               |
| `entity`         | resource; condition | No       | `minecraft:zombie`                                                                | Optional entity restriction.                                                                          |
| `damage_type`    | text; condition     | No       | `player_attack`                                                                   | Optional damage-source restriction.                                                                   |
| `display`        | text; parameter     | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`         | boolean; parameter  | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.

## minecraft.status\_when\_hurt

Status when hurt. Chance to apply a Minecraft status effect to the player after mob damage.

| Property                    | Value                                                    |
| --------------------------- | -------------------------------------------------------- |
| Exact key                   | `minecraft.status_when_hurt`                             |
| Hook descriptor             | `living_damage`                                          |
| Optional integration owner  | None declared                                            |
| Runtime evidence            | Native consumer/source reference                         |
| Source reference            | MinecraftHooks.java                                      |
| Declared enabled-by-default | True                                                     |
| Probability flag            | True                                                     |
| Allowed operations          | `add_flat`, `add_percent_points`, `override`             |
| Value label                 | Trigger chance                                           |
| Value help                  | Use 0.10 for 10%, or ADD\_PERCENT\_POINTS with value 10. |
| Schema value example        | `0.10`                                                   |

### Accepted filters/parameters

| Exact field      | Type / role         | Required | Example / options                                                                 | Plain-language help                                                                                   |
| ---------------- | ------------------- | -------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `status_effect`  | resource; parameter | Yes      | `minecraft:slowness`                                                              | Registered Minecraft effect ID.                                                                       |
| `duration_ticks` | integer; parameter  | No       | `100`                                                                             | 20 ticks equals one second.                                                                           |
| `amplifier`      | integer; parameter  | No       | `0`                                                                               | 0 is level I, 1 is level II, and so on.                                                               |
| `entity`         | resource; condition | No       | `minecraft:zombie`                                                                | Optional entity restriction.                                                                          |
| `damage_type`    | text; condition     | No       | `player_attack`                                                                   | Optional damage-source restriction.                                                                   |
| `display`        | text; parameter     | No       | `Custom player-facing text; supports {value}, {percent}, {item}, and {currency}.` | Overrides the generated benefit line. Use this to conceal server-only IDs and implementation details. |
| `hidden`         | boolean; parameter  | No       | `false`; choices: false, true                                                     | When true, this effect remains active but is omitted from player benefit/profile text.                |

Also accepts the six [shared choice parameters](/stellarskills-docs/readme.md) for supported skill-node bundles. Field examples are placeholders, not guaranteed live registry IDs or complete recipes.