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

# Installation Guide ESX 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="/files/h6YJaRtiDaHqEqnL7WpR" 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="/files/9DCdsTP44G07CET6Vws2" 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="ESX" %}
{% content-ref url="/pages/Yi1MUNc2bDxhthgwzwsL" %}
[ESX Configuration](/fivem/cdev-library/esx-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="/files/uEGFdZ1BdWFteny0uGw1" alt=""><figcaption></figcaption></figure></div>

➤ Step 2: <mark style="color:red;">**As in the case of**</mark> <mark style="color:yellow;">**ESX**</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="/files/B0nDLjunW0JuNzxZS2X4" 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="/files/28JI1e4BZDY48TRdVYkZ" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}