🎰 Juice Faction Drops

YBN-Inspired Faction Reward System for FiveM

Bring a high-energy reward drop system to your server with Juice Faction Drops — a fully server-controlled spin system inspired by the popular faction drop mechanics seen in large roleplay communities.

Admins can grant players access to a limited drop session, allowing them to spin for weapons, drugs, and other configured rewards from tier-based pools.

Everything is handled server-side, making the system secure, reliable, and easy to control.

Perfect for:

• Faction rewards
• Event prizes
• Staff giveaways
• Gang wars rewards
• Community competitions
• Server celebrations

🎥 Preview Video

(Click below to see the system in action)

VIDEO LINK HERE

https://www.youtube.com/watch?v=Ji_F_AGuhuw

🖼️ Screenshots

Recommended screenshots:

• Spin UI open
• Reel animation landing
• Tier reward example
• Admin command usage

⭐ Key Features

🎰 Animated Spin System

Players spin a smooth animated reel similar to modern drop websites.

The UI displays a scrolling reward reel that lands on a random item from the server-generated reward pool.

🎯 Tier Based Reward Pools

Admins control what rewards a player can receive by assigning a tier level.

Example tier structure:

Tier

Rewards Available

0

Unofficial

1

Unofficial + Tier 1

2

Unofficial + Tier 1 + Tier 2

3

Unofficial + Tier 1 + Tier 2 + Tier 3

Higher tiers automatically include lower tier rewards.

🎮 Category Based Spins

Rewards can be separated into categories such as:

• Weapons
• Drugs
• Custom categories

Each category can have its own reward pool and spin limits.

⚙️ Fully Configurable Rewards

Every reward is configurable directly in the config.

You can set:

• item name
• label
• description
• image
• chance weight
• reward amount
• ammo reward (for weapons)

Example reward config:

{ item = 'coke_pooch', label = 'Coke Pooch', chance = 50, amount = 16 }

Landing this reward gives 16 items, not just one.

🔒 Server-Authoritative Reward System

All reward rolls happen on the server.

Players cannot manipulate results through the UI.

The server handles:

• reward pool creation
• tier validation
• reward rolling
• inventory validation
• item delivery

This keeps the system safe from client exploits.

🧠 Smart Reward Validation

Before delivering rewards, the script checks if the item exists in the inventory system.

If an invalid item is configured, the script logs it instead of silently failing.

📦 Pending Reward Queue

Rewards are queued during spins and delivered when the session finalizes.

This prevents duplication exploits and ensures accurate reward handling.

📊 Weighted Reward Chances

Each reward can have a different drop chance.

Higher chance values increase the probability of landing that item.

Example:

AK47 chance = 5
Pistol chance = 25
Bandage chance = 50

Bandages will appear more often.

💬 Discord Webhook Logging

Optional webhook logging for staff transparency.

Logs include:

• drop sessions granted
• drop sessions ended
• rewards queued

🛠 Admin Commands

Grant a player access to faction drops:

/allowdrops [id] [tier]

Example:

/allowdrops 15 2

Player 15 can spin rewards up to Tier 2.

End a player's drop session:

/enddrops [id]

Example:

/enddrops 15

All pending rewards are delivered when the session ends.

🎮 Player Command

Players open the drop interface with:

/factionspin

From there they spin inside the UI.

🔌 Framework Support

Works with:

✔ QBCore
✔ ESX
✔ Standalone

📦 Inventory Support

Compatible with:

✔ qb-inventory
✔ ox_inventory
✔ qs-inventory
✔ ESX inventory

Inventory detection is automatic.

🎨 Custom UI

The UI includes:

• animated reel spin
• item images
• tier color display
• recent spin tracking
• category selection

Everything is customizable.

⚡ Performance

The script is lightweight and optimized.

• no heavy loops
• event-driven architecture
• server controlled logic

Safe for large servers.

📁 Easy Configuration

Most customization happens inside the config file.

You can easily adjust:

• reward pools
• tiers
• spin limits
• categories
• cooldowns
• images

No code editing required.

📞 Support

Need help or have questions?

Join the support Discord:

https://discord.gg/efPXny9gSR

⚠️ Important

This resource is inspired by the faction drop systems seen in YBN-style servers, but it is an independent script designed for flexible server integration.