Installation

Script Download

Before starting, you must log in to the CFX portal to download the asset. You will be able to download it as many times as you want on the official CFX page. Just as you download it the first time, you will also download it multiple times in the future to get updates.

1

Logging in to the CFX Portal

First, log in to the official CFX portal by clicking here.

2

Finding Your Assets

Once logged in, navigate to the Granted Assets section to access your purchased assets. You can download them by clicking the "Download" button.

Remember, if you encounter any issues or errors when starting the asset, you can check here to see if the problem is related.

Understanding CFX Auth

---

Modifications and Dependencies

For any other clothing systems, compatibility can be achieved manually by editing the open-source files provided within the asset or by contacting the system creator.

Quasar Multicharacter has minimal dependencies, requiring only a compatible clothing system or manual compatibility adjustments.

1

Removing Conflicting Assets

ESX Version

Remove esx_multicharacter.

QBCore Version:

Remove qb-multicharacter and optionally qb-spawn if you plan to use Quasar's integrated spawn selector. The asset supports qb-apartments if enabled in the fxmanifest.lua.

2

Clothing System Compatibility

Quasar Multicharacter is pre-configured to work with the following systems:

• qb-clothing

• esx_skin

• illenium-appearance

If your clothing system replaces esx_skin and skinchanger, it may work out of the box by declaring esx_skin or qb-clothing in the config.

---

Issues in illenium-appearance

If you do not use illenium-appearance, skip this step.

If your character does not spawn with the correct clothing or appearance, follow these steps for illenium-appearance:

1

Open the manifest file in your illenium-appearance folder

2

Remove the lines

provides {esx_skin, skin_changer}

3

Check other scripts

Remove this line if it exists.

dependencies {esx_skin, skin_changer}

4

Clear the server cache

Once you have completed these steps, clear your server cache and restart it.

---

Update artifacts and gamebuild

Updating to the latest artifacts and gamebuild is essential to avoid common server issues. Here's how to do it properly:

1

Update Artifacts

Completely replace your current artifacts with the latest version. Download the appropriate artifacts for your operating system from the official links:

• Windows: Windows Artifacts.

• Linux: Linux Artifacts.

2

Update Gamebuild

Using the latest gamebuild is critical to take advantage of the newest features and avoid compatibility errors.

Edit the server.cfg file and add the following line:

sv_enforceGameBuild 3258

You can see the complete guide to update your server here:

How to update my server

---

Server.cfg Positioning

For optimal functionality, ensure that this asset is started directly below your framework and inventory folders. Proper initialization depends on this order, as starting it elsewhere could lead to errors or conflicts. Always prioritize framework and inventory loading before this asset.

We recommend starting this asset within its own folder using ensure [multicharacter] in your server configuration. This approach ensures a clean and organized initialization, minimizing potential conflicts and maintaining proper asset functionality.

---

Database Installation

For this step, we highly recommend using HeidiSQL to avoid issues, as it provides an updated version of MariaDB. We have a guide that explains step-by-step how to use HeidiSQL. If you choose to use phpMyAdmin, we will not be responsible for any errors that may occur in your database.

How to install HeidiSQL

Quasar Multicharacter features an intelligent system that automatically creates the necessary database table for you upon first launch. This means there’s no need for manual database installation or modifications. The table used for managing character slots is named multichar_slots, and it will be generated seamlessly by the system, ensuring a hassle-free setup process.

---

Blocking slots using Tebex

Quasar Multicharacter provides a flexible slot management system, offering two main methods for administrators to control character slots: Tebex integration and manual management.

1

Tebex Integration

Quasar Multicharacter is fully compatible with the Tebex Store, allowing you to sell character slots directly through your server's Tebex store. This system enables players to purchase additional character slots seamlessly, which can then be unlocked and managed automatically. The configuration for these locked slots can be adjusted in config.lua under the "tebex" setting, giving you full control over how these slots are managed and displayed.

2

Manual Slot Management

If you prefer not to use Tebex for slot management—for reasons such as payment flexibility or direct control—you can use the /addslot id command. This command allows administrators to manually assign additional slots to a player using their server ID. This method is ideal for those who want to manage slots independently of the Tebex platform.

3

Why This Step is Important

Skipping this configuration step may lead to confusion or misuse of the slot system. It is crucial to understand how the Tebex integration or manual management works to ensure a smooth experience for both administrators and players.

For a detailed guide on using and integrating this system, refer to the official documentation. Properly understanding this system is essential for its effective implementation.

In the following link you will learn how to get the Tebex token and how to execute in this script:

Char Slots Integration