Coreshun XP & Leveling System v1.0

XP & Leveling System
A drop-in leveling engine for any game — feed it XP in one line, it owns the rest.

Overview
A complete, API-first leveling engine for any Roblox game. You decide what earns XP and write one line; the system owns the level curve, level-ups, rewards, XP multipliers, prestige, a session-locked DataStore, and the on-screen XP bar + level-up popup. Server-authoritative, endlessly configurable, scale-only on every device, and fully readable Luau with no obfuscation.

Award XP in one line
From any server Script, on whatever your game treats as progress:
_G.CoreshunXP_Add(player, 50)
That is the whole integration. Kills, quests, coins collected, time survived — call it once and the engine handles the maths, the level-ups, the rewards, the UI, and saving.

Your curve, your way

• Formula — a tunable exponential curve (base, exponent, linear term, rounding).
• Table — hand-author the exact XP for each level.
• Custom — return your own number from a function.

One shared XPForLevel drives both the maths and the bar, so they can never disagree. Cap the climb with MaxLevel or leave it unlimited.

Level rewards
Grant rewards at a specific level or every N levels — currency (auto-pays through the Coreshun Currency product), plus a hook to hand out items, tools, perks, or badges. Rewards are paid once per player by default, so prestige can't farm them.

Multipliers, boosts & prestige

• Global multiplier — set it to 2 for a double-XP weekend.
• Gamepass boosts — owners earn more automatically (and the moment they buy).
• Per-player boosts — _G.CoreshunXP_SetMultiplier(player, 2) for a potion or event.
• Prestige — let players reset for a permanent rank and a stacking XP bonus.

Drop-in HUD + 6 themes
A clean XP bar (six corner placements), an animated level-up popup, an optional Levels panel with a reward track, and a HUD button — all scale-only, mobile-safe, and themeable. Six built-in themes (Amethyst, Aurora, Gold, Ember, Ocean, Mono) or roll your own.

Auto-XP — zero code
Prefer not to script? Turn on Auto-XP to grant XP from playtime, or from any rising stat — coins, kills, distance, anything in leaderstats or an attribute — at a ratio you choose.

Built right

• Server-authoritative — all XP, rewards, and prestige validated on the server; remotes throttled.
• Session-locked DataStore — two servers can never save the same player at once; level, XP, and prestige persist safely, with a clean session-only fallback in unpublished places.
• Scale-only UI (phone to 4K), buyer-configurable keybind, fully themeable.
• Fully readable, heavily commented Luau — no obfuscation.

Setup (about 1 minute)

1. Insert the model and run the one-line installer.
2. Pick your curve in XPConfig (or keep the default).
3. Call _G.CoreshunXP_Add(player, amount) from your game — or just switch on Auto-XP.

Pairs with the Coreshun stack
Rank players by level on the Leaderboard, unlock "Reach level 50" with Achievements, pay level rewards through Currency, grant XP on Quest completion, and fire a level-up Toast — all by reading one attribute or calling one function.

Included
Fully readable Luau, a README, a manual and cheat sheet, and a Rojo project. Unlimited personal and commercial use. Free updates.

Support

---

Need help, found a bug, or want to suggest a feature? Join the CoreShun Discord:


Part of the Coreshun stack — pairs with Currency, Leaderboard, Achievements, Quest, Toast, and more.