> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rpg-leveling.zuxaw.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Zenith Config

> ZenithConfig.json - endgame ranks, favors, and the stat reset choice.

# Zenith Config

**File:** `mods/Zuxaw_RPGLeveling/ZenithConfig.json`

Zenith is the ladder after max level. Reach max level, from any XP source, and you gain one Zenith rank, one roll token, and one stat reset token. Roll spends one token and equips one random favor from the favors you have unlocked. Unused tokens stack. After Zenith 1, gameplay XP uses **`RelevelXpMultiplier`** while you climb back to max level.

Set **`EnableZenith`** to `false` to hide the tab and stop rank-ups and favor procs. Saved progress stays. Apply changes with `/lvl reload` or a restart.

## How a rank works

1. You hit max level.
2. Your Zenith rank goes up by one. You receive one roll token and one stat reset token (the token used by Reset All).
3. If **`ResetLevelOnZenithRankUp`** is `true` (the default), your level and current-level XP go back to 1 / 0. Claimed rewards, your class, your Zenith rank, and lifetime XP stay.
4. If **`ResetStatsOnZenithRankUp`** is `true` (the default), allocated stats and available stat points are cleared. Each level on the way back grants stat points again, using `StatPointsPerLevel`.
5. If **`ResetStatsOnZenithRankUp`** is `false`, you keep the stats and available points you already have. Levels on the way back grant no stat points, because you already earned them on the first climb.
6. Open the Zenith tab and press **Roll** when you have a token. The roll equips one unlocked favor that is not blacklisted. Spare Token gives tokens instead of replacing your favor. Favor Pick lets you choose.

Example: you are level 100 and every stat point is spent. You hit max level and become Zenith 1.

* Reset stats on: your allocated stats and available points are removed. From level 1 you earn points again each level.
* Reset stats off: your allocated stats and available points stay. From level 1 you do not earn more stat points.

A later rank with reset stats on clears the allocation again and turns point gain back on.

`/lvl setzenith` sets the rank and grants one roll token and one stat reset token per rank gained. It does not reset your level or your stats. Lowering the rank does not take tokens away.

## Options

| Option | Default | Description |
| - | - | - |
| `EnableZenith` | `true` | Turns the feature on or off. |
| `RelevelXpMultiplier` | `2.0` | XP multiplier while climbing back to max level after Zenith 1. `double_path` multiplies that again. `xp_anchor` uses x1.5 instead of this value. |
| `ResetLevelOnZenithRankUp` | `true` | Rank-up sets level and current XP back to 1 / 0. |
| `ResetStatsOnZenithRankUp` | `true` | Rank-up clears allocated stats and available stat points, then later levels grant points again. `false` keeps them and later levels grant none. |
| `MentorXpMultiplier` | `1.25` | XP bonus for nearby allies while Mentor Oath is equipped. You do not get this bonus. |
| `BlacklistedFavors` | `[]` | Favor ids that never enter the roll. Example: `["fugitive", "bountiful"]`. They show on the deck as Disabled. One you already have equipped keeps working until the next roll. |
| `Favors` | built-in list | The favor table. Each entry has `Id`, `MinZenith`, `Weight`, `CooldownSeconds`, `Effect`, and `IconItemId`. |

A favor with `MinZenith` above your rank is locked and cannot be rolled. Weight is the relative chance inside the unlocked pool. `CooldownSeconds` is the wait after a successful proc. `0` means the favor has no cooldown (auras, Spare Token, Favor Pick).

## Favors

| Id | Unlocks | What it does |
| - | - | - |
| `fugitive` | 1 | Below 30% health, movement speed x5 for 30s. |
| `bountiful` | 1 | The next mine, harvest, or chop yields twice as much. |
| `second_breath` | 1 | When stamina hits 0, it refills. |
| `spare_token` | 10 | Grants two roll tokens and leaves your equipped favor as it is. |
| `last_breath` | 20 | Cancels your death and fully heals you. |
| `mentor_oath` | 25 | Allies within 15 blocks gain more XP. You do not. |
| `fortune_favor` | 30 | The next mine, harvest, or chop yields five times as much. |
| `xp_anchor` | 35 | Your gameplay XP is x1.5. |
| `free_respec` | 40 | One free Reset All while this favor is equipped. |
| `party_veil` | 45 | Saves a nearby ally from death, on your cooldown. |
| `favor_pick` | 50 | You choose the favor instead of taking a random one. |
| `double_path` | 60 | Gameplay XP x2, and the relevel multiplier applies again while you are below max level. |

## Commands and API

Admin commands: `/lvl setzenith`, `/lvl setzenithxp`, `/lvl setfavor`, `/lvl clearzenith`, `/lvl givereroll`.

Other mods can grant roll tokens with `RPGLevelingAPI.addRerollTokens(uuid, amount)` and read them with `getRerollTokens(playerRef)`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.