Upgrade Scripts Docs

#Upgrade Rewards

A playtime rewards, leveling and referral system for QBCore, QBox and ESX. Players earn reward points just for playing, level up as they go, and spend those points in level-gated shops on items, cash, vehicles and loot cases.

The framework, inventory and garage script are all auto-detected, and every database table is created on first start - there is no SQL to import.

#Core features

Reward points

Players are paid points on a timer (every hour by default). Higher-level players earn a bonus on every payout. Points are spent in the shops and nowhere else, and every change is written to a per-player history the player can read in their menu.

Leveling

XP is completely separate from reward points and only moves the level bar. You choose the curve: the same XP for every level, a growth curve, or a per-level table. Levels run 1-100 with a new rank title every five levels, and you can grant points, cash or items for reaching a level. See Leveling & XP.

Shops and loot cases

Eight shops by default, each unlocked by level, selling items, cash, vehicles, loot cases and "get out of jail". Any item can be limited per day or put on a cooldown. Loot cases roll server-side with configurable rarity odds. See Shops & Loot.

Referrals

Every player gets a referral code. When someone redeems it, both sides are paid. The referrer's reward can be held until the new player has actually played for a set number of hours, which stops alt-account farming.

Admin panel

/rewards-admin opens a searchable player list with two access tiers - view-only staff and staff who can make changes. Admins can add or remove points, grant XP and set levels, and every change is recorded in an audit log. See Admin Panel.

Discord logging

Every points movement and redemption can post to Discord with the player, the amount, the new balance and where it came from. Each event type has its own webhook URL. See Discord Webhooks.

Other resources

Server exports let you read a player's points and level, and award points or XP from your own scripts. See Server Exports.

Languages

Ships in English, German, French, Spanish, Portuguese, Dutch, Polish, Italian and Turkish. See Localization.