md-drugs/readme.md

# 🌿 MD-Drugs – Advanced Drug System for FiveM

A fully customizable, immersive drug system for FiveM servers.

<div align="center">
  <a href="https://discord.gg/sAMzrB4DDx">
    <img src="https://i.imgur.com/t65G9Z0.png" width="200" alt="Mustache Scripts Logo">
  </a>
  <br>
  <a href="https://discord.gg/sAMzrB4DDx"><strong>Join Mustache Scripts Discord</strong></a>
</div>

---

- **[Samuel's Development](https://fivem.samueldev.shop/  ):** Used their Christmas script global states and prop spawning (with permission).  
- **[STACHY225](https://babiczind.tebex.io/category/2103836  ):** Meth network animations.  
- **[Bostra](https://discord.gg/5ncbwMNq  ):** Free scripts, sanity checks, and those cute mushrooms!  
- **[Feisty]():** Stunning visuals that make everything look amazing.  
- **Beta Testers:** Your invaluable feedback made this possible.  
- **[1of1 Servers](https://1of1servers.com/  ):** Top-notch hosting and support. Join their [Discord](https://discord.gg/1of1servers  ).  
- **[Kamaryn](https://discord.gg/KPRmZqFS  ):** For the [installation guide video](https://youtu.be/zvuYnUfrqaA?si=FGJuBO5krZMC14Nd).  
- **[Athena](https://discord.gg/mam8Nmg49d):** For the Balloon props :)
## 🎬 Preview

🎥 **[Watch Full Preview Video](https://www.youtube.com/watch?v=I_x7_oz_SAU)**


---

## 📦 Dependencies

| Dependency | Link |
|----------|------|
| `Community_bridge` | [GitHub - Community Bridge Repo](https://github.com/TheOrderFivem/community_bridge) |
| `Read`   | [Read Docs](https://letters.hookedonphonics.com/us/read-guaranteed-G14.html) |
| Game Build | **2944 or later** required |

> ⚠️ Ensure all dependencies are installed, started before md-drugs and up to date.


## 🛠️ Installation

### Step 1: Inventory Integration

#### For QBCore (`qb-inventory`)
1. Copy items from `md-drugs/items_install/qb-inventory` into `qb-core/shared/items.lua`.
2. Add item images from `md-drugs/items_install/images` to `qb-inventory/html/images`.

#### For OX_Inventory
1. Copy items from `md-drugs/items_install/ox_inventory` into `ox_inventory/data/items.lua`.
2. Add item images to `ox_inventory/web/images`.


### Step 2: Configure Drug Locations & Recipes

- All **processing locations and recipes** are located in their respective drug type files:
  - `cocaine.lua`,
  - `meth.lua`,
  - `weed.lua`,
  - etc.
- **Plant spawns** are managed in `server/plantSpawns.lua`.

> ✏️ Modify these files to customize spawn points, yields, and processing times.

### STEP 3 (IF QBCore)
- check `qb-smallresources/config.lua` and if this exists, delete it 
    - look for this code
        ```lua
        [2] = { --Coke Processing Enter/Exit
                [1] = {
                    poly = { coords = vector3(909.49, -1589.22, 30.51), heading = 92.24, length = 2, width = 2 },
                    allowVeh = false,
                    label = '[E] Enter Coke Processing'
                },
                [2] = {
                    poly = { coords = vector3(1088.81, -3187.57, -38.99), heading = 181.7, length = 2, width = 2 },
                    allowVeh = false,
                    label = '[E] Leave'
                }
            }
        ```
	
### STEP 4
- Run SQL
    - if you dont know how, click this image below
        - [![YouTube Video](https://img.youtube.com/vi/8QpFOluK_xo/hqdefault.jpg)](https://www.youtube.com/watch?v=8QpFOluK_xo)

### STEP 5 
- If you want whippits, take the folder `ate_balloon` and place that folder into the standalone folder like it was another script :)