# ⚙️ Basic Configurations

## 1. Framework

This option is used to choose your framework for the script, current options are:

<table><thead><tr><th width="236">Config value</th><th>Information</th></tr></thead><tbody><tr><td><pre class="language-lua"><code class="lang-lua">Framework = 'none',
</code></pre></td><td>This one is useful for servers without frameworks or with un-supported frameworks:)</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">Framework = 'Esx',
</code></pre></td><td>Useful for servers with es-extended or ESX Legacy framework!</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">Framework = 'QBCore',
</code></pre></td><td>Useful for servers with QBCore or QBox framework!</td></tr></tbody></table>

***

## 2. CustomPlate, Plate

This options is used to change the vehicle's plate to a random plate or configured plate.

{% hint style="danger" %}
Plates must be **UP TO 8 LETTERS**
{% endhint %}

<table><thead><tr><th width="236">Config value</th><th>Information</th></tr></thead><tbody><tr><td><pre class="language-lua"><code class="lang-lua">CustomPlate = true,
Plate = 'CW-SHOW',
</code></pre></td><td>With this configuration, the vehicles spawn with custom plate number, the plate will be 'CW-SHOW'</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">CustomPlate = false,
Plate = '',
</code></pre></td><td>With this configuration, the vehicles spawn with random plate numbers based on plate number management script or default GTA-V plate number functions</td></tr></tbody></table>

***

## 3. LockVehicles

With this option, you can do many things about showroom vehicles door stats!

<table><thead><tr><th width="293">Config value</th><th>Information</th></tr></thead><tbody><tr><td><pre class="language-lua"><code class="lang-lua">LockVehicles = 'NoInteract',
</code></pre></td><td>With this configuration, the vehicle doors will be locked and players can't interact with vehicles using <code>F</code> key</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">LockVehicles = 'Unlocked',
</code></pre></td><td>With this configuration, the vehicle doors will be unlocked and players can sit in vehicles using <code>F</code> key</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">LockVehicles = 'Locked',
</code></pre></td><td>With this configuration, the vehicle doors will be locked and players can't sit in vehicles but they can interact using <code>F</code> key</td></tr></tbody></table>

***

## 4. FuelSystem, FuelLevel

With this options, you can modify the fuel management system!

<table><thead><tr><th width="275">Config value</th><th>Information</th></tr></thead><tbody><tr><td><pre class="language-lua"><code class="lang-lua">FuelSystem = 'none',
FuelLevel = '0',
</code></pre></td><td>With this configuration, the script will use the built-in fuel management system and set the vehicle fuels to 0, useful to prevent vehicles from starting if vehicle doors are unlocked!</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">FuelSystem = 'LegacyFuel',
FuelLevel = '50',
</code></pre></td><td>With this configuration, the script will use <a href="https://github.com/InZidiuZ/LegacyFuel"><strong>LegacyFuel</strong></a> to set the fuel level of the vehicles to 50</td></tr></tbody></table>

***

## 5. Freeze

With this options, you can freeze the vehicles at the spawn point locations to prevent them from moving!

<table><thead><tr><th width="209">Config value</th><th>Information</th></tr></thead><tbody><tr><td><pre class="language-lua"><code class="lang-lua">Freeze = true,
</code></pre></td><td>With this configuration, we will freeze the vehicles at the spawn point and nothing can move them from there. useful for when you want to allow players to sit in vehicles, start the engine and rev it to hear the engine sound as well!</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">Freeze = false,
</code></pre></td><td>With this configuration, we will not freeze the vehicles, so the vehicles can be moved by other vehicles or etc.</td></tr></tbody></table>

***

## 6. Refresh, RefreshUnit

With this options, you can refresh the vehicles every `x unit` to make the vehicles cleaner, replace them if they are destroyed, or even set them on ground properly if they're not!

{% hint style="warning" %}
Do not go lower than `10 Seconds` to prevent the script from using high server resources (CPU)
{% endhint %}

{% hint style="danger" %}
On larger servers, always use higher than `1 Minutes` refresh rate to prevent the script from using really-high server resources (CPU)
{% endhint %}

<table><thead><tr><th width="230">Config value</th><th>Information</th></tr></thead><tbody><tr><td><pre class="language-lua"><code class="lang-lua">Refresh = 5,
RefreshUnit = 'Min',
</code></pre></td><td>With this configuration, we will refresh the vehicles for the players every <code>5 Minutes</code></td></tr><tr><td><pre class="language-lua"><code class="lang-lua">Refresh = 15,
RefreshUnit = 'Sec',
</code></pre></td><td>With this configuration, we will refresh the vehicles for the players every <code>15 Seconds</code></td></tr></tbody></table>

***

## 7. EnableTargetOptions

With this options, you can enable the targetting script to allow players to interact with vehicles and check the vehicle info, open doors and check vehicle stats

{% hint style="info" %}
For the vehicle information, you need to choose the speed unit on the following code

```lua
SpeedUnit = 'kmh', -- Available Options = 'mph' or 'kmh'
```

{% endhint %}

<table><thead><tr><th width="284">Config value</th><th>Information</th></tr></thead><tbody><tr><td><pre class="language-lua"><code class="lang-lua">EnableTargetOptions = true,
</code></pre></td><td>With this configuration, players can interact with vehicles using ox_target script</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">EnableHood = true,
</code></pre></td><td>With this configuration, players will see the 'Open Hood' option on the targetting script</td></tr><tr><td><pre class="language-lua"><code class="lang-lua">EnableTrunk = true,
</code></pre></td><td>With this configuration, players will see the 'Open Trunk' option on the targetting script</td></tr><tr><td><pre class="language-lua"><code class="lang-lua"><strong>EnableDoors = true,
</strong></code></pre></td><td>With this configuration, players will see the 'Open Doors' option on the targetting script</td></tr><tr><td><pre class="language-lua"><code class="lang-lua"><strong>EnableVehInfo = true,
</strong></code></pre></td><td>With this configuration, players will see the 'Vehicle Info' option on the targetting script</td></tr><tr><td><pre class="language-lua"><code class="lang-lua"><strong>EnableVehStat = true,
</strong></code></pre></td><td>With this configuration, players will see the 'Vehicle Stats' option on the targetting script</td></tr></tbody></table>
