Give your players a reason to grind.

The SCS Lootbox system brings a fully animated, polished crate-opening experience to your FiveM server with a built-in treasure hunt, milestone rewards, and a UI that looks like it belongs on a AAA server.

🎰 Spin System

Open crates with in-game cash or physical crate items from inventory Fully animated roulette-style spin across all possible rewards Win dialog with particle effects based on rarity Real-time inventory count shown on the Open button

🏆 Milestone System

Tracks every crate a player has ever opened — lifetime, never resets At configured milestones the reward pool is filtered to guarantee a minimum rarity Example: open a crate 100 times and your next pull is guaranteed RARE or better, 300 times guaranteed EPIC, 500 times guaranteed LEGENDARY Configurable per crate — enable or disable individually Tracked in MySQL so progress survives server restarts

🗺️ Treasure Hunt

Hidden locations across the map for players to find and collect Each location gives a physical crate item on collection Server-side distance validation — no teleport exploits Clickable map waypoint directly from the UI Image previews and clue descriptions per location

💾 Database Tracking

Daily spin limits tracked in MySQL — resets automatically at midnight, no cron needed Lifetime open counts tracked separately for the milestone system Toggle between database and memory mode with a single config line Works out of the box without importing any SQL — tables create automatically

🔒 Anti-Cheat & Security

All reward logic runs server-side — client never decides what it receives Per-player spin lock prevents concurrent spin exploits Anti-spam throttle blocks event flooding Server-side distance check on treasure collection Full input validation on all incoming network events

🎨 UI

Fully custom dark UI — 1920×1080 optimised Three crate categories: Vehicle, Weapon, Money Rarity-coloured cards, badges, glow effects and particle win dialog Crate hero image with floating animation Treasure hunt tab with image tiles and waypoint buttons No external UI frameworks — pure HTML/CSS/JS, loads instantly

⚙️ Configuration

Single config.lua — no need to touch any other file for basic setup Per-crate: cost, currency (cash or bank), daily limit, milestone thresholds, rewards Per-reward: type (item or cash), amount, rarity weight Rarity weights fully adjustable — controls drop probability across all crates Add new crates, rewards, and treasure locations without touching any script files

📦 Framework & Dependency Support

SupportedQBCore✅ESX✅QBox✅ox_inventory✅ Requiredoxmysql✅ Required for DB mode

📄 Includes

Full annotated README with setup guide for all three frameworks SQL reference file with admin queries for player management Treasure hunt location setup guide Step-by-step new crate addition guide.

💬 Support

Need help or custom development?
Open a support ticket through the Discord.