> For the complete documentation index, see [llms.txt](https://docs.cdev.shop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cdev.shop/fivem/chat-system/installation-guide-qbox-server.md).

# Installation Guide QBOX Server

{% hint style="danger" %} <mark style="color:yellow;">Important:</mark> **Before you start the installation, if you have previously installed cdev\_chat, follow the steps below before proceeding with the installation steps.**
{% endhint %}

**➤ Step 1:** Completely delete the database table named **cdev\_chat\_channels**.

<div align="left" data-full-width="false"><figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FMrozXXv8GC5TubM48XOS%2Fheidisql_WYG2f4tPqf.gif?alt=media&amp;token=99020dd7-ca0a-4ebf-bcfb-2c0683e24b8f" alt="" width="536"><figcaption></figcaption></figure></div>

**➤ Step 2:** Delete the <mark style="color:yellow;">cdev\_lib</mark> and <mark style="color:yellow;">cdev\_chat</mark> resources from your **resources** folder.

{% hint style="success" %}
**All set! You can now start the installation guide below without any issues.**
{% endhint %}

{% stepper %}
{% step %}

### Install resource from [Portal](https://portal.cfx.re/assets/granted-assets)

**After installing, you should get a zip file with the name shown below.**

* <mark style="color:yellow;">cdev\_lib.pack.zip</mark>
* <mark style="color:yellow;">cdev\_chat.pack.zip</mark>
  {% endstep %}

{% step %}

### Extract and Organizing Your Resource Folders

🚩<mark style="color:red;">**Correct folder organization is essential for everything to work properly.**</mark>

➤ Step 1: Create the `[cdev]` folder. Inside your server's `resources` folder and Place **only** the following resource inside:

* <mark style="color:yellow;">cdev\_chat</mark>

➤ Step 2: Add `cdev_lib` to the Resources Root

**Below is an example screenshot showing the correct folder structure:**

<div align="left"><figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FhPSySX7gHe4PfWAqYmkH%2Fimage.png?alt=media&amp;token=241564f1-dc28-46da-9834-8232b56abcb3" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Server.cfg Configuration

This resource must always be started **after your&#x20;**<mark style="color:yellow;">**framework**</mark>**&#x20;and any&#x20;**<mark style="color:yellow;">**other**</mark>**&#x20;required resources**.

It is essential to follow the correct startup order to ensure proper functionality and avoid conflicts.

**➤ Step 1:** Inside the **server.cfg** file, look for the line `set resources_useSystemChat = true` and change **true** to **false and** also set false for the others options chat `chat_showJoins false` and `chat_showQuits false` .

<div align="left"><figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FUEUezAUc5qXQkKN2tkp3%2Fimage.png?alt=media&amp;token=ec7ac6e6-6b18-4241-b060-0a6f7dcf5ea1" alt=""><figcaption></figcaption></figure></div>

**➤ Step 2:** Add the ACE permission `add_ace group.admin cdev_chat.manager allow` so that you can control the chat as an admin, placing it insdie <mark style="color:yellow;">permissions.cfg</mark> file. After you open the file bellow the permissions from Ox Lib add new Permission for Cdev Chat like the image <mark style="color:yellow;">bellow</mark>

<figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FmtuHNisOwJm86DmIC8E5%2Fimage.png?alt=media&amp;token=8ab2c18e-a185-4030-b993-94b0c41acce4" alt=""><figcaption></figcaption></figure>

**➤ Step 3: Inside the server.cfg file r**emove the line `ensure chat`, and if you have it, also remove the line `ensure chat-theme-gtao`

**➤ Step 4:** Start the resources <mark style="color:yellow;">cdev\_lib</mark> and <mark style="color:yellow;">\[cdev]</mark> after all the other <mark style="color:red;">resources</mark> — it’s very important that it’s done exactly as shown in the picture below.

<div align="left"><figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2F9wpRR41dd7G5K6TDrpxa%2Fimage.png?alt=media&amp;token=6c61a3cc-9f75-49c5-877d-405a6d186096" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Deleting default chat resources

{% hint style="danger" %}
Inside your server’s **resources** folder, use the Windows search bar to look for **chat** and delete all of them except **cdev\_chat**, as showbelow.
{% endhint %}

```lua
cdev_chat (Not Delete)
qbx_chat_theme (Delete) [qbx] > qbx_chat_theme
chat-theme-gtao (Delete) [cfx-default] > [gameplay]
#If have another folder with chat delete too
```

{% endstep %}

{% step %}

### Cdev\_lib Configuration

For the cdev\_chat and the connection between your <mark style="color:yellow;">framework</mark> and the resources to work correctly, you need to configure the `cdev_lib` resource properly according to your <mark style="color:yellow;">framework</mark>. For more details, click the link below to follow the instructions.

{% tabs %}
{% tab title="QBOX" %}
{% content-ref url="/pages/PkCCFDz1sdRi0ZwCg0nY" %}
[QBCore/QBox Configuration](/fivem/cdev-library/qbcore-qbox-configuration.md)
{% endcontent-ref %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Cdev\_chat Configuration

**➤ Step 1:** Open the <mark style="color:yellow;">config.lua</mark> file located in the folder **`[cdev] > cdev_chat > public > config > config.lua`**

**➤ Step 2:** On line <mark style="color:yellow;">58</mark>, you’ll see a setting called `UseFallbackIcons = false`. Change **false** to **true**, so it becomes `UseFallbackIcons = true`.

**➤ Step 3:** If you want to add more icons, follow the step-by-step instructions below.

<mark style="color:red;">To add new icons:</mark>\ <mark style="color:red;">-</mark> Drop your .svg files in `cdev_chat/data/icons`\ <mark style="color:red;">-</mark> Open the file: `cdev_chat/public/config/config.lua`

**On line 59, add new icon example:**

```lua
FallbackIcons = {
    "alert.svg",
    "megaphone.svg",
    "message.svg",
    "person.svg",
    "newIcon.svg", -- New Icon Add
}
```

{% endstep %}

{% step %}

### How create new Chat Group

{% hint style="info" %}
**To have access to the** <mark style="color:$success;">chat</mark> **command, you need to have added the** <mark style="color:yellow;">ACE permission</mark> **for the** <mark style="color:yellow;">admin</mark> <mark style="color:red;">group</mark>**, and your account must belong to the** <mark style="color:yellow;">admin</mark> <mark style="color:red;">group</mark>**.**\ <br>
{% endhint %}

<figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FRfjRHqk0IXykM3fupQSG%2FFiveM_GTAProcess_LnPmIEUSl0-_online-video-cutter.com_.gif?alt=media&amp;token=48cb15da-4dc0-4a86-9bd5-d17492a58480" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}