> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_drugs/installation.md).

# Installation

Follow these steps to install `rcore_drugs` for the first time.

## 📋 Prerequisites

Before installing, make sure your server has:

| Requirement              | Notes                                              |
| ------------------------ | -------------------------------------------------- |
| Artifact `4960` or newer | Older artifacts can break the resource.            |
| `rcore_drugs_assets`     | Must be started before `rcore_drugs`.              |
| OneSync                  | Required for lab instances and synced entities.    |
| Database resource        | `oxmysql`, `mysql-async`, or `ghmattimysql`.       |
| Framework                | ESX, QBCore, QBX, or Standalone.                   |
| Inventory                | Needed for items, stash, rewards, and consumables. |

{% hint style="danger" %}
Do not start `rcore_drugs` without `rcore_drugs_assets`. The script depends on the assets resource.
{% endhint %}

## 🛠️ First Time Installation

{% stepper %}
{% step %}

#### Download the resource

Download `rcore_drugs_assets` and `rcore_drugs` from [CFX Portal](https://portal.cfx.re/assets/).
{% endstep %}

{% step %}

#### Move the folders

Move both folders into your server 📁`resources` folder.

```
📁 server
└── 📁 resources
    ├── 📁 rcore_drugs_assets
    ├── 📁 rcore_drugs
    └── 📁 other resources
```

{% endstep %}

{% step %}

#### Add inventory items

Add the drug items to your inventory resource. The item images are inside:

```
rcore_drugs/assets/inventory_images
```

See the [inventory integration](/paid-resources/rcore_drugs/integrations/inventory.md) page for supported inventories and item names.
{% endstep %}

{% step %}

#### Ensure the resources

Add the resources to `server.cfg` after your framework, database, inventory, target, and dispatch resources.

```cfg
ensure rcore_drugs_assets
ensure rcore_drugs
```

{% endstep %}

{% step %}

#### Seed default data

Start the server once. The script creates its database tables automatically.

After the tables are created, run this in the server console:

```cfg
drugs_seed
```

This imports the default labs, station presets, actions, consumables, harvest zones, dealers, supplier items, and upgrade data.
{% endstep %}

{% step %}

#### Configure the script

Join the server and open:

```cfg
/drugs_admin
```

Use the admin panel to configure the script for your server.
{% endstep %}
{% endstepper %}

## 🗄️ Database

`rcore_drugs` creates its own database tables automatically on startup. You do not need to import an SQL file manually.

The default gameplay data is not inserted until you run `drugs_seed` from the server console.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.rcore.cz/paid-resources/rcore_drugs/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
