> For the complete documentation index, see [llms.txt](https://needforscript.gitbook.io/needforscripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://needforscript.gitbook.io/needforscripts/our-scripts/garage-script/installation.md).

# Installation

### Prerequisites

Before installing the N4S Garage Script, ensure you have the following dependencies:

#### Required Dependencies

📦[ **ox\_lib**](https://github.com/overextended/ox_lib)

🌉 [**bl\_bridge**](https://github.com/Byte-Labs-Studio/bl_bridge)

***

### 📦 Installation Steps

#### 1. Dependencies Installation

* Install[ **ox\_lib**](https://github.com/overextended/ox_lib)
* Install[ **bl\_bridge**](https://github.com/Byte-Labs-Studio/bl_bridge)
* Ensure your framework is up to date

#### 2. Database Setup (Optional - Auto Executed by us) 

**📃 SQL Table**

Execute the following SQL queries in your database:

```sql
CREATE TABLE IF NOT EXISTS `nfs_garages` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `label` char(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL,
  `style` char(50) DEFAULT NULL,
  `owner` text CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL,
  `coords` text CHARACTER SET utf8mb4 COLLATE utf8mb4_bin DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=23 DEFAULT CHARSET=latin1 COLLATE=latin1_swedish_ci;
```

🚨 **Important Notes**

* Ensure your database user has permissions to create and modify tables
* Backup your database before installation
* Run these queries in your server's database

#### 3. Script Installation

1. Download the N4S Garage Script  from your keymaster granted assets
2. Place in your resources folder
3. Add to your server.cfg or resources.cfg
4. Add bl\_bridge convars to your server.cfg with your server options

```lua
# 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 'ox'
```

***

### Need Help?

* Check our [**Discord support channel**](https://discord.com/invite/e6978cg73k)
* Review the comprehensive **documentation**

***

### ✅ Installation Checklist

* [ ] Install ox\_lib
* [ ] Install bl\_bridge
* [ ] Create SQL tables
* [ ] Place script in resources and start it on your .cfg file
* [ ] Configure settings
* [ ] Restart server