🎁 KCD Cases – FiveM Lootbox System

Create your own lootboxes with custom rewards, individual drop chances, and an animated spinning roulette!

KCD Cases is a fully configurable lootbox system for FiveM, designed for ESX and ox_inventory. Give your players the excitement of opening cases and winning anything from basic items to legendary rewards and rare GOD-tier jackpots!

With a modern KCD interface, randomized reward pools, job restrictions, and server-side reward calculations, you have full control over your server's lootbox experience.

🚀 Features

🎰 Animated Case Opening

• Smooth SPIN roulette animation
• Visual display of possible rewards and drop chances
• Five different rarity levels: Uncommon, Rare, Epic, Legendary and GOD
• Customizable animation duration
• Automatic reward distribution after spinning

🎁 Random & Fixed Lootboxes

• RANDOM: Generate a different selection of rewards every time a case is opened.
• FIXED: Define exactly which rewards are available in a specific case.
• Up to 12 possible rewards per case opening
• Large, reusable reward pools
• Unlimited configurable case types

💎 Custom Rewards & Drop Chances

• Regular inventory items
• Weapons
• Cash and bank money
• Black money
• Individual drop chances for every reward
• Automatic probability calculation

👮 Job Restrictions

• Blacklist specific rewards for certain jobs
• Whitelist rewards for selected jobs
• Optional minimum and maximum job grades
• Automatically adjusted drop chances based on the player's job

For example, police officers can be prevented from receiving black money or specific weapons.

🎨 Customizable KCD Interface

• Modern blue, pink and white design
• No color gradients
• Custom PNG logo support
• Automatic ox_inventory item images
• Color-coded rarity indicators
• Custom case names, descriptions and icons

🔒 Server-Side Security

• Server-side reward selection
• Server-side job validation
• Session protection against duplicate spins
• Inventory capacity checks
• Cases are consumed only after a valid spin
• Optional Discord logging

⚙️ Compatibility

Framework

ESX

Inventory

ox_inventory

Library

ox_lib

Configuration

Lua

Interface

HTML / CSS / JavaScript

📦 Installation

1. Download and extract the resource into your FiveM server's resources folder.
2. Add the included lootbox items to ox_inventory/data/items.lua.
3. Configure your cases, rewards, drop chances and job restrictions in config.lua.
4. Add your custom case images and optional PNG logo.
5. Add ensure kcd_cases to your server.cfg after the required dependencies.
6. Restart your server and start opening cases!

💙 Why KCD Cases?

Whether you want simple starter cases, exclusive event rewards, or rare GOD-tier jackpots, KCD Cases gives you the tools to create a customizable lootbox experience for your FiveM server.

Developed by KevCodeDesign 💙💗

Make your server unique with KCD Cases!