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

# Rebirth

**Rebirth** is the prestige-of-prestige layer. Once a player maxes their rankup, they can rebirth to earn **Rebirth Points** and spend them in a configurable **skill tree** of permanent upgrades. Rebirth also gates the [attributes](/p/pinnaprison/tools-and-items/attributes.md) system. It is configured in `rebirth.yml`.

```yaml
requirement-leveling: 'rankup'
rebirth-leveling: 'rebirth'
points-currency: 'rebirthpoints'

required-amount: 1000      # rankup level needed to rebirth
required-increase: 0       # added per rebirth already done
reset-requirement: false   # keep the rank after rebirthing

cost-currency: 'money'
cost-amount: 1000000000    # money price of the first rebirth (1B)
cost-increase: 250000000   # added per rebirth already done

points-per-rebirth: 1
rebirth-sound: 'ENTITY_PLAYER_LEVELUP'
rebirth-actions: []
```

| Key                             | Description                                                                                            |
| ------------------------------- | ------------------------------------------------------------------------------------------------------ |
| `requirement-leveling`          | The [leveling track](/p/pinnaprison/core/leveling.md) that must be maxed to rebirth (`rankup`).        |
| `rebirth-leveling`              | The track that stores the player's rebirth count.                                                      |
| `points-currency`               | The currency awarded per rebirth and spent in the skill tree.                                          |
| `required-amount`               | The `requirement-leveling` level needed for the **first** rebirth.                                     |
| `required-increase`             | Added to the requirement for each rebirth already done.                                                |
| `reset-requirement`             | `false` keeps the player's rank after rebirthing; `true` resets it.                                    |
| `cost-currency` / `cost-amount` | The currency and price of the first rebirth.                                                           |
| `cost-increase`                 | Added to the price for each rebirth already done.                                                      |
| `points-per-rebirth`            | Rebirth Points awarded per rebirth.                                                                    |
| `rebirth-sound`                 | Sound played on rebirth.                                                                               |
| `rebirth-actions`               | [Action lines](/p/pinnaprison/customization/item-format.md#actions) run on every rebirth (`{player}`). |

## The skill tree (`upgrades`)

Each entry under `upgrades:` is a purchasable upgrade placed in `guis/rebirth-upgrades.yml` by its id. An upgrade can be **boost-based**, **command-based**, or both.

```yaml
upgrades:
  enchantproc:
    name: '&9&lEnchant Proc Upgrade'
    max-level: 30
    cost-per-level: 2
    amount-per-level: 0.01
    boosts:
      enchant: 1            # +1% (= +0.01x) enchant proc chance per level
    lore:
      - '&fLevel: &a{level} &8/ &c{max-level}'
      - '&fPrice: &b{cost} &3Points'

  autominer:
    name: '&9&lAutominer Charge Upgrade'
    max-level: 1
    cost-per-level: 15
    amount-per-level: 1
    level-up-actions:
      - 'console autominers chargeboost {player} 100'   # hook any system
    lore:
      - '&fLevel: &a{level} &8/ &c{max-level}'
```

| Key                | Description                                                                                                                                     |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `name`             | Upgrade display name.                                                                                                                           |
| `max-level`        | The highest level.                                                                                                                              |
| `cost-per-level`   | Rebirth Points cost — grows each level.                                                                                                         |
| `amount-per-level` | The value added per level (used by `boosts` and `{total}`).                                                                                     |
| `boosts`           | Passive `% per level`, keyed by a currency id or `enchant` (proc chance).                                                                       |
| `level-up-actions` | [Action lines](/p/pinnaprison/customization/item-format.md#actions) run on each level bought — the place to hook external plugins (`{player}`). |
| `lore`             | Item lore. Placeholders: `{level}`, `{max-level}`, `{cost}`, `{total}` (= level × `amount-per-level`).                                          |

{% hint style="success" %}
Because upgrades can run **commands** on level up (`level-up-actions`), you can integrate any external plugin (crates, cell value, ranks, etc.) into the rebirth tree.
{% endhint %}

## Command & menus

* `/rebirth` — open the rebirth menu (`guis/rebirth.yml`); the skill tree lives in `guis/rebirth-upgrades.yml`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://edseries-plugins.gitbook.io/p/pinnaprison/core/rebirth.md?ask=<question>
```

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.