Cuxial License & ID System
Licencias/IDs — creador visual de tarjetas, tienda, emisión con foto, escáner policial e ID falsa.
Resumen
Sistema de licencias / IDs con creador visual de tarjetas, tienda, emisión por trabajo, captura de foto y escáner policial (QBox · ESX · QBCore)
Sistema completo de documentos de identidad con NUI en Svelte 5 + TypeScript. Los administradores diseñan tarjetas desde un creador visual (asistente de 5 pasos) con previsualización en vivo y 4 orientaciones (horizontal, vertical, cuadrada y credencial tipo placa). Los ciudadanos compran carnets en una tienda con preview real, y los trabajos autorizados los emiten por rango capturando la foto del jugador con una cámara orbital sobre green-screen (recorte transparente + subida a Fivemanage). Incluye escáner de ID policial, generador de ID falsa, animación de mostrar el documento con prop en mano, y se integra automáticamente con cuxial_police para marcar ciudadanos en búsqueda y captura o peligrosos sobre la identificación. Multi-framework vía cuxial_bridge.
Requisitos
Requiere cuxial_bridge. Descárgalo e inícialo antes que este script (ver la doc del bridge). El bridge es lo que le da compatibilidad con QBox, ESX y QBCore.
Compatible con QBox, ESX y QBCore. No necesitas listar tu framework como dependencia: el bridge lo detecta y lo conecta por ti.
Asegúrate de tener estos recursos instalados e iniciados antes que el script:
Las dependencias opcionales (cuxial_police) añaden funciones extra pero no son obligatorias.
Instalación
- Instala cuxial_bridge si aún no lo tienes (ver su doc).
- Sube la carpeta cuxial_license a resources/[cuxial]/.
- Instala las dependencias listadas arriba.
- Añade los ensure a tu server.cfg respetando el orden.
- Reinicia el servidor por completo.
# Tu framework (QBox / ESX / QBCore) ya debe estar iniciado
ensure ox_lib
ensure oxmysql
# Núcleo de Cuxial — siempre antes que los scripts
ensure cuxial_bridge
ensure ox_inventory
ensure screencapture
# El script
ensure cuxial_licenseConfiguración
Toda la configuración editable está en texto plano (la lógica va protegida por Cfx.re Escrow). Edita estos ficheros para ajustar el script a tu servidor:
- shared/config.lua
- locales/
Protegido por Cfx.re Escrow — Compatible con QBox · ESX · QBCore (vía cuxial_bridge) — Requiere registrar los items en ox_inventory (license_card, fake_id, job_badge, worker_id) — Captura de foto vía screencapture + token de Fivemanage — Integración opcional con cuxial_police (overlay búsqueda y captura / peligroso, auto-detectada por GetResourceState) — shared/config.lua y locales/ abiertos y editables — Tabla SQL automática — Soporte por tickets en la web — Actualizaciones incluidas
Comandos
/licenseAbre el creador / gestión de tarjetas (admin)/jobissueAbre el panel de emisión por trabajo (trabajo autorizado)/checklicense [id]Abre el escáner con las licencias de un jugador (trabajo autorizado)exports openGetCard / openIdCheck / openFakeId / openJobManagerAbren la tienda, el escáner, la ID falsa o el gestor desde otros recursosCaracterísticas
- Creador visual de tarjetas — asistente de 5 pasos (orientación, colores, logo, campos, restricciones) con preview en vivo
- 4 orientaciones — horizontal, vertical, cuadrada y credencial (cartera tipo placa policial)
- NUI moderna en Svelte 5 + TypeScript con estilo folder, escala a 1080p · 2K · 4K
- Tienda de carnets (NUI) con preview real de cada tarjeta, multi-selección, total y cobro
- Emisión por trabajo y rango (manager) con captura de foto al jugador objetivo
- Captura de foto — cámara orbital suave, +60 expresiones faciales, poses/animaciones, hora del día y green-screen → fondo transparente (subida a Fivemanage)
- Escáner de ID policial — jugadores cercanos o búsqueda por CID, lista de licencias con estado válida/expirada
- Generador de ID falsa con campos, foto y logo personalizables
- Animación de mostrar documento con prop en mano (tarjeta o placa) y tecla E para guardar
- Display de la ID anclado en pantalla + mostrar a jugadores cercanos
- Integración con cuxial_police (auto-detectada) — overlay de Búsqueda y Captura / Peligroso sobre la identificación
- Revocar y restaurar licencias desde el panel de gestión
- Sin duplicados en BD — re-emitir una licencia actualiza la fila existente (upsert por tarjeta + ciudadano)
- 4 items de ox_inventory — license_card, fake_id, job_badge y worker_id con sus exports de uso
- Idiomas centralizados — origen único en el Lua (en/es); el Lua envía los textos a la NUI en runtime
- Tema de acento configurable + arquitectura modular (server/modules · client/modules) y build con carga diferida por sección
- Persistencia en DB con tablas creadas automáticamente — sin importar .sql a mano
Rendimiento
La NUI solo se activa al abrir un panel; tarjetas y locales cacheados; build con code-splitting (un chunk por sección)