# Installation

<details>

<summary>Dependencies</summary>

* The main dependency is **ox\_lib**, make sure to download the compiled resource and NOT the source code, the one you need to download is named **ox\_lib.zip**\
  **Download here**: <https://github.com/communityox/ox_lib/releases/latest><br>

  <figure><img src="/files/9LkJNSd53W6eF3f8c9D4" alt=""><figcaption><p>Always download the latest version</p></figcaption></figure>
* **ox\_lib** needs to be started before any of my scripts in your server.cfg

</details>

<details>

<summary>Inventories</summary>

* The only compatible inventories are:\
  \&#xNAN;*qb-inventory, origen\_inventory, quasar inventory, ox\_inventory, tgiann-inventory, ps-inventory, jaksam\_inventory and codem-inventory.*

Inspired/custom inventories or old versions are **NOT supported.**\ <mark style="color:purple;">> Not every inventory needs extra installation steps for laptop to work.</mark>

</details>

<details>

<summary>Frameworks</summary>

* Only supported Frameworks are: **ESX, QBCore and Qbox**
* If using qbox make sure to uncomment the qbox imports in av\_laptop/fxmanifest.lua

If you are not using any of this Frameworks or you are using some modified version read [Custom Framework/Inventory](/laptop-pack-v3/laptop-v3/installation/custom-framework-inventory.md)

</details>

<details>

<summary>Quasar Phone</summary>

* Run this query only if you are using the **qs-smartphone-pro** script:

```sql
ALTER TABLE phone_gallery
ADD COLUMN label LONGTEXT;
```

</details>

### Setup

* Please **read the config.lua**, all options have a comment that explains how it works.
* The script will auto detect your Framework, it will "fail" if your qb-core or es\_extended are named differently, if that's your case change the Framework manually in config/\_framework.lua and any other file where is needed (use a search word function to find what to edit).
* Open **\_ITEMS folder**, inside you can find a file named **items.md**, inside you will find some needed items and you have to copy/paste into your Framework/Inventory to register the items.
* **Note:** For some reason qb-core and some other inventories have the item laptop already registered, make sure to delete it and use the one provided in items.md

### **Common issues**

> **I use the laptop item but nothing happens, try the following options:**
>
> * If using **qb-core**, 99% of people having this issue is because they skip this step: [QBCore](/laptop-pack-v3/laptop-v3/installation/qbcore.md#items)
> * Verify you don't have other script already using an item named 'laptop', if that's the case then you need to change the item name in **`av_laptop/config/config.lua >  Config.LaptopItem`**. Change it to any other name you want, for example `av_laptop` Make sure to add this new item to your Framework/Inventory item list.
> * Verify av\_laptop is installed correctly and running without errors, go to your server console (txadmin) and restart av\_laptop, it should restart without errors and it should print your current inventory, framework and target (if using any).


---

# 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://docs.av-scripts.com/laptop-pack-v3/laptop-v3/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.