> 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/capture.md).

# capture

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

## pixelmon.ball\_return\_chance

Ball Return Chance. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.ball_return_chance`                                                                                    |
| Hook descriptor             | `capture_failed`                                                                                                 |
| Optional integration owner  | None declared                                                                                                    |
| Runtime evidence            | Registered schema/API key; no native consumer identified                                                         |
| Source reference            | Requires a verified consumer; not certified active by this handbook                                              |
| Declared enabled-by-default | True                                                                                                             |
| Probability flag            | True                                                                                                             |
| Allowed operations          | `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `reroll`, `keep_best` |
| Value label                 | Probability value                                                                                                |
| Value help                  | 0.10 means 10%; ADD\_PERCENT\_POINTS uses 10 for ten percentage points.                                          |
| Schema value example        | `0.10`                                                                                                           |

### 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.

## pixelmon.capture\_ball\_bonus

Capture Ball Bonus. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_ball_bonus`                                                                                              |
| Hook descriptor             | `capture_start`                                                                                                            |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | PixelmonHooks.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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.

## pixelmon.capture\_friendship

Capture Friendship. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_friendship`                                                                                              |
| Hook descriptor             | `capture_success`                                                                                                          |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | PixelmonHooks.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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.

## pixelmon.capture\_heal

Capture Heal. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_heal`                                                                                                    |
| Hook descriptor             | `capture_success`                                                                                                          |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | PixelmonHooks.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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.

## pixelmon.capture\_money

Capture Money. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_money`                                                                                                   |
| Hook descriptor             | `capture_success`                                                                                                          |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Registered schema/API key; no native consumer identified                                                                   |
| Source reference            | Requires a verified consumer; not certified active by this handbook                                                        |
| 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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.

## pixelmon.capture\_pity

Capture Pity. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_pity`                                                                                                    |
| Hook descriptor             | `capture_failed`                                                                                                           |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Registered schema/API key; no native consumer identified                                                                   |
| Source reference            | Requires a verified consumer; not certified active by this handbook                                                        |
| 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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.

## pixelmon.capture\_rate

Capture Rate. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_rate`                                                                                          |
| Hook descriptor             | `capture_start`                                                                                                  |
| Optional integration owner  | None declared                                                                                                    |
| Runtime evidence            | Registered schema/API key; no native consumer identified                                                         |
| Source reference            | Requires a verified consumer; not certified active by this handbook                                              |
| Declared enabled-by-default | True                                                                                                             |
| Probability flag            | True                                                                                                             |
| Allowed operations          | `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `reroll`, `keep_best` |
| Value label                 | Probability value                                                                                                |
| Value help                  | 0.10 means 10%; ADD\_PERCENT\_POINTS uses 10 for ten percentage points.                                          |
| Schema value example        | `0.10`                                                                                                           |

### 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.

## pixelmon.capture\_reroll

Capture Reroll. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_reroll`                                                                                        |
| Hook descriptor             | `capture_start`                                                                                                  |
| Optional integration owner  | None declared                                                                                                    |
| Runtime evidence            | Registered schema/API key; no native consumer identified                                                         |
| Source reference            | Requires a verified consumer; not certified active by this handbook                                              |
| Declared enabled-by-default | True                                                                                                             |
| Probability flag            | True                                                                                                             |
| Allowed operations          | `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `reroll`, `keep_best` |
| Value label                 | Probability value                                                                                                |
| Value help                  | 0.10 means 10%; ADD\_PERCENT\_POINTS uses 10 for ten percentage points.                                          |
| Schema value example        | `0.10`                                                                                                           |

### 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.

## pixelmon.capture\_skill\_currency

Capture Skill Currency. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_skill_currency`                                                                                          |
| Hook descriptor             | `capture_success`                                                                                                          |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Native consumer/source reference                                                                                           |
| Source reference            | PixelmonHooks.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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.

## pixelmon.capture\_xp

Capture Xp. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.capture_xp`                                                                                                      |
| Hook descriptor             | `capture_success`                                                                                                          |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Registered schema/API key; no native consumer identified                                                                   |
| Source reference            | Requires a verified consumer; not certified active by this handbook                                                        |
| 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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.

## pixelmon.critical\_capture\_chance

Critical Capture Chance. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                            |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.critical_capture_chance`                                                                               |
| Hook descriptor             | `capture_start`                                                                                                  |
| Optional integration owner  | None declared                                                                                                    |
| Runtime evidence            | Native consumer/source reference                                                                                 |
| Source reference            | PixelmonHooks.java                                                                                               |
| Declared enabled-by-default | True                                                                                                             |
| Probability flag            | True                                                                                                             |
| Allowed operations          | `add_percent_points`, `multiply_base`, `multiply_final`, `set_min`, `set_max`, `override`, `reroll`, `keep_best` |
| Value label                 | Probability value                                                                                                |
| Value help                  | 0.10 means 10%; ADD\_PERCENT\_POINTS uses 10 for ten percentage points.                                          |
| Schema value example        | `0.10`                                                                                                           |

### 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.

## pixelmon.shake\_forgiveness

Shake Forgiveness. Native Pixelmon/NeoForge hook when the target API exposes a safe mutation point.

| Property                    | Value                                                                                                                      |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| Exact key                   | `pixelmon.shake_forgiveness`                                                                                               |
| Hook descriptor             | `capture_start`                                                                                                            |
| Optional integration owner  | None declared                                                                                                              |
| Runtime evidence            | Registered schema/API key; no native consumer identified                                                                   |
| Source reference            | Requires a verified consumer; not certified active by this handbook                                                        |
| 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                 | Value by rank                                                                                                              |
| Value help                  | The selected operation controls how this value changes the base.                                                           |
| Schema value example        | `1.10`                                                                                                                     |

### 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.