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
    • oxmysql
    • illenium-appearance, fivem-appearance, rcore_clothing or qb-clothing
    • An Advanced Multicharacter licence

    Installation

    1. 1
      Buy Advanced Multicharacter on our store.
    2. 2
      Sign in at panel.d7team.com with Discord.
    3. 3
      Client Area → Redeem Code: enter the code and your server's public IP.
    4. 4
      Download d7-multicharacter from the Client Area and put it in resources.
    5. 5
      Remove qb-multicharacter from your resources.
    6. 6
      In server.cfg, start it after your database and framework:
      ensure oxmysql
      ensure qb-core
      ensure illenium-appearance
      ensure d7-multicharacter
    7. 7
      Put your own clothing resource in the block above.
    8. 8
      Restart 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.

    Stuck? Ask us on Discord — the people who wrote it answer.

    Ask on DiscordAbout this resource