Skip to main content

cold_multichar

cold_multichar es un selector multichar externo para FiveM con soporte real para qbox, qbcore y esx. El recurso abre una NUI propia al conectar, aisla al jugador mientras el selector esta activo, permite crear o cargar personaje, y entrega el control al flujo final de spawn cuando el login termina.

Mapa rapido​

Lo que hace de verdad el script​

  • Detecta framework en este orden cuando Config.Framework = 'auto': qbox, qbcore, esx.
  • Trabaja con un maximo real de 3 slots.
  • Usa apariencia guardada para el preview cuando puede; si no, cae a un freemode aleatorio.
  • Incluye intro, panel principal, preview de creacion, ajustes locales y selector cinematico de spawn.
  • Persiste slots extra en SQL y migra automaticamente un KVP legacy si lo encuentra.
  • Reabre el selector al hacer logout usando el evento nativo del framework activo.
  • Expone exports cliente y servidor para consultar o forzar el estado del multichar.

Puntos importantes antes de tocarlo​

  • La configuracion publica actual vive en shared/config.lua y usa Config.Slots, Config.Appearance, Config.Logout y Config.SpawnMode.
  • El codigo actual solo soporta estos modos de spawn:
    • cinematic_selector: abre el selector cinematico interno para elegir punto de spawn.
    • last_location: intenta reaparecer donde se desconecto ese personaje por ultima vez.
    • default: ignora la ultima posicion y usa siempre Config.DefaultSpawn.
  • No hay flujo de borrado de personaje en esta version.
  • cold_library no es obligatorio para arrancar, pero si no tienes un listener para cold_library:notify no veras las notificaciones del comando de slots.

Componentes principales​

  • shared/config.lua: opciones editables del recurso.
  • shared/config_internal.lua: defaults, compatibilidad legacy y normalizacion de config.
  • client/main.lua: NUI, camaras, preview, selector y flujo de spawn.
  • client/framework/*.lua: adaptadores cliente para qbox, qbcore y esx.
  • server/main.lua: slots extra, aislamiento por bucket, comandos, exports y callbacks.
  • server/framework/*.lua: login, logout, listado de personajes y preview por framework.
  • html/: interfaz NUI completa.

Resumen operativo​

  1. El cliente espera a que exista sesion de red y a que el framework este listo.
  2. Si el jugador no tiene personaje activo, abre el selector.
  3. El servidor lo mueve a un routing bucket aislado mientras la UI esta abierta.
  4. La NUI muestra intro, lista de slots, preview y acciones de crear o jugar.
  5. Tras crear o cargar personaje, el recurso resuelve el spawn final.
  6. El framework recupera el control y, si es personaje nuevo, puede abrir el creator configurado.

Orden recomendado de lectura​

  1. Dependencies
  2. Installation
  3. Configuration
  4. Character Flow
  5. Framework Integration
  6. Technical Reference
  7. FAQ