Docs
Advanced Multicharacter — Installation and Setup Guide
It uses your framework's own tables — no SQL to import.
Your framework
The requirements and steps below follow the framework you pick.
Requirements
- A QBCore server, CFW included
- A QBox server with qbx_core and ox_lib
- An ESX server with es_extended
- oxmysql
- illenium-appearance, fivem-appearance, rcore_clothing or qb-clothing
- illenium-appearance, fivem-appearance, rcore_clothing or skinchanger with esx_skin
- An Advanced Multicharacter licence
Installation
- 1Buy Advanced Multicharacter on our store.
- 2Sign in at panel.d7team.com with Discord.
- 3Client Area → Redeem Code: enter the code and your server's public IP.
- 4Download d7-multicharacter from the Client Area and put it in resources.
- 5Remove qb-multicharacter from your resources.
- Remove esx_multicharacter from your resources.
- In qbx_core's config/client.lua, set useExternalCharacters = true.
- 6In server.cfg, start it after your database and framework:
ensure oxmysql ensure qb-core ensure illenium-appearance ensure d7-multicharacter - In server.cfg, start it after your database and framework:
ensure oxmysql ensure ox_lib ensure qbx_core ensure illenium-appearance ensure d7-multicharacter - In server.cfg, start it after your database and framework:
ensure oxmysql ensure es_extended ensure skinchanger ensure esx_skin ensure d7-multicharacter - 7Put your own clothing resource in the block above.
- 8Restart the server.
config/config.lua
The settings you will change. Everything else can stay as it ships.
- Config.Slots = 3
- Characters per player
- Config.SlotsByLicense
- More characters for one player, by licence
- Config.SlotsByAce
- More characters for an ACE group, e.g. a Discord role
- Config.EnableDelete = true
- Players may delete their own characters
- Config.StreamerMode = false
- Hide the phone number and the money
- Config.Age = 18 – 90
- The youngest and oldest age allowed
- Config.DefaultSpawn = false
- Where a new character starts (false: the airport)
- Config.Colors
- The menu's colours
- Config.Webhooks
- Discord logs: created, loaded, deleted
- Config.WakeScene = true
- The wake-up scene on or off
- Config.ScenePlace
- Where the characters are shown (vector4)
- /logout is for the top permission, or the ACE command.logout.
- Any of your server scripts sends a player back to the menu with this event:
- TriggerEvent('d7-multicharacter:logout', playerId)
First start
- The console prints "License Approved".
- A player who joins sees the character menu.
Updates
- Updates download on their own when the resource starts — the console prints "Update installed".
- The new version runs only after a restart: when you see "Restart Required for update", restart the resource.
- If it says "Run refresh", type refresh first, then restart the resource.
Troubleshooting
- No supported framework has started yet (qbx_core, qb-core, es_extended or vrp).
- Start your framework's core before this resource.
- This IP is not linked to a license. Redeem a code to link it, then restart
- Redeem your code with this server's IP, then restart.
- This server's IP does not match the IP on the license.
- Ask us on Discord to update the licence IP.
- Your license is expired. Renew it.
- Renew from our store, then restart.
- Your license does not cover this product.
- Redeem a code for this product.
- The resource folder must be named
- Rename the folder and its ensure line to the name shown.
- The update is not loaded yet. Run refresh, then restart
- Type refresh in the console, then restart the resource.
- The API is unreachable or busy.
- It retries on its own. Check the server's internet if it stays.
- is no longer supported. Install the latest release
- Get the latest release from the Client Area, replace the folder, refresh and restart.
- This license is not active. Contact D7 support.
- Contact us on Discord.
- This IP is linked to more than one license.
- Contact us on Discord to keep one licence on this IP.
- This server could not determine its own IP.
- Check the server can reach the internet, then restart.
- The server did not answer
- Shown in F8: check the server console for an error, and oxmysql first.
What you seeWhat to do
Stuck? Ask us on Discord — the people who wrote it answer.
Ask on DiscordAbout this resource