> For the complete documentation index, see [llms.txt](https://docs.gamecreator.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gamecreator.one/stats/stats/common-use-cases/levels-and-xp.md).

# Levels and XP

Until now everything's been quite simple, right? Let's spice things up! One of the most frequently asked questions is how to implement a good **Level**/**Experience** system.

## Preface

Do you want the player to get perk points he can spend on skills after completing tasks? Or do you prefer to have a common experience system where each level requires an ever-increasing amount of experience? Maybe you could increase the value of each stat depending on how much you make use of them.

There are countless ways of implementing a progression system. That's why we decided to let you choose what's the best way of doing it for your particular game.

![(Particle Effect triggered right after reaching level 2)](/files/-LLu7s-aDRFRYUdCoRu2)

But let's get down to business. The typical *RPG* progression system consists of a series of threshold levels of experience upon when reaching them, the level amount is increased by one.

## Level & Experience

We'll need a couple of **Stats** to implement this system:

* **Experience Stat:** When the player kills or completes quests, he'll increase the amount of experience points he has. These points will be used to determine the current level.
* **Level Stat:** Depending on the amount of experience points the value will vary.

{% hint style="info" %}
Notice that the **Level Stat** depends exclusively on the **Experience Stat** and it is perfectly fine.
{% endhint %}

The **Experience Stat**'s formula is the same as the **`health`** one, which returns the current value of the stat using the **`this[value]`** expression. So if the player has accumulated 100 of experience points, the formula will return the same number.

What's interesting is the **Level Formula**, which uses the **Progression Table**.

![(Level Formula with table(stat\[exp\]) as its expression)](/files/-LLu7ROcqyiwh98VjR_c)

Let's break down the previous expression. On the outer part we have **`table(...)`**. This means that we get an output integer value depending on the input and the **progression table** defined at the bottom of the **Formula** object. The input for that table is **`stat[exp]`** which references the current amount of experience points.

## On Level Up!

Right now we have a way to get the current **`level`** depending on the current amount of **`experience`** points. But knowing the current **`level`** is of no interest unless we can detect the exact moment in which our characters level up.

To do so, all we need to do is to create a **Trigger** object and use the **Change Stat** option, which detects when a stat changes its current value and fires the corresponding **Actions** or **Events**.

All that needs to be done then is to use the **Instantiate Action** with a prefab with some fancy particle effects on the player's position.


---

# 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://docs.gamecreator.one/stats/stats/common-use-cases/levels-and-xp.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.