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

# Points & XP

> Configure spendable points and progression XP — with level settings and admin adjustments

Nudj has two currencies. They look similar but serve different roles.

<CardGroup cols={2}>
  <Card title="Points" icon="coins">
    **Spendable**. Members buy rewards with points in the Shop, unlock key-gated challenges, and spend them on other transactions.
  </Card>

  <Card title="XP" icon="bolt">
    **Progression**. Feeds levels, loyalty tiers, and leaderboards. Cannot be spent — it only ever accumulates.
  </Card>
</CardGroup>

<Note>
  The UI refers to what used to be called **"XP settings"** as **"Level settings"** (#2242) — levels are derived from XP thresholds. The old standalone "XP settings" screen was restored under the new name (#648).
</Note>

## Level settings

Go to **Gamification -> Level Settings** to configure:

* **Level thresholds** — XP required for each level.
* **Level names and icons** — "Novice", "Expert", etc.
* **Bonus XP for leaderboards** — additional XP awarded for leaderboard position.

### Bonus XP default

Leaderboard rewards default **bonus XP to 0** (#688) so rewards don't accidentally inflate leaderboard scoring. Set it explicitly if you want bonus XP to fire.

***

## Earning points / XP

Members earn through:

* **Challenge completion** — distribution step on each challenge sets points/XP values.
* **Actions** — some actions carry their own reward distribution.
* **Achievements** — unlock rewards can include points/XP.
* **Games** — score-to-currency conversion (see [Games](/admin-guide/gamification/games)).
* **Admin adjustment** — see below.

***

## Admin adjustments

Managers and above can adjust a member's balance directly (#1006):

**Users -> select member -> Adjust Points / XP**

Use cases:

* Correct an earn bug.
* Compensate for downtime.
* Backfill after a data import.
* Punish abuse (remove points).

<Warning>
  Adjustments show up in the member's transaction history. They're not silent — members can see them in their own wallet activity.
</Warning>

***

## Live balance updates

Member wallets refresh balance live when points/XP are earned (#625 fixed stale-balance bugs). If you see a stale balance in a live demo, refresh the member app — don't wait for polling.

***

## Deleting members

Deleting a member (#1006) removes:

* Their profile and activity history.
* Their points and XP balance.
* Their reward wallet (unredeemed assets).

<Warning>
  Deletions are permanent. Use the Archive user flow if you only want to hide without data loss.
</Warning>

***

## Strategy — points vs XP

| Goal                         | Currency                              |
| ---------------------------- | ------------------------------------- |
| Drive shop purchases         | Points                                |
| Unlock paid content          | Points (via key-gated challenges)     |
| Visible progression / status | XP + Levels                           |
| Leaderboard ranking          | XP (with optional bonus XP per event) |
| One-off reward for milestone | Rewards + Points + XP combined        |

<Tip>
  Use **points + XP on every reward**. Points give members immediate spending power; XP builds long-term engagement. The split ratio is your economy's most important dial.
</Tip>

***

## Next steps

<CardGroup cols={2}>
  <Card title="Leaderboards" icon="trophy" href="/admin-guide/gamification/leaderboards">
    Turn XP into competitive rankings.
  </Card>

  <Card title="Loyalty tiers" icon="ranking-star" href="/admin-guide/rewards/loyalty-tiers">
    Per-tier entry rewards and benefits.
  </Card>

  <Card title="Streaks" icon="fire" href="/admin-guide/gamification/streaks-mastery">
    Reward consecutive-day behaviour.
  </Card>

  <Card title="Games" icon="gamepad" href="/admin-guide/gamification/games">
    Visual mini-games tied to points/XP.
  </Card>
</CardGroup>