# Installation

## Customs Script Installation Guide

Follow these steps to install the NeedForScripts Customs Script on your FiveM server.

### Prerequisites

Before you begin, ensure you have:

1. FiveM server with administrator access
2. File transfer capability (FTP or direct file access)

### Step 1: Install Dependencies

The Customs Script requires two dependencies:

1. [ox\_lib](https://github.com/overextended/ox_lib)
2. [bl\_bridge](https://github.com/Byte-Labs-Studio/bl_bridge)

To install these:

1. Download `ox_lib` from [overextended GitHub repository](https://github.com/overextended/ox_lib)
2. Download `bl_bridge` from [Byte Labs GitHub repository](https://github.com/Byte-Labs-Studio/bl_bridge)
3. Place both resources in your server's resources folder
4. Add the following lines to your `server.cfg`:

   ```
   ensure ox_lib
   ensure bl_bridge
   ```
5. Add the bl\_bridge convars to your server.cfg with your server options: <br>

   ```
   # Frameworks 'ox' | 'qb' | 'esx' | 'qbx'
   setr bl:framework 'qb' 

   # Inventories 'ox' | 'qb' | 'esx' | 'ps' | 'qs' | 'origen' | 'none'
   setr bl:inventory 'ox'

   # Context 'ox' | 'qb'
   setr bl:context 'ox'

   # Target 'ox' | 'qb'
   setr bl:target 'ox'

   # Progress 'ox' | 'qb'
   setr bl:progressbar 'ox'

   # Radial 'ox' | 'qb'
   setr bl:radial 'ox'

   # Notification 'ox' | 'qb' | 'esx'
   setr bl:notify 'ox'

   # TextUI 'ox' | 'qb' | 'esx'
   setr bl:textui 'o
   ```

### Step 2: Install the Customs Script

1. Download the Customs Script from your NeedForScripts purchase
2. Extract the files to your server's resources folder
3. Add the following line to your `server.cfg`:

   ```
   ensure nfs-customs
   ```

### Step 3: Configuration

1. Open the `config.lua` file in the Customs Script folder
2. Adjust settings according to your server's needs (refer to our Configuration Guide for details)

### Step 4: Start Your Server

1. Save all changes
2. Start or restart your FiveM server

### Verification

To verify the installation:

1. Connect to your server
2. Visit a vehicle customization shop in-game
3. Confirm that you can access and use the customization features

If you encounter any issues, please check our Troubleshooting Guide or contact our support team.

Enjoy using the NeedForScripts Customs Script on your server!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://needforscript.gitbook.io/needforscripts/our-scripts/customs/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.