Skip to main content

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.

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

Points

Spendable. Members buy rewards with points in the Shop, unlock key-gated challenges, and spend them on other transactions.

XP

Progression. Feeds levels, loyalty tiers, and leaderboards. Cannot be spent — it only ever accumulates.
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).

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 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).
Adjustments show up in the member’s transaction history. They’re not silent — members can see them in their own wallet activity.

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).
Deletions are permanent. Use the Archive user flow if you only want to hide without data loss.

Strategy — points vs XP

GoalCurrency
Drive shop purchasesPoints
Unlock paid contentPoints (via key-gated challenges)
Visible progression / statusXP + Levels
Leaderboard rankingXP (with optional bonus XP per event)
One-off reward for milestoneRewards + Points + XP combined
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.

Next steps

Leaderboards

Turn XP into competitive rankings.

Loyalty tiers

Per-tier entry rewards and benefits.

Streaks

Reward consecutive-day behaviour.

Games

Visual mini-games tied to points/XP.