El comportamiento del script está en shared/config.lua. Las tarjetas no están en ningún archivo: se diseñan en el juego con /license. Reinicia el recurso después de cambiar el config.

General

Opción	Tipo	Por defecto	Qué hace
debug	boolean	false	true imprime una línea en la consola del servidor y del cliente cuando el script está listo.
paymentType	string	'cash'	Cuenta de la que se cobra en la oficina de licencias. 'cash' o 'bank'.
showRadius	number	5.0	Radio en metros. Los jugadores dentro de él ven la tarjeta que enseñas, y son los que aparecen como cercanos en los paneles de emisión y de verificación.

Staff · admin

Opción	Tipo	Por defecto	Qué hace
permission	string	'admin'	Permiso del framework necesario para ejecutar /license y para crear, editar y borrar diseños de tarjeta. Se comprueba a través de cuxial_bridge.

Trabajos · authorizedJobs y revokeJobs

Las dos son tablas de ['nombre del trabajo'] = grado mínimo. Las entradas que vienen en el archivo son ejemplos: cámbialas por los trabajos de tu servidor.

Opción	Tipo	Qué hace
authorizedJobs	table	Trabajos que pueden usar /jobissue y /checklicense, emitir tarjetas y leer el resultado de una verificación. El jugador necesita ese trabajo con el grado indicado o superior.
revokeJobs	table	Trabajos adicionales que pueden revocar y restaurar licencias. El staff y los trabajos de authorizedJobs ya pueden hacerlo.

shared/config.lua

authorizedJobs = {
    ['police'] = 2,
    ['ambulance'] = 3,
},

revokeJobs = {
    ['police'] = 4,
},

Oficina de licencias · zones

Una lista de oficinas. Cada una crea un NPC con una opción de target que abre la tienda. La tienda vende todas las tarjetas que tienen Cobrar dinero activado y no están restringidas a un trabajo.

Opción	Tipo	Qué hace
name	string	Nombre interno de la oficina.
coords	vector3	Posición del NPC.
heading	number	Dirección a la que mira el NPC. 0.0 si se omite.
model	string	Modelo de ped del NPC.
label	string	Texto de la opción de target.

La oficina del archivo es un ejemplo. Añade las que necesites, o deja la lista vacía para no tener ninguna y abrir la tienda desde tu propio recurso con openGetCard.

shared/config.lua

zones = {
    {
        name = 'city_hall',
        coords = vector3(-545.0, -204.0, 38.2),
        heading = 210.0,
        model = 's_m_m_highsec_01',
        label = 'Oficina de licencias',
    },
},

Estudio de fotos · photo

Durante la foto el jugador pasa al estudio, solo en su propia instancia, y vuelve a donde estaba al terminar.

Opción	Tipo	Por defecto	Qué hace
enabled	boolean	true	false apaga el estudio: no se mueve al jugador ni se crea la cámara.
camOffset	vector3	vector3(0.0, 0.7, 0.65)	Encuadre inicial. z es la altura, sobre la posición del jugador, del punto al que mira la cámara. y más 0.5 es la distancia inicial en metros.
fov	number	36.0	Campo de visión de la cámara. Valores más bajos acercan.
greenScreenPos	vector4	Estudio incluido	Dónde se coloca el jugador para la foto: x, y, z y orientación. El valor por defecto está dentro de la sala de fondo verde que viene con el script.
maxUploadSize	number	4000000	Tamaño máximo de la foto que el servidor acepta para subirla, en caracteres. Una imagen mayor se rechaza.
uploadCooldown	number	3	Segundos que un jugador debe esperar entre dos subidas de foto.

Cambia greenScreenPos solo si llevas la foto a una sala de fondo verde propia. El fondo se elimina por color, así que un sitio sin fondo verde da una foto con el escenario detrás.

Interfaz · theme

Opción	Tipo	Por defecto	Qué hace
color	string (hex)	configurable	Color de acento de todos los paneles.

Verificación de identidad · idCheck

Opción	Tipo	Por defecto	Qué hace
logo	string	'image/default.png'	Imagen que se muestra en el panel de verificación. Ruta relativa a la carpeta web/build del recurso.
title	string	'Los Santos Police Department'	Título del panel.
refreshInterval	number	3000	Milisegundos entre actualizaciones de la lista de jugadores cercanos mientras el panel está abierto.

Identificaciones falsas · fakeId

Opción	Tipo	Por defecto	Qué hace
enabled	boolean	true	false impide que el generador produzca tarjetas.
itemName	string	'fake_id'	Objeto que se entrega al jugador. Tiene que existir en tu inventario con export = 'cuxial_license.useFakeId'.

El panel de identificaciones falsas no tiene comando ni NPC. Ábrelo desde tu propio recurso con openFakeId, por ejemplo desde un lugar escondido o un objeto.

Opciones de tarjeta en el diseñador

Cada diseño lleva sus propias opciones, que se ajustan en el último paso del diseñador (/license):

Opción	Qué hace
Restringir Tarjeta a Trabajo	Saca la tarjeta de la oficina de licencias. Solo se puede emitir a mano.
Cobrar dinero e importe	Pone la tarjeta a la venta en la oficina de licencias por ese precio.
Nombre del item	Objeto de inventario que se entrega con esta tarjeta. Vacío = license_card. El diseñador muestra la definición del objeto lista para copiar.

Quién puede emitir una tarjeta lo decide authorizedJobs.

Borrar un diseño de tarjeta borra también todas las licencias emitidas con él. Los objetos siguen en los inventarios pero ya no muestran nada.

Cambios habituales

Cobrar del banco en vez de en efectivo

paymentType = 'bank',

Dejar que un rango más bajo emita tarjetas

authorizedJobs = {
    ['police'] = 1,
},

Apagar las identificaciones falsas

fakeId = {
    enabled = false,
    itemName = 'fake_id',
},