Configuration
Customize character slots, locations, camera angles, and spawn points for the Boyraz Multicharacter system.
Customizing your server's entry experience is done entirely via the Customize.lua and Compatibility.lua files. The system is designed to be highly flexible.
Configuration Files
Global Settings
All settings below are configured in Customize.lua.
Locale
Sets the UI language for the multicharacter interface.
Prop
Type
Framework
Defines the server framework. Leave as nil for auto-detection (recommended).
Framework = nil -- Auto-detect (recommended)
-- or: "ESX", "QBCore", "Qbox"Default Slots
Set the default number of character slots available for standard players:
defaultNumberOfCharacters = 5Per-Player Overrides
Assign specific slot counts via player license2 identifiers:
playersNumberOfCharacters = {
["license2:abc123"] = 10, -- VIP player
["license2:def456"] = 8, -- Donator
}Tip: Use this to reward VIP or donator players with additional character slots.
Character Selection Scene
The locations table determines where the ped and camera are positioned during the character selection screen. You can add multiple locations for a dynamic experience.
locations = {
{
-- The exact coordinates and heading for the character model
pedCoords = vec4(-1004.5, -478.51, 50.03, 28.19),
-- The cinematic camera angle looking at the character
camCoords = vec4(-1006.36, -476.19, 50.50, 210.38),
},
}Multiple Locations: Add more entries to the table for a randomized cinematic experience each time a player opens character selection.
Spawn Points
This section only applies if you are using the Boyraz Spawn Selector alongside the Multicharacter system.
Define your world entry points using coordinates and FontAwesome icons:
Locations = {
{
icon = 'fa-solid fa-city',
name = 'Legion Square',
coords = vec4(195.17, -933.77, 29.7, 144.5)
}
}Design Tip: Use modern FontAwesome classes or link custom .svg paths to match your server's unique aesthetic.