Sleepless Lootbox

A CS:GO-style lootbox/case opening system for FiveM with a polished React UI, weight-based loot pools, and framework-agnostic design.

Features

• 🎰 CS:GO-style roller animation - Smooth spinning animation
• ⚖️ Weight-based loot system - Uses ox_lib selector for flexible drop rates
• 👀 Preview system - Players can view case contents and drop chances before opening
• 🎨 Rarity system - Visual rarity tiers (Common, Uncommon, Rare, Epic, Legendary)
• 🔧 Framework agnostic - Supports ESX, QBCore, and Qbox out of the box
• 📦 Multiple inventory support - Works with ox_inventory, qb-inventory, and ESX inventory
• 🎁 Metadata support - Items can include custom metadata
• 📝 Config + Runtime API - Define lootboxes in config or register them dynamically via exports

Dependencies

• ox_lib (opens in a new tab) (required)
• A supported framework (ESX, QBCore, or Qbox)
• A supported inventory system

Installation

git clone https://github.com/Sleepless-Development/sleepless_lootbox.git

cd sleepless_lootbox/web
npm install
npm run build

ensure ox_lib
ensure sleepless_lootbox

Quick Start

Basic Lootbox Definition

config.lootboxes = {
    ['gun_case'] = {
        label = 'Gun Case',
        description = 'Contains various firearms',
        items = {
            -- Format: { weight, { name, amount, metadata?, rarity? } }
            { 80, { name = 'WEAPON_PISTOL', amount = 1 } },
            { 15, { name = 'WEAPON_SMG', amount = 1 } },
            { 4, { name = 'WEAPON_RIFLE', amount = 1 } },
            { 1, { name = 'WEAPON_RPG', amount = 1 } },
        },
    },
}

Weight System

Weights determine the relative drop chance of each item:

• Higher weight = more common drops
• Example: Items with weights 80, 15, 4, 1 (total 100) have 80%, 15%, 4%, and 1% chances respectively

Rarity Auto-Calculation

If you don't specify a rarity on an item, it's automatically calculated based on the weight:

You can customize these thresholds in config.lua.

Debug Commands

When config.debug = true, the following commands are available:

Support

If you need help or have questions:

• Discord (opens in a new tab)
• GitHub Issues (opens in a new tab)