---
description: LuaLab Multicharacter - Installation & Configuration Guide
---

# LuaLab-Multicharacter

### Table of Contents

* Prerequisites
* Installation
* Configuration
* Troubleshooting
* FAQ

### Prerequisites

Before installing LuaLab Multicharacter, ensure you have:

1. Latest version of QBCore Framework
2. One of the following appearance systems:
   * qb-clothing
   * fivem-appearance
   * illenium-appearance

### Installation

1. Download the latest release from the Keymaster.
2. Extract the `LuaLab-Multicharacter` folder to your server's resources directory
3. Add the following to your server.cfg:

```cfg
ensure qb-core
ensure [your-appearance-system]
ensure LuaLab-Spawn
ensure LuaLab-Multicharacter
```

4. Import the provided SQL file to your database
5. Restart your server

### Configuration

#### Basic Configuration

The main configuration file is located at `config.lua`. Here are the key settings:

```lua
Config = {}

-- Number of character slots
Config.MaxCharacters = 5

-- Starting money for new characters
Config.StartingMoney = {
    cash = 500,
    bank = 5000
}

-- Spawn locations
Config.SpawnLocations = {
    -- Add your spawn locations here
}
```

#### Advanced Configuration

**Camera Settings**

You can adjust camera positions and transitions in `config.lua`:

```lua
Config.CameraSettings = {
    default = {
        coords = vector3(x, y, z),
        rotation = vector3(x, y, z)
    }
}
```

**UI Customization**

The UI can be customized in the `html/css/style.css` file.

### Troubleshooting

#### Common Issues

1. **Characters not loading**
   * Check your database connection
   * Verify QBCore is started before the multicharacter resource
   * Check server console for errors
2. **Black screen on character selection**
   * Ensure your appearance system is properly installed
   * Check for resource conflicts
   * Verify camera coordinates in config
3. **UI not showing**
   * Clear your FiveM cache
   * Check browser console for errors
   * Verify NUI is enabled
