Framework Integration
Required framework modifications for ESX and Qbox to recognize the Boyraz Multicharacter system.
To ensure your server's core recognizes the Boyraz Multicharacter as the primary character management system, a few lines of configuration must be updated. This prevents native logic from interfering with our custom UI.
Important: Always create a backup of your framework files before making any modifications.
Choose Your Framework
ESX Legacy Integration
For ESX-based servers, you need to tell the framework that a custom multicharacter resource is active.
Target File:
Locate the Config.Multichar setting and update the detection logic:
Config.Multichar = GetResourceState("esx_multicharacter") ~= "missing"Config.Multichar = GetResourceState("uz_Multicharacter-2") ~= "missing"Pro Tip: This single line ensures that ESX automatically detects our resource and initializes the player data seamlessly without triggering its default UI.
Qbox Core Integration
Qbox handles external resources via its internal config. You must disable the core's built-in character management to allow Boyraz Multicharacter to take full control.
Target File:
Find the characters section and update the following settings:
useExternalCharacters = false,
startingApartment = true,
enableCharacterCreator = true,useExternalCharacters = true, -- Disables the core's internal character management
startingApartment = false, -- Prevents native apartment UI overlap
enableCharacterCreator = false, -- Routes character creation to the Boyraz systemVerification Steps
Save Files
Save all edited configuration files.
Restart Server
Restart your server or the core resources to apply the changes.
Check Console
Observe the server console to ensure there are no framework-specific initialization errors.
Test In-Game
The framework should now stay idle until the Boyraz Multicharacter UI triggers the player load event. Create a new character to verify the flow works correctly.
Maintenance
If you update your es_extended or qbx_core resources to a newer version, these manual changes may be overwritten. Keep a record of this step and reapply after framework updates.