Dealer System – Drug Dealer Script (//)

💊 Advanced FiveM drug dealer system with dynamic economy, RPG progression, realistic police detection, NPC customer personalities, black money rewards and immersive illegal street dealing gameplay.

Dealer System is built for RP servers that want a complete and replayable illegal dealing experience instead of a simple sell command. Players progress through levels, reputation and perks while managing risk, police pressure and changing market conditions.

🌐 Description

Dealer System is a FiveM illegal dealing script designed to create a full underground street-selling loop with realistic risk/reward balance, progression mechanics and deep police interaction.

The system combines:

• Dynamic drug prices
• RPG-like progression and perks
• Advanced police pressure system
• Intelligent NPC customers
• Negotiation gameplay
• Illegal money rewards
• Detailed analytics and admin tools

This makes it ideal for servers looking for a long-term illegal activity with more depth than basic item selling.

✨ Main Features

💰 Dynamic Economy System

• Balanced illegal economy with configurable pricing
• Prices influenced by supply, demand and events
• Special events can affect the market
• Black money reward flow for immersive RP
• Support for multiple drug types with different values and demand profiles

📈 Progression & RPG System

• 50 levels with XP and rewards
• Reputation system that unlocks new advantages
• Perks for pricing, risk reduction, detection and profit optimization
• Achievements and detailed progression tracking
• Persistent player stats over time

🚔 Advanced Police System

• Real-time police player detection
• Intelligent alert logic based on activity
• Chance for witnesses to alert authorities
• Possibility of undercover police encounters
• Dynamic heat system affecting risk and outcomes
• Suspicious zone blips for police follow-up

👥 Intelligent NPC Customers

• Multiple customer personality types
• Negotiation system for price variation
• Success affected by reputation and perks
• Configurable customer spawn behavior
• Immersive animations for deals and interactions

💊 Consumption Effects

• Custom visual effects depending on the consumed item
• Movement and animation changes
• Integration with supported needs systems
• Cooldowns and anti-spam protections included

🌍 Zone System

• Multiple configurable dealing zones
• Each zone can have its own risk level
• Heat values can vary by area
• Automatic props and environment support
• Zone-based gameplay adds variety and route planning

🛡️ Administration & Security

• Dedicated admin panel via /dealeradmin
• Player management, level editing and live monitoring
• Detailed Discord webhook logs
• Anti-cheat protections and distance checks
• Inventory validation and suspicious behavior detection
• Automatic backups

🖥️ Interface & UX

• Modern HUD with level, XP, reputation and danger display
• Stylized notifications with ox_lib
• Detailed ox_lib menus for stats and market data
• Built to remain immersive and readable during active gameplay

💊 Available Content

The system supports multiple types of illegal products with distinct value and demand logic, including soft drugs, hard drugs, party drugs and custom configured products.

This allows you to adapt the activity to your own server economy and illegal network structure.

📋 Commands

• /dealer — Start dealing activity
• /stopdealer — Stop the activity
• /dealerstats — View personal stats
• /drugprice — Check current market prices
• /dealeradmin — Open administration panel

⚙️ Configuration

The script is highly configurable through its configuration files:

• Currency type
• Sale quantity limits
• Global price multipliers
• Police requirements and alert behavior
• Custom dealing zones
• Progression and XP values
• Perks and unlocks
• Drug pricing and demand values
• Discord webhook integration

🔌 Dependencies

• ESX / QBCore / Qbox support
• ox_lib
• ox_target
• oxmysql

Compatible with multiple inventory, dispatch and needs systems depending on your server setup.

📦 Installation

1. Place the resource in your resources folder
2. Import the included SQL database file
3. Add item definitions to your inventory if required
4. Configure zones, economy, police and webhooks
5. Add ensure spex_dealer to your server.cfg
6. Restart your server

📊 Analytics & Tracking

• Total gains
• Sales count
• Negotiation success rate
• Police alerts triggered
• Time spent dealing
• Top-selling products
• Unlocked achievements

All of this can be accessed through player stats or the admin panel.

⚡ Performance

• Optimized caching system
• Low idle usage
• Automatic cleanup for props and NPCs
• Designed for high-population RP servers

🎯 Why Use Dealer System?

• Create a real illegal progression loop for your players
• Add depth to police vs criminal interaction
• Encourage long-term activity through XP, perks and heat systems
• Bring more life to illegal zones and street dealing scenes
• Keep strong administrative visibility and security controls

🔐 Security

• Protected with Tebex Escrow
• Server-side validation and anti-abuse protections
• Designed for one-server licensed use

🧑‍💻 Development

Developed by speXtrum Development
From code to roleplay.

🌐 Discord: discord.gg/spex