# Props
[**Buy Here**](https://codesign.pro/product/4206359)
[**FiveM Forums Post**](https://forum.cfx.re/t/paid-prop-placer-by-codesign/2021828)
[**YouTube Showcase Video**](https://youtu.be/M17oaArlj8k)
#### Translate
* [Click here to translate this page.](https://docs-codesign-pro.translate.goog/paid-scripts/props?_x_tr_sl=en&_x_tr_tl=es&_x_tr_hl=en-GB&_x_tr_pto=nui)
* [How do I change language?](https://gyazo.com/38606313ac9a7c290dc2c72b6793bde6)
## INSTALLATION GUIDE
### Step 0 - First Steps
{% hint style="warning" %}
**1.** Download your resource from [FiveM’s Keymaster](https://keymaster.fivem.net/asset-grants).
**2.** Unzip the `cd_PROPS.zip` folder and place this folder in your server's resource folder.
**3.** Add the resource to your server start config (server.cfg): `ensure cd_props`. If you are using a framework, it must be placed anywhere below your framework resource e.g., es\_extended, not above.
```
ensure es_extended
ensure cd_props
```
{% endhint %}
### Step 1 - Configure the resource
{% hint style="warning" %}
You **MUST** read all configurable options inside the **`[cd_props/configs/config.lua]`** file and configure them to suit your server's needs. Please read the [”commented out help text”](https://i.imgur.com/QCja8UZ.png) at the end of each line so you can understand what each config option does.
**The most important sections are the options under the** [**Framework** ](https://i.imgur.com/4ukCTZr.png)**and** [**Important** ](https://i.imgur.com/IVm7E8l.png)**sections at the top of the `config.lua`. Everything else is optional.**
{% endhint %}
##
## INFORMATION
### Default Key Binds
These keys can be modified and/or disabled in the [Keys and Commands](https://i.imgur.com/bTvuXLZ.png) section of the `[configs/config.lua]`.
| **Key** | **Description** |
| ------------------ | ------------------------------- |
| **`Numpad Minus`** | Open the main props UI. |
| **`L`** | Pickup/drop props on the floor. |
| **`Backspace`** | Delete the prop in your hand. |
### Chat commands
These chat commands can be renamed and/or disabled in the [Keys and Commands](https://i.imgur.com/bTvuXLZ.png) section of the `[configs/config.lua]`.
The exact usage for each command will be displayed in the chat suggestions when using the commands in-game.
| **Command** | **Description** |
| ----------- | ----------------------- |
| **`/prop`** | Open the main props UI. |
##
## COMMON ISSUES
Please check out our [**Troubleshooting Guide**](https://docs.codesign.pro/coding-information/self-debugging#troubleshooting) before contacting our support.
🔔 **Folder Name** Make sure the name of the folder is `cd_props`.
🔔 **Encrypted Files** Do not edit the encrypted files in any way.
## ERROR CODES
If you see an error code not listed below, please open a script support ticket in the [Codesign Discord](https://discord.gg/codesign).
{% tabs %}
{% tab title="Server" %}
N/A
{% endtab %}
{% tab title="Client" %}
N/A
{% endtab %}
{% endtabs %}
## CHANGELOG
> **Files Changed**
>
> Not every update requires you to replace the whole folder. We do this because we understand it's a pain to redo the configs for every update.
* **All Files -** This means you should delete your old `cd_props` folder, download and add in the latest version, reconfigure the configs folder and restart your server.
* **All Files Except config.lua -** This means you should do all of the above (in the All Files section) but additionally **make a backup of the `config.lua`** file and replace the new config.lua file with the one you made a backup of.
* **Specific Files -** This means you can copy and paste the **SPECIFIC** new files over the old ones and restart the server.
{% hint style="warning" %}
**Skipping Updates**
If you are attempting to update to the latest version but have skipped previous updates, you should update all files just to be safe. For example., let's say you are currently on v4.0.1, you did not update when v4.0.2 was released, and now v4.0.3 is released, and you want to update; you should always use the “All Files” update method.
{% endhint %}
{% tabs %}
{% tab title="v3.0.0" %}
### 26/12/2020 - 07/06/2021
v3.0.0 - v3.0.6
**Files Changed:**
* [x] All Files
* [ ] All Files Except config.lua
* [ ] Specific Files
**Update Type:**
* [x] Mandatory
* [ ] Optional
**Changelog:**
{% hint style="success" %}
**Add**
* Added ability for different jobs to use different props.
* Added the ability to rename all esx events such as the setjob and playerloaded events.
{% endhint %}
{% hint style="info" %}
**Edit**
* Updated the codesign error handlers.
* Removed the "no permissions" notification.
* Disabled the UI from opening when you are in a vehicle.
{% endhint %}
{% hint style="warning" %}
**Fix**
* Fixed random server error on server start.
* Fixed an issue with Chinese characters on the draw text.
* Temporary fix for the canary issue until the new Tebex FiveM license system is ready to launch, when this is released we will be fully switching over to the new system.
{% endhint %}
{% endtab %}
{% tab title="v4.0.0" %}
### 03/11/2021
**Files Changed:**
* [x] All Files
* [ ] All Files Except config.lua
* [ ] Specific Files
**Update Type:**
* [x] Mandatory
* [ ] Optional
**Changelog:**
{% hint style="danger" %}
**We are now using the official Authentication System provided by FiveM. The old auth system will be taken offline 1 week from now (give or take a few days if needed).**
{% endhint %}
{% hint style="success" %}
**Add**
* Added a new config option which will allow spawned props to be frozen in position.
{% endhint %}
{% endtab %}
{% tab title="v4.0.1" %}
### 08/11/2021
**Files Changed:**
* [ ] All Files
* [ ] All Files Except config.lua
* [x] Specific Files
```lua
fxmanifest.lua - (IMPORTANT)
server/main/server.lua - (IMPORTANT)
client/main/client.lua - (IMPORTANT)
html (FULL FOLDER) - (IMPORTANT)
configs/client_customise_me.lua
```
**Update Type:**
* [x] Mandatory
* [ ] Optional
**Changelog:**
{% hint style="danger" %}
**Authentication**
* **Small authentication update to ensure stability**.
{% endhint %}
{% hint style="warning" %}
**Fix**
* Fixed bug where if the config was set to anyone can use props it would error.
{% endhint %}
{% endtab %}
{% tab title="v4.0.2" %}
### 07/07/2021
**Files Changed:**
* [ ] All Files
* [ ] All Files Except config.lua
* [x] Specific Files
```lua
fxmanifest.lua - (IMPORTANT)
client/main/client.lua - (IMPORTANT)
```
**Update Type:**
* [x] Mandatory
* [ ] Optional
**Changelog:**
{% hint style="warning" %}
**Fix**
* Removed the "no permissions" client-side print.
* Fixed a typo with the "OnlyGrabPropsFromCars" config option.
{% endhint %}
{% endtab %}
{% tab title="v4.0.3" %}
### 17/07/2025
**Files Changed:**
* [ ] All Files
* [ ] All Files Except config.lua
* [x] Specific Files
```lua
fxmanifest.lua
client/main/client.lua
```
**Changelog:**
{% hint style="info" %}
**Fix**
* Fixed deprecated SetCarBootOpen native
{% endhint %}
{% endtab %}
{% endtabs %}