Bring the ultimate loot box experience to your server! This premium Loot Crates system allows players to open a variety of crate types, including Ammobox, Basic, Premium, VIP, Mystery, Timed, Epic, and Legendary Crates.

🎬 PREVIEW

Features:

🎁 Full Support for All Crate Types
Includes Ammoboxes, event crates, premium crates, rare crates, and unlimited custom crates.

🔑 Customizable Opening Conditions

• Required item (e.g., lockpick)

• Crate disappears after a set number of failed attempts (SoftlockAttempts)

• Lockpick break chance (LockpickBreakChance)

• Zone restrictions (allowedZones)

• Time-based restrictions (timedWindows)

🎮 Flexible Opening Methods

• Skill check system with adjustable difficulty and key bindings

• Progress bar with configurable duration

🎬 Configurable Animations

• Each crate can have its own animation dict, clip, and flag

• Default animation (Config.DefaultAnim) used if none is specified

⚡ Loot Rarity Logic (Weighted Random System)

• Loot organized into rarity categories: common, uncommon, rare, epic, legendary

• Each rarity has its own chance weight and item pool

• On crate opening, the system:

  • Randomly selects a rarity based on configured chances

  • Chooses an item from that rarity’s pool

  • Randomizes reward amount based on min/max values

  • Configurable minimum and maximum rewards per crate (rewardsMinMax)

  • Fallback system ensures at least one reward is always granted

📍 Faction/Job Notifications

• When a crate is opened, a chosen job or faction can be notified with exact map coordinates

🔔 Notifications System

• Fully compatible with ox_lib, tnotify, okoknotify, framework notify

• System is expandable, you can easily add new notification handlers in the config

• All crate messages (success, failure, softlock, etc.) are sent via the selected notification system

🔧 Fully Configurable

• Crate names and required items

• Loot tables and rarity weights

• Number of rewards per crate

• Attempt limits and softlocks

• Skill check difficulty and key bindings

• Notifications

• Animations (global or crate-specific)

📦 Example Crates
10 pre-made crate types with corresponding item images in the images folder:

• Ammobox Crate – ammo and weapons with rarity-based chances

• Basic Crate – small, common loot

• Common Event Crate – notifies faction with location, uses custom animation

• Premium / VIP Crates – higher chance for rare weapons and premium items

• Mystery Crate – only openable in restricted zones

• Timed Crate – only openable during specific time windows

• Epic / Legendary Crates – most valuable loot with rare and unique rewards

👉 These are just examples! You can easily create unlimited new crates in the config file with fully customizable options, loot tables, animations, restrictions, and notification settings.

Requirements:

• ESX or QBCore
• ox_lib

🛠️ Configuration Guide:
All configuration options and setup instructions can be found here:
👉 azakit-development.gitbook.io/docs

HELP:
You can find Discord: https://discord.gg/DmsF6DbCJ9