LuaLab-Multicharacter

LuaLab Multicharacter - Installation & Configuration Guide

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:

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

1. Import the provided SQL file to your database

2. Restart your server

Configuration

Basic Configuration

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

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:

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