GR4CKA Enhanced Drug System – Offering complete customization and control, this system lets server owners craft a dynamic and realistic drug experience for players.

The FiveM Drug Addiction System runs smoothly with minimal dependencies, requiring only oxmysql and either ESX or QBCore. It is fully optimized for reliable performance.

🌿 Customizable Drugs: Adjust drug potency, effects, and addiction probabilities for a tailored server experience.
⚖️ Dynamic Strength Accumulation: Drugs interact to create evolving highs and lows, making each experience unique.
💉 Overdose Mechanics: Push the limits and risk overdosing, adding challenge and tension.
🚨 Addiction Alerts: Notify players with addiction updates through an engaging UI and visual indicators.
🔄 Dose Dependency: Players must manage their doses carefully to avoid withdrawal symptoms.
👁️ Immunity Display: A UI shows current drug immunity for informed decision-making.
🌡️ Medicine System: Create custom medicines to treat addictions and give players ways to recover.
🎬 Custom Drug Animations: Choose from syringe, smoking, sniffing, or pill-taking animations for an immersive experience.
🔧 Advanced Configuration: Fine-tune health, effects, speed, and other settings to fully customize gameplay.
🏃 Impairments: Addiction leads to gameplay impairments like distorted vision and no sprinting, adding realism.

How to install

Step 0 – First Steps

1. Download Resources: Download your resource from FiveM’s Keymaster and  from GitHub.is_lib
2. Unzip Files: Unzip the  and  folders and place them in your server’s resource folder.is_selldrugsis_lib
3. Add to Server Config: Add the resource to your server start config (). It is best to place these scripts above all scripts that may use them.server.cfg

   plaintext

   Code kopieren

   ensure is_lib
ensure qb-core
ensure is_selldrugs


Step 1 – Configure Resource

Read and configure all options in the  and  files to suit your server’s needs.is_selldrugs/config.luais_lib/config.lua

Step 2 – Adding Items

Adding a Phone Item

To use the Trap Phone and receive wholesale orders, you first need to add the phone to your engine (QBCore/ESX). The item name for the Trap Phone should match the one specified in  (default ). You can download the image for the Trap Phone from here.config.luatrap_phone

Adding a Trap Phone to ESX Framework

1. Access the Database: Log in to your server’s database management tool (like phpMyAdmin).
2. Navigate to the items Table: Find the  table where all game items are defined.items
3. Insert New Item: Add a new entry for the . You can do this manually using the tool’s interface or run the following SQL command:trap_phone

   sql

   Code kopieren

   INSERT INTO `items` (`name`, `label`, `weight`, `rare`, `can_remove`) VALUES
('trap_phone', 'Trap Phone', 1, 0, 1);

   • name: ‘trap_phone’ (This is the identifier used in your script)
   • label: ‘Trap Phone’ (The display name for the item)
   • weight: 1 (The weight of the item)
   • rare: 0 (Indicates the rarity, 0 for common)
   • can_remove: 1 (Whether the item can be removed from inventory)

Adding a Trap Phone to QB-Core Framework

1. Edit the QB-Core Shared File: Navigate to the  folder and open the  file.qb-coreshared/items.lua
2. Add New Item: Add a line for the new item in the items list:

   lua

   Code kopieren

   ['trap_phone'] = {['name'] = 'trap_phone', ['label'] = 'Trap Phone', ['weight'] = 500, ['type'] = 'item', ['image'] = 'trapPhone.png', ['unique'] = true, ['useable'] = true, ['shouldClose'] = true, ['combinable'] = nil, ['description'] = 'Maybe you will find more serious clients to talk to here.'},


   This line defines the item’s properties like name, label, weight, and image file.

3. Add Image to QB-Inventory: Place the image for the item in the appropriate directory (usually in ). Ensure the image file name matches the one specified in the shared file (e.g., ).qb-inventory/html/imgtrapPhone.png

Adding a Drugs Item

In the  file, configure the list of items that players can sell. Provide data such as the item name, wholesale price, and retail price. Obtain the item image (.png), name it the same as the drug name, and move it to .config.luais_selldrugs/html/img/inventory

Step 3 – SQL Database

Integrate the script with your database by adding the following SQL commands or import the provided SQL file:

Step 4 – Install Dependencies

To use the script, the following resources are required:

• is_lib and resources compatible with this library, such as framework, inventory, target
• oxmysql

Using a Trigger Instead of a Command

In , set the value in the  table to  to disable the command. Once done, use a Trigger to activate/deactivate retail sales.config.luacfg.commands.statusnil

Client-Side Trigger

Server-Side Trigger

To add to the Radial Menu, some scripts (like ) require sending information about a table in the argument instead of the arguments or player ID we send. This can be solved by adding the following code to :qb-radialmenuconfig.lua

Follow these steps to properly install and configure the  resource for your FiveM server.is_selldrugs