> 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/multi-character/installation.md).

# 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_multicharacter
```

***

## Setting Up

Here you can see how to setup the FiveM Multi Character Script for both QBCore and ESX Frameworks.

### Steps

* Execute the data.sql file that comes in the script.
* Setup the config as your wish.

### Spawn Selector Event

To change the spawn selector trigger, simply go to \`server/open.lua\` file and find the SpawnSelector function which looks like this:

```lua
function SpawnSelector(src, playerData, firtSpawn)
    TriggerClientEvent('qb-spawn:client:setupSpawns', src, playerData, false, nil)
    TriggerClientEvent('qb-spawn:client:openUI', src, true)
end
```

### Additional Changes

#### Skinchanger Script

To use this script with skinchange resource, you have to change the ApplySkin function which at 149th line of the client/main.lua file with this code:

```lua
function ApplySkin(skin, clothes, ped)
    local playerPed = ped or PlayerPedId()
```

And add this in the client/main.lua

```lua
RegisterNetEvent("skinchanger:applySkin", function(...)
    ApplySkin(...)
end)
```