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

# Installation

Welcome to Aty Scripts - Dealership script installation, here you can learn how to install our assets. Make sure you follow everything to make a clean installation.

## Download

To find and use the assets, you must have made the purchase from your own keymaster which you have your server key in. Otherwise you will not be able to use the asset.

Once you make the purchase, you'll be able to access it from your [keymaster](https://keymaster.fivem.net/asset-grants).

If you have more issues regarding [FiveM Escrow](https://forum.cfx.re/t/introducing-asset-escrow-for-your-resources/4777151), accounts or asset startup errors you can go here and see if any of them match your case, since Escrow requires some basics. Such as your keymaster account, your license key, etc.

***

## Dependencies

This assets has depencies such as frameworks like QBCore and ESX also MySQL connections. You can only use this script with qb-core or es\_extended based servers.

### MySQL

This asset needs MySQL connections so you need to have one of these resuources:

* oxmysql
* mysql\_async
* ghmattimysql

***

## Ensuring

To ensure and use this script in your server, simply add this code in your `server.cfg` file, under your MySQL and framework scripts.

```json
ensure aty_dealership
```

***

## Adding Custom Vehicles

You can add vehicles from the `shared/vehicles.lua` file. And to add the image simply go to the \`ui\` folder and drop your vehicles image, also the \*images name has to be the same as the vehicles spawn name\* and it has to be a \`.png\`.

***

## Adding New Dealerships

To add a new dealership, open the \`shared/config.lua\` file and go to the 17th line. You can find an example in there.

* The key of has to be unique.
* Job can be `all` or you can specify it.
* Coordinates is the coordinate that marker will appear.
* PedCoordinates is where the ped will appear.
* PreviewCoords is the inside of the dealership.
* PurchaseCoords is where the vehicle will spawn after you purchase it.
* TestCoordinates is where you test the vehicle.

### Setting Up The Categories.

You can add custom categories but make sure you don't delete any of the default ones. If you set the category to true than the vehicles in that category will be purchasable.

***

For any further support, please join our Discord server and open a ticket.