Uso

Las tres ventanas#

Job Management tiene tres interfaces, y conviene saber cuál es cuál desde el principio:

Ojo con los nombres: /boss abre el panel de administración, no el menú del jefe. El menú del jefe no tiene comando por defecto — se abre en la zona del jefe. Configura bossCommand o bossKey para que un jefe pueda abrirlo desde cualquier lugar.

Los seis accesos están en Config.Interactions. Pon cualquiera de ellos en nil para desactivarlo. Las teclas son ids de control de GTA — 166 es F5, 167 es F6.

Cómo llegan los trabajos a la lista#

Nunca registras trabajos a mano. Job Management escucha a tu framework: cada vez que se asigna un trabajo a un jugador — en un centro de empleo, por otro script, por un comando de administrador o simplemente al conectarse — ese trabajo se añade a su lista con su rango. Un ascenso hecho en otro lugar actualiza el rango guardado de la misma forma.

• unemployed nunca se guarda.

• Config.MaxJobs (5) limita la lista. Un jugador que recibe un trabajo por encima del límite ve You have reached the maximum number of jobs y vuelve a quedar desempleado — primero debe dejar un trabajo.

• Config.BlackListedJobs oculta un trabajo del menú — prisoner por defecto. Se sigue guardando; simplemente nunca aparece como tarjeta.

• Los trabajos que no están en Config.Jobs siguen funcionando, con su nombre interno y un icono de interrogación. Añádelos para tener etiqueta, icono, insignias y panel de administración.

Definir trabajos#

Config.Jobs es la lista de trabajos que gestiona el servidor. La clave es el nombre del trabajo en tu framework; icon es una clase de Boxicons; las insignias son opcionales y usan las imágenes incluidas medal-1 a medal-8.

Config.Jobs = {
    police = {
        label  = "Police",
        icon   = "bx bx-shield-alt-2",
        badges = {
            { name = "Special Operations", description = "Elite tactical unit with advanced training", image = "medal-1" },
            { name = "Elite Unit",         description = "Highly trained members of the police force",   image = "medal-2" },
        },
    },
    taxi = { label = "Taxi Driver", icon = "bx bx-taxi" },
}

Solo los trabajos de Config.Jobs aparecen en el panel de administración, pueden tener jefe y pueden usar el chat del trabajo y los anuncios. Incluye catorce trabajos: policía, EMS, mecánico y los once trabajos de Quasar.

Restringir por licencia#

Config.UseByLicense limita el multijob a jugadores elegidos. Las licencias de la lista conservan Config.MaxJobs; todos los demás quedan limitados a NoLicenseUserMaxJobs y reciben el mensaje You are not allowed to use this feature al escribir /job.

Config.UseByLicense         = true
Config.AllowedLicenses      = {
    "license:a1e7d9c3f5b8a2d6e4c0f7b1d9a5e3c8f2d6b4a1",
}
Config.NoLicenseUserMaxJobs = 1

El menú de trabajos#

/job muestra cada trabajo del jugador como una tarjeta, con el trabajo activo primero. Config.Position decide si se abre a la derecha o a la izquierda.

Cambio de trabajo y turnos#

Select job activa ese trabajo: el trabajo del framework pasa a ser ese, con el rango guardado del jugador. Fuera de turno significa desempleado. End shift pone el trabajo del framework en unemployed, y Start shift restaura el trabajo. Cualquier script que lea el trabajo del jugador — dispatch, garajes, tiendas, cerraduras de puertas — lo ve desempleado mientras está fuera de turno. Dejar el trabajo activo también saca al jugador del turno.

Las horas trabajadas se cuentan desde Start shift hasta End shift — o hasta que el jugador se desconecta — y se guardan cada diez minutos.

Niveles y XP#

Los recursos de trabajo de Quasar guardan el nivel y la experiencia de cada trabajador en su propia tabla. Mientras un recurso está iniciado, su trabajo muestra una etiqueta de nivel y una barra de XP en la tarjeta, y el nivel de cada empleado en el menú del jefe; cuando está detenido, la tarjeta simplemente no los muestra. Los recursos y tablas compatibles se indican en Integraciones.

La barra de XP se calcula con Config.JobProgress, que debe coincidir con la curva del propio script del trabajo — la XP del nivel n es baseExperience × growthFactor^(n − 1):

Config.JobProgress = {
    miner = { baseExperience = 3500, growthFactor = 1.1 },
    taxi  = { baseExperience = 1000, growthFactor = 1.1 },
}

Jefes y zonas del jefe#

Cada trabajo tiene un jefe, asignado por un administrador: Admin panel → Jobs → the job → Boss → Set Boss junto a cualquier jugador conectado. El jefe tiene todos los permisos del menú del jefe, no puede ser despedido ni degradado desde él y puede renunciar con Resign. Un administrador puede quitar a un jefe en cualquier momento con Remove Boss.

En ESX, asignar un jefe también mueve a ese jugador al rango boss del trabajo — creado por encima de los rangos del trabajo si no existe. En QBCore y Qbox el jefe es solo una designación; su rango se mantiene igual.

La zona del jefe#

El menú del jefe se abre en un punto fijo por trabajo. Entra en su radio con ese trabajo activo y pulsa E en el aviso [E] Manage. La zona y su blip en el mapa solo existen para los jugadores que pueden abrirlo: el jefe, los rangos con Open Menu y los administradores.

Las zonas vienen de dos lugares, combinadas por nombre de trabajo. La configuración tiene las predeterminadas:

Config.BossLocations = {
    police = {
        coords = vector3(450.03, -973.97, 30.67),
        label  = "Police Department",
        radius = 3.0,
        blip   = { sprite = 60, color = 3, scale = 0.8, label = "Police HQ" },
    },
}

Y Admin panel → the job → Location coloca una en el juego: My Position rellena las coordenadas, y luego la etiqueta, el radio y el blip. Una zona colocada en el juego se guarda en data/bosslocations.json, se envía a todos los jugadores al instante y reemplaza la entrada de la configuración del mismo trabajo. Delete la elimina, y la zona de la configuración — si existe — vuelve.

El menú del jefe#

El menú se abre en la lista de empleados: todos los que tienen el trabajo, conectados o no, con su rango, si están de turno y desde hace cuánto, su nivel, insignias y ganancias. Los botones de arriba abren el resto — cada uno aparece solo si el rango de quien lo ve lo permite.

Rangos y permisos#

Ranks muestra los rangos del trabajo. Añade uno con una etiqueta y un salario, cámbiale el nombre, cambia su salario o elimínalo — todos los rangos menos el primero, 0. Cada rango tiene diez permisos:

Los permisos se guardan por trabajo y rango en data/jobpermissions.json; un rango nuevo empieza con todos desactivados. Nadie puede cambiar su propio rango ni despedirse a sí mismo.

Contratación#

Cada trabajo contrata en uno de dos modos, elegido por un administrador en Admin panel → the job → Boss → Hire Mode. Un menú del jefe abierto se actualiza en cuanto cambia.

Los contratos quedan en Contracts con su estado — pendiente, activo o rechazado — y se informa al jefe de la respuesta. Rescind despide al empleado, elimina el contrato y, si está conectado, le dice por qué.

El salario escrito en un contrato forma parte del documento. Lo que el empleado cobra realmente viene de su rango — consulta Salarios más abajo.

Los administradores también pueden añadir un trabajo directamente a un jugador, sin oferta: Admin panel → Players, el botón Add Job junto al jugador, y luego elige el trabajo. Se añade con el rango 0 sin cambiar el trabajo activo del jugador.

Despidos y renuncias#

Despedir pide un motivo, que va al registro de RR. HH. Un empleado conectado pierde el trabajo al instante, queda desempleado si era su trabajo activo y ve un aviso con el motivo. A un empleado desconectado se le quita de su lista, y su trabajo guardado en el framework se restablece si era ese. En ambos casos se borran sus estadísticas personales del trabajo.

Cuando un empleado deja el trabajo desde el menú de trabajos, se avisa al jefe — si está conectado.

La tesorería#

Cada trabajo tiene su propia tesorería, gestionada por Job Management y separada de cualquier cuenta de sociedad. Se llena con los pagos del trabajo: un recurso de trabajo que paga a sus trabajadores mediante AddJobMoney envía primero el dinero aquí, y el trabajador recibe el resto. Un pago de $1,000 con una comisión del 10% y un impuesto del 3%:

La comisión empieza en 1% para todos los trabajos, y los trabajadores ven su valor actual en sus estadísticas. El jefe la ajusta desde Treasury (0–100%); los administradores ajustan la comisión y el impuesto desde el panel de administración. El impuesto nunca afecta al pago del trabajador — solo reduce lo que llega a la tesorería, y nunca puede superar la comisión.

El dinero sale de la tesorería de dos formas: Pay employee — el jefe o un administrador paga en efectivo a un empleado conectado, con un motivo, registrado como bonificación en su informe — y los salarios pagados desde la tesorería. Los administradores pueden ingresar dinero con Add Funds. El libro de cuentas guarda los últimos 500 movimientos, con búsqueda.

Salarios#

Job Management paga sus propios salarios, por rango. Dos ajustes los ponen en marcha:

• Salary — un importe por rango, definido en Ranks.

• Pay every (min) y From treasury balance — en Treasury → Salary Settings. Pulsa Save: los salarios de un trabajo solo empiezan cuando se han guardado estos ajustes.

Cada minuto el servidor revisa cada trabajo. Cuando ha pasado su intervalo, cada empleado conectado cuyo rango tenga un importe cobra en efectivo — esté de turno o no — y ve una notificación Salary payment. Con From treasury balance activado, cada pago sale de la tesorería del trabajo y se omite mientras el saldo no alcance para cubrirlo; desactivado, el dinero lo pone el servidor.

Informes, sanciones y bonificaciones#

El icono de informe junto a un empleado abre su expediente de ese trabajo:

Cada lista guarda sus últimas 50 entradas, en data/playerreports.json.

Estadísticas#

Stats muestra tres cifras para esta semana, este mes y desde siempre: Earnings (lo que los trabajadores se llevaron mediante AddJobMoney), Treasury generated y Hours worked, incluidos los turnos en curso. El gráfico Peak Hours muestra a qué hora del día gana más el trabajo.

Las horas siguen el reloj del servidor. Las horas trabajadas se guardan cada diez minutos, así que un fallo cuesta como mucho diez minutos.

Chat y anuncios#

Chat del trabajo. El icono de chat en una tarjeta de trabajo abre una sala compartida por todos los que tienen ese trabajo — de turno o no. Los mensajes tienen hasta 200 caracteres, llevan el nombre y el rango del remitente, y el jefe aparece etiquetado. Los últimos 100 mensajes se conservan hasta que el recurso se reinicia.

Anuncios. El jefe — o un administrador desde el panel — escribe hasta 200 caracteres, y cada empleado conectado recibe un aviso a pantalla completa que cierra con Got it. Los anuncios se escriben en el registro de RR. HH.

El panel de administración#

/boss se abre en cuatro pestañas:

Dentro de un trabajo:

Crear y eliminar trabajos#

Manage Jobs → Create Job pide un nombre de trabajo (letras minúsculas, números y guiones bajos), un nombre visible, una fila por rango — cada una con sus propios permisos — y una zona del jefe, que es obligatoria; My Position la rellena. Delete Job elimina un trabajo y todos sus rangos.

Registros#

El archivo de configuración#

Todas las opciones de config/config.lua. Un cambio aquí requiere reiniciar el recurso.

Dónde se guardan los datos#

Estos valores están en archivos que el recurso mantiene en memoria. Edítalos solo con el servidor detenido y haz una copia de seguridad antes de cada actualización — Instalación muestra cómo restablecerlos.