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

# 🚗 Garage

{% hint style="warning" %}
**Garages use a different database than those from the Framework**
{% endhint %}

## INSTALLATION GUIDE

### <mark style="color:red;">Step 0 - First Steps</mark>

{% hint style="info" %}
Download [**is\_garage**](https://keymaster.fivem.net/) from KeyMaster and install [**is\_bridge & is\_lib**](/documentation/free-scripts/bridge-and-library/usage-and-installation.md).
{% endhint %}

### <mark style="color:red;">Step 1 - Configure Resources</mark>

{% hint style="info" %}
You must read and configure the `config.lua` file in **is\_garage** to meet your needs.
{% endhint %}

### <mark style="color:red;">Step 2 - Import SQL</mark>

{% hint style="info" %}
You can import the `is_garage.sql` file included with the received script or use the following command in the database
{% endhint %}

```sql
CREATE TABLE `is_garage` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `owner` longtext,
  `model` varchar(50),
  `hash` bigint(20),
  `vin` varchar(50),
  `plate` varchar(25),
  `status` longtext,
  `parked` longtext,
  `fuel` int(11),
  `engine` int(11),
  `body` int(11),
  `distance` float(10,2),
  `mods` longtext,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8mb3_general_ci;

CREATE TABLE `is_garage_codes` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `type` varchar(100),
  `code` varchar(100),
  `package` int(11),
  `count` int(11),
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8mb3_general_ci;

CREATE TABLE `is_garage_keys` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `identifier` varchar(100),
  `name` varchar(100),
  `vin` varchar(100),
  `favorite` tinyint(1),
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8mb3_general_ci;

ALTER TABLE `is_garage` MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=84;
ALTER TABLE `is_garage_codes` MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=12;
ALTER TABLE `is_garage_keys` MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=66;

COMMIT;
```

### <mark style="color:red;">Step 3 - Tebex Integration</mark>

{% hint style="info" %}
Log in to your [**Tebex**](https://www.tebex.io/) account, go to your project, and then:

1. Open the **Integrations** tab and select **Game Servers**.
2. If you don't have a created Server, click **Connect Game Server** and choose the **PLUGIN** connection type. Then, you'll need to specify the **Server Name** and click **Select All** next to **Packages**.
3. If you have an existing Server, make sure it has the properties mentioned above.
4. Click **Edit** on Your Server and then click **Copy** in the **Secret Key** tab.
5. Then, in your server, go to `server.cfg` and insert this line, replacing **yourKey** with the copied key:

   ```ini
   setr sv_tebexSecret yourKey
   ```

{% endhint %}

### <mark style="color:red;">Step 4 - Package Integration</mark>

{% hint style="info" %}
Log in to your [**Tebex**](https://www.tebex.io/) account, go to your project, and then:

1. Go to the **Packages** tab and create your resource.
2. Once you've done that, go to the package you created.
3. The link to the page you are on should look like this: `https://creator.tebex.io/packages/0000000`, where the digits at the end of the link represent your package's ID - copy them.
4. In your server, go to `is_garage/config.lua` and create a new table in `cfg.Tebex.packages`. It should look like the following:

   ```lua
   {id = 0, chars = 8}, -- id - Copied Package Id, chars - Maximum Characters in Plate
   ```
5. Now, anyone with the specified resource will be able to use it in the game by referencing the transaction, `tbx-xxxxxxxxx`.
   {% endhint %}

### <mark style="color:red;">Step 5 - Converting Vehicles</mark>

{% hint style="info" %}
To transfer your Vehicles from Old Garages, simply use the in-game command `convertVehicles` or the one set in `config.lua`, and then restart the script. After this, all vehicles from supported frameworks will be added to our Garage System.
{% endhint %}

### <mark style="color:red;">Step 6 - Snippet for Vehicle Shops</mark>

#### QBCore

`qb-vehicleshop` -> `client.lua`

**Search**

```lua
{
    header = Lang:t('menus.freeuse_buy_header'),
    txt = Lang:t('menus.freeuse_buy_txt'),
    icon = 'fa-solid fa-hand-holding-dollar',
    params = {
        isServer = true,
        event = 'qb-vehicleshop:server:buyShowroomVehicle',
        args = {
            buyVehicle = Config.Shops[insideShop]['ShowroomVehicles'][ClosestVehicle].chosenVehicle
        }
    }
},
{
    header = Lang:t('menus.finance_header'),
    txt = Lang:t('menus.freeuse_finance_txt'),
    icon = 'fa-solid fa-coins',
    params = {
        event = 'qb-vehicleshop:client:openFinance',
        args = {
            price = getVehPrice(),
            buyVehicle = Config.Shops[insideShop]['ShowroomVehicles'][ClosestVehicle].chosenVehicle
        }
    }
},
```

**Replace to**

```lua
{
    header = Lang:t('menus.freeuse_buy_header'),
    txt = Lang:t('menus.freeuse_buy_txt'),
    icon = 'fa-solid fa-hand-holding-dollar',
    params = {
        isServer = true,
        event = 'qb-vehicleshop:server:buyShowroomVehicle',
        args = {
            buyVehicle = Config.Shops[insideShop]['ShowroomVehicles'][ClosestVehicle].chosenVehicle,
            shop = insideShop,
        }
    }
},
-- {
--     header = Lang:t('menus.finance_header'),
--     txt = Lang:t('menus.freeuse_finance_txt'),
--     icon = 'fa-solid fa-coins',
--     params = {
--         event = 'qb-vehicleshop:client:openFinance',
--         args = {
--             price = getVehPrice(),
--             buyVehicle = Config.Shops[insideShop]['ShowroomVehicles'][ClosestVehicle].chosenVehicle
--         }
--     }
-- },
```

`qb-vehicleshop` -> `server.lua`

**Search**

```lua
RegisterNetEvent('qb-vehicleshop:server:buyShowroomVehicle', function(vehicle)
    local src = source
    vehicle = vehicle.buyVehicle
    local pData = QBCore.Functions.GetPlayer(src)
    local cid = pData.PlayerData.citizenid
    local cash = pData.PlayerData.money['cash']
    local bank = pData.PlayerData.money['bank']
    local vehiclePrice = QBCore.Shared.Vehicles[vehicle]['price']
    local plate = GeneratePlate()

    if cash > tonumber(vehiclePrice) then
        MySQL.insert('INSERT INTO player_vehicles (license, citizenid, vehicle, hash, mods, plate, garage, state) VALUES (?, ?, ?, ?, ?, ?, ?, ?)', {
            pData.PlayerData.license,
            cid,
            vehicle,
            GetHashKey(vehicle),
            '{}',
            plate,
            'pillboxgarage',
            0
        })
        TriggerClientEvent('QBCore:Notify', src, Lang:t('success.purchased'), 'success')
        TriggerClientEvent('qb-vehicleshop:client:buyShowroomVehicle', src, vehicle, plate)
        pData.Functions.RemoveMoney('cash', vehiclePrice, 'vehicle-bought-in-showroom')
    elseif bank > tonumber(vehiclePrice) then
        MySQL.insert('INSERT INTO player_vehicles (license, citizenid, vehicle, hash, mods, plate, garage, state) VALUES (?, ?, ?, ?, ?, ?, ?, ?)', {
            pData.PlayerData.license,
            cid,
            vehicle,
            GetHashKey(vehicle),
            '{}',
            plate,
            'pillboxgarage',
            0
        })
        TriggerClientEvent('QBCore:Notify', src, Lang:t('success.purchased'), 'success')
        TriggerClientEvent('qb-vehicleshop:client:buyShowroomVehicle', src, vehicle, plate)
        pData.Functions.RemoveMoney('bank', vehiclePrice, 'vehicle-bought-in-showroom')
    else
        TriggerClientEvent('QBCore:Notify', src, Lang:t('error.notenoughmoney'), 'error')
    end
end)
```

**Replace to**

```lua
RegisterNetEvent('qb-vehicleshop:server:buyShowroomVehicle', function(data)
    local src = source

    local vehicle = data.buyVehicle
    local shop = data.shop
    local vehiclePrice = QBCore.Shared.Vehicles[vehicle]['price']
    local plate = GeneratePlate()

    local pData = QBCore.Functions.GetPlayer(src)
    local cash = pData.PlayerData.money['cash']
    local bank = pData.PlayerData.money['bank']

    if cash > tonumber(vehiclePrice) then
        pData.Functions.RemoveMoney('cash', vehiclePrice, 'vehicle-bought-in-showroom')
    elseif bank > tonumber(vehiclePrice) then
        pData.Functions.RemoveMoney('bank', vehiclePrice, 'vehicle-bought-in-showroom')
    else
        TriggerClientEvent('QBCore:Notify', src, Lang:t('error.notenoughmoney'), 'error')
        return
    end

    TriggerClientEvent('QBCore:Notify', src, Lang:t('success.purchased'), 'success')

    TriggerEvent("is_garage:createVehicle", {
        model = vehicle,
        hash = GetHashKey(vehicle),
        plate = plate,
        parked = {
            coords = Config.Shops[shop].VehicleSpawn,
            street = Config.Shops[shop].ShopLabel,
        },
    }, src)
end)
```

#### QBox

{% hint style="warning" %}
Go to `qbx_vehicleshop/config/shared.lua` and set `finance.enable` to `false`
{% endhint %}

`qbx_vehicleshop` -> `server` -> `main.lua`

**Search**

```lua
RegisterNetEvent('qbx_vehicleshop:server:buyShowroomVehicle', function(vehicle)
    local src = source

    local shopId = GetShopZone(src)
    local shop = sharedConfig.shops[shopId]
    if not shop then return end

    if not CheckVehicleList(vehicle, shopId) then
        return exports.qbx_core:Notify(src, locale('error.notallowed'), 'error')
    end

    local coords = GetClearSpawnArea(shop.vehicleSpawns)
    if not coords then
        return exports.qbx_core:Notify(src, locale('error.no_clear_spawn'), 'error')
    end

    local player = exports.qbx_core:GetPlayer(src)
    local vehiclePrice = COREVEHICLES[vehicle].price
    if not RemoveMoney(src, vehiclePrice, 'vehicle-bought-in-showroom') then
        return exports.qbx_core:Notify(src, locale('error.notenoughmoney'), 'error')
    end

    local vehicleId = exports.qbx_vehicles:CreatePlayerVehicle({
        model = vehicle,
        citizenid = player.PlayerData.citizenid,
    })

    exports.qbx_core:Notify(src, locale('success.purchased'), 'success')

    SpawnVehicle(src, {
        coords = coords,
        vehicleId = vehicleId
    })
end)
```

**Replace to**

```lua
RegisterNetEvent('qbx_vehicleshop:server:buyShowroomVehicle', function(vehicle)
    local src = source

    local shopId = GetShopZone(src)
    local shop = sharedConfig.shops[shopId]
    if not shop then return end

    if not CheckVehicleList(vehicle, shopId) then
        return exports.qbx_core:Notify(src, locale('error.notallowed'), 'error')
    end

    local coords = GetClearSpawnArea(shop.vehicleSpawns)
    if not coords then
        return exports.qbx_core:Notify(src, locale('error.no_clear_spawn'), 'error')
    end

    local player = exports.qbx_core:GetPlayer(src)
    local vehiclePrice = COREVEHICLES[vehicle].price
    if not RemoveMoney(src, vehiclePrice, 'vehicle-bought-in-showroom') then
        return exports.qbx_core:Notify(src, locale('error.notenoughmoney'), 'error')
    end

    TriggerEvent("is_garage:createVehicle", {
        model = vehicle,
        hash = GetHashKey(vehicle),
        plate = qbx.generateRandomPlate(),
        parked = {
            coords = coords,
            street = shop.blip.label,
        },
    }, src)

    exports.qbx_core:Notify(src, locale('success.purchased'), 'success')
end)
```