> 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-qbcore-framework.md).

# Installation Guide QBCore 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)
* PolyZone [(download here)](https://github.com/mkafrin/PolyZone/releases/tag/v2.6.1)
  {% 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

➤ Step 4: Add `PolyZone` 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%2FDVNz0Enjxuc2YRxxc64f%2FFoldersImage.png?alt=media&amp;token=85222a13-91da-4b2f-9fc0-e027623050bc" 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%2FmdgVKePxfqeb5NHCxLn1%2FSoocer%20CFG.png?alt=media&amp;token=f22a1804-755b-4b87-a54b-f59fd669958a" 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="QBCore" %}
{% content-ref url="/pages/PkCCFDz1sdRi0ZwCg0nY" %}
[QBCore/QBox Configuration](/fivem/cdev-library/qbcore-qbox-configuration.md)
{% endcontent-ref %}
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Cdev\_soccer Configuration

🚩 <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%2FFhBpBsKnbVqxnYlYruYf%2Fimage.png?alt=media&amp;token=76e70a87-4d13-4ea0-95c5-5662c793f1d8" 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 %}