> For the complete documentation index, see [llms.txt](https://docs.sparkframework.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sparkframework.dev/documentation/user-guide/plugins/progression/leveling.md).

# Leveling

Leveling entries define experience curves that control how much XP is needed to reach each level. They support finite and infinite progression with multiple curve types.

## Creating a Leveling Entry

Open the Spark Editor, go to **Progression > Leveling** and click **Create New**.

### Progression Configuration

| Field                  | Description                                                                                                                                 |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Progression Type       | **Finite** (has a level cap) or **Infinite** (no hard cap, XP scales infinitely).                                                           |
| Starting Level         | Initial level when a character begins (default: 1).                                                                                         |
| Level Cap              | Maximum level the character can reach. Only available when Progression Type is Finite (default: 50).                                        |
| Soft Cap Level         | Level at which XP requirements start scaling with the post-cap multiplier. Only available when Progression Type is Infinite (default: 100). |
| Post Cap XP Multiplier | Multiplier applied to XP requirements after the soft cap. Only available when Progression Type is Infinite (default: 1.5).                  |

### Experience Curve

| Field                    | Description                                                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| Curve Type               | **Linear**, **Exponential**, or **Logarithmic**.                                                                             |
| Base Experience Required | XP needed for the first level up (default: 100).                                                                             |
| Experience Growth Factor | How XP requirements increase per level. For Linear: added each level. For Exponential: multiplied each level (default: 1.1). |
| Logarithmic Scale        | Scaling factor for the logarithmic curve. Only available when Curve Type is Logarithmic (default: 100.0).                    |

### Custom XP Table

| Field                       | Description                                                                                    |
| --------------------------- | ---------------------------------------------------------------------------------------------- |
| Custom Experience Per Level | Optional manual override for XP requirements at each level. Index 0 = XP needed for level 1→2. |

The editor provides an **Auto-Generate** button that populates the custom table from the curve settings, and a **Clear** button that empties it. When a custom table is provided, it takes priority over the calculated curve.

## How Curves Work

**Linear:** Each level adds the growth factor to the previous requirement. Level 2 needs `base`, level 3 needs `base + growth`, level 4 needs `base + 2×growth`, etc.

**Exponential:** Each level multiplies the previous requirement by the growth factor. Level 2 needs `base`, level 3 needs `base × growth`, level 4 needs `base × growth²`, etc.

**Logarithmic:** XP scales logarithmically, producing a curve that rises steeply at first then flattens. The logarithmic scale controls how quickly the curve flattens.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.sparkframework.dev/documentation/user-guide/plugins/progression/leveling.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.