> 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/soccer/installation-guide-qbox-framework.md).

# Installation Guide QBox Framework

{% stepper %}
{% step %}

### Install all resources dependencies

Make sure you have all of the following resources installed:

* cdev\_lib <mark style="color:green;">(included with this resource)</mark>
* cdev\_soccer
* xsound [<mark style="color:orange;">(download here)</mark>](https://github.com/Xogy/xsound)
  {% endstep %}

{% step %}

### Extract Ziped File

* Extract the contents of <mark style="color:yellow;">cdev\_soccer.pack.zip</mark> after extract should contain the `cdev_soccer` folder.
  {% endstep %}

{% step %}

### 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:

* cdev\_soccer

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

➤ Step 3: Add `xsound` 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%2FphbutTKqEKpkmx05vVOE%2FFolders.png?alt=media&amp;token=fb9010f6-2af5-497c-80fd-cc239f797efc" 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.

**Below is an example screenshot showing the recommended startup order:**

<div align="left"><figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FRwPLFHoH7kuIUHUbT8vJ%2FServerCFG.png?alt=media&amp;token=28fd2559-3400-4554-bf35-c8d2e6e7aacf" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Cdev\_lib Configuration

For the game system 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\_soccer Configuration

➤ Step 1: 🚩 <mark style="color:red;">To work correctly,</mark> <mark style="color:yellow;">**cdev\_soccer**</mark> <mark style="color:red;">requires the proper configuration of the polyzone in the</mark> `config.lua` <mark style="color:red;">file located in the</mark> `cdev_soccer > public > config > config.lua` <mark style="color:red;">folder.</mark>\ <mark style="color:red;">Below is how the file should be configured to ensure everything functions properly.</mark>

<div align="left"><figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FtXvPOMEqXRGOlaUMbqCh%2Fimage.png?alt=media&amp;token=6b0c3106-2698-4df1-bc0a-45dd4018b013" alt=""><figcaption></figcaption></figure></div>

➤ Step 2: <mark style="color:red;">**As in the case of**</mark> <mark style="color:yellow;">**QBox**</mark><mark style="color:red;">**, we use**</mark> **`ox_lib`** <mark style="color:red;">**to mark the**</mark> <mark style="color:yellow;">**zones**</mark><mark style="color:red;">**, it is necessary to enable the**</mark> **`ox_lib`** <mark style="color:$success;">**dependency**</mark> <mark style="color:red;">**inside the**</mark> <mark style="color:yellow;">**fxmanifest.lua**</mark> <mark style="color:red;">**file located in the**</mark> <mark style="color:yellow;">**cdev\_soccer**</mark> <mark style="color:red;">**folder. Leave the file exactly as shown in the picture bellow.**</mark>

<div align="left"><figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2Fdyr1nkZIW0j5oPfFM5Ny%2Fimage.png?alt=media&amp;token=c50a828f-7086-4e1f-b798-4f97e4aae7cc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Starting match in-game

**Location Default Field:** `vec4(770.54, -214.28, 66.11, 322.44)`

<figure><img src="https://1004862655-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPhIA9eCA4bwgx77hxx4i%2Fuploads%2FvXVVWP45dW8j8NZLTfhX%2FFiveM_GTAProcess_3PhcGEZBei%20(online-video-cutter.com).gif?alt=media&amp;token=1e6d1c27-1e9c-4ae8-854a-21b1d6710e3f" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}