Todo se ajusta en shared/config.lua. Las ubicaciones, el contenido de la pantalla de carga y las nacionalidades están en la carpeta data. Reinicia el recurso después de cada cambio.

General

Opción	Tipo	Por defecto	Qué hace
debug	boolean	false	Muestra mensajes de depuración en la consola
ui.accent	string	configurable	Color de acento de la interfaz y de la pantalla de carga, en hexadecimal
hud	function	vacía	Se llama con false cuando la selección se abre y con true cuando se cierra. Úsala para ocultar y mostrar tu HUD. El minimapa se oculta sin ella

shared/config.lua

hud = function(visible)
    exports.mi_hud:setVisible(visible)
end,

Personajes

Opción	Tipo	Por defecto	Qué hace
characters.slots	number	3	Personajes que puede tener cualquier jugador
characters.maxSlots	number	10	Tope absoluto. Ningún rol ni ID de usuario lo supera
characters.allowDelete	boolean	true	true deja a los jugadores borrar sus propios personajes

Huecos por Discord

Da más personajes a roles o usuarios concretos de Discord.

Opción	Tipo	Por defecto	Qué hace
discordSlots.enabled	boolean	false	true activa los huecos extra por rol y por ID de usuario
discordSlots.roles	lista	vacía	Entradas { id = 'ID_DEL_ROL', slots = N }. Necesita las convars del bot
discordSlots.users	tabla	vacía	Entradas ['ID_DE_USUARIO_DE_DISCORD'] = N. Funciona sin el bot
discordSlots.cacheMinutes	number	10	Minutos que se recuerdan los roles de un jugador antes de volver a pedirlos a Discord
discordSlots.timeoutMs	number	4000	Milisegundos de espera a Discord. Si no contesta, el jugador se queda con los huecos base

Cómo se calcula el número final:

• slots en un rol o en un usuario es el número total de personajes, no una suma.
• Si un jugador coincide con varias entradas, gana el número más alto.
• El resultado nunca baja de characters.slots ni pasa de characters.maxSlots.
• El jugador necesita Discord vinculado a FiveM. Sin él, recibe los huecos base.

El token del bot y el ID del servidor son convars, no opciones del config. Mira Instalación.

Registro

Opción	Tipo	Por defecto	Qué hace
register.name.min / max	number	2 / 32	Longitud permitida del nombre y del apellido
register.dob.format	string	"DD-MM-YYYY"	Formato de fecha: DD-MM-YYYY, YYYY-MM-DD o MM-DD-YYYY
register.dob.minYear	number	1950	Año de nacimiento más antiguo aceptado
register.minAge	number	18	Edad mínima de un personaje adulto
register.height.enabled	boolean	true	Muestra el campo de estatura
register.height.min / max	number	150 / 200	Rango de estatura en cm
register.backstory.enabled	boolean	true	Muestra el campo de historia
register.backstory.min / max	number	10 / 300	Longitud permitida de la historia

La lista de nacionalidades está en data/nationalities.lua.

Personajes menores

Un menor se crea como solicitud. El jugador elige a los progenitores y escribe una motivación, y el staff la aprueba o la rechaza. Hasta que se aprueba, no se puede jugar con el personaje.

Opción	Tipo	Por defecto	Qué hace
family.enabled	boolean	true	Activa los personajes menores
family.minAge / maxAge	number	6 / 17	Rango de edad de un menor
family.motivation.min / max	number	30 / 600	Longitud permitida de la motivación
family.height.min	number	100	Estatura mínima de un menor en cm
family.height.max	tabla	male = 168, female = 158	Estatura máxima según el género
family.adultHeight	tabla	male = 182, female = 170	Estatura adulta de referencia. El personaje se escala como su estatura dividida entre este valor
family.growthCommand	string	"height"	Comando con el que el menor cambia su estatura. false lo quita
family.scaleRadius	number	60.0	Distancia en metros dentro de la cual se ve a los demás jugadores escalados
family.rejectCooldownHours	number	24	Horas de espera tras un rechazo antes de enviar otra solicitud. 0 lo desactiva
family.allowOwnParent	boolean	false	true permite elegir como progenitores a personajes de la propia cuenta
family.maxPending	number	1	Solicitudes pendientes permitidas por jugador

Las solicitudes se revisan mediante los exports.

Aparición

Opción	Tipo	Por defecto	Qué hace
spawn.newCharacter	vec4	—	Dónde se coloca un personaje nuevo mientras se abre el creador de apariencia
spawn.birth	vec4	—	Dónde aparece un personaje nuevo al salir del creador. false omite este traslado
spawn.registerPreview	vec4	—	Dónde se muestra el personaje durante la creación
spawn.registerReference	vec4	—	Dónde se coloca la referencia adulta al ajustar la estatura de un menor
spawn.fallback	vec4	—	Se usa cuando un personaje no tiene posición guardada o no hay ubicación disponible
spawn.apartments	string / boolean	"auto"	"auto" usa apartamentos iniciales si qbx_properties está en marcha y el framework los tiene activados. true / false lo fuerza. Con apartamentos se omiten el creador de apariencia y el traslado a spawn.birth

Los personajes que ya existen aparecen siempre en su última posición guardada.

Escena

Opción	Tipo	Por defecto	Qué hace
scene.randomLocation	boolean	true	true elige una ubicación al azar cada vez. false usa siempre la primera de la lista
scene.emotes	lista	texting, idle3, smoke2	Comandos de emote que se reproducen al azar cuando la ubicación no tiene emote propio. Necesita cuxial_emotes
scene.fallbackScenario	string	"WORLD_HUMAN_STAND_MOBILE"	Escenario que se usa cuando cuxial_emotes no está en marcha
scene.posture	string	"side"	"side" respeta la orientación de la ubicación. "front" gira al personaje hacia la cámara
scene.depthOfField	boolean	true	Desenfoque del fondo. El jugador puede quitarlo con el modo FPS
scene.cameraDistance	number	2	Distancia de cámara por defecto: 1 cerca, 2 lejos

Ubicaciones

data/locations.lua contiene los lugares donde se muestran los personajes.

data/locations.lua

{ label = 'Rockford Hills', coords = vec4(-852.73, -226.99, 61.02, 354.04) },

{
    label = 'Comisaría',
    coords = vec4(444.37, -984.33, 30.69, 71.35),
    groups = { 'police' },
    emote = { scenario = 'WORLD_HUMAN_COP_IDLES' },
},

Campo	Qué hace
label	Nombre de la ubicación
coords	Posición y orientación del personaje
groups	Nombres de trabajo o banda. La ubicación solo se usa con personajes que pertenezcan a alguno, y esos personajes solo reciben ubicaciones de su grupo
emote	{ command = '...' } para un emote o { scenario = '...' } para un escenario de GTA
camera	front (por defecto), back, close o free
cameraCoords, fov, focusOffset, blur	Posición y óptica de la cámara, solo con camera = 'free'. cameraCoords es obligatorio en ese modo
scene	'bar' reproduce la animación de apoyarse con los props definidos en data/scenes.lua

data/vehicle_locations.lua contiene los puntos que se usan cuando el personaje posa con un vehículo. data/scenes.lua contiene las animaciones de las escenas de barra, pareja, mejor amigo y vehículo.

Carné, vehículos y pareja

Opción	Tipo	Por defecto	Qué hace
idCard.enabled	boolean	true	Muestra el carné real mientras se crea el personaje
idCard.resource	string	"cuxial_license"	Recurso que aporta el carné
idCard.item	string	"id_card"	Objeto cuyo carné se usa
idCard.cardId	string	nil	ID de un carné concreto. nil lo deduce del objeto
vehicles.enabled	boolean	true	Deja al jugador elegir un vehículo propio para la escena
vehicles.resource	string	"cuxial_garages"	Recurso que tiene que estar en marcha para esta función
vehicles.spotCommand	string / boolean	false	Nombre de un comando que copia tu vec4 actual al portapapeles, para rellenar data/vehicle_locations.lua
partner.enabled	boolean	true	Activa las escenas de pareja y de mejor amigo
partner.maxDistance	number	10.0	Distancia máxima en metros para invitar a alguien
partner.inviteSeconds	number	60	Segundos que dura abierta una invitación
partner.invitesPerMinute	number	3	Invitaciones que puede enviar un jugador por minuto
partner.commands.invite	string	"partnerinvite"	Nombre del comando de invitación
partner.commands.force	tabla	forcepartner, group.admin	name y restricted (permiso) del comando de staff

Mundo

Clima y hora que se ven en la selección. Cada jugador puede cambiarlos en sus ajustes.

Opción	Tipo	Por defecto	Qué hace
world.enabled	boolean	true	false no toca el clima ni la hora del servidor
world.weather	string	"XMAS"	Tipo de clima de GTA
world.hour / minute	number	23 / 30	Hora del día

Pantalla de carga y música

Opción	Tipo	Por defecto	Qué hace
loading.enabled	boolean	true	false cierra la pantalla de carga nada más empezar
loading.autoEnter	boolean	false	true entra a la selección sin el botón de comenzar
loading.handoffMs	number	2400	Duración de la transición hacia la selección, en milisegundos
loading.timeoutMs	number	60000	Límite de seguridad en milisegundos. La pantalla de carga se cierra si la transición no llega
loading.debug	boolean	false	Salida de depuración de la pantalla de carga
music.enabled	boolean	true	Música en la pantalla de carga y en la selección
music.file	string	""	Ruta dentro de web/build de la pista que se usa cuando data/loading.lua no tiene lista de pistas
music.scale	number	0.35	Multiplicador de volumen sobre el volumen que elige el jugador
music.analyse	boolean	true	Hace que la interfaz reaccione al ritmo

El contenido se edita en data/loading.lua:

Campo	Qué hace
background.video	Archivo de vídeo dentro de web/build, o una URL. Vacío por defecto: sin vídeo, fondo oscuro con partículas
background.dim, blur	Oscurecido (de 0 a 1) y desenfoque del vídeo
background.loop, startAt	Repetir el vídeo y segundo en el que empieza
background.sound	'auto' detecta si el vídeo tiene sonido. true / false lo fuerza
background.title, artist	Se muestran en el reproductor cuando el sonido es el del vídeo
tipSeconds	Segundos que cada consejo permanece en pantalla
tracks	Lista de reproducción: { id, url, title, artist }. Vacía por defecto: sin música
tips	Consejos: { id, category, title, text }
keys	Guía de teclas: { id, keys, label, category, description }

El paquete no incluye vídeo ni música. Pon tus archivos en web/build/video y web/build/music, creando las carpetas si faltan, y añádelos en data/loading.lua. Usa vídeo .webm y audio .ogg.

Objetos iniciales, comandos y registros

Opción	Tipo	Por defecto	Qué hace
starterItems	lista	phone, id_card, driver_license	{ item, amount }. identity = true rellena el objeto con el nombre, la fecha de nacimiento y la nacionalidad del personaje. metadata fija metadatos propios
commands.logout	tabla	logout, group.admin	name y restricted (permiso) del comando. restricted = false lo abre a todos
commands.logoutPlayer	tabla	logoutplayer, group.admin	name y restricted (permiso) del comando
logs.enabled	boolean	true	Envía registros a Discord cuando la convar del webhook está definida
logs.convar	string	"cuxial_multichar_webhook"	Nombre de la convar que guarda el webhook
logs.username	string	"Multicharacter"	Nombre que muestra el webhook

Cambios habituales

discordSlots = {
    enabled = true,
    roles = {
        { id = '123456789012345678', slots = 5 },
    },
},