Uso

Las dos ventanas#

Job Center tiene dos interfaces, una para quienes buscan trabajo y otra para quienes contratan:

Ambas se cierran con ESC o la ✕ de la esquina superior.

El Job Center#

La cabecera muestra un recuento en vivo de active jobs: los jugadores conectados ahora mismo que trabajan en uno de los trabajos ofertados. La barra lateral empieza con All Jobs y luego muestra cada categoría; al elegir una, se filtran las tarjetas.

Una tarjeta muestra la imagen de la oferta con su insignia de estado y su icono, el título, la descripción y el salario. Una insignia roja en una tarjeta cuenta los mensajes que ese empleador le ha enviado al jugador. Haz clic en una tarjeta para ver los detalles:

Postularse a un trabajo#

El applyType de cada oferta decide qué hace Apply for Job:

hasChatbox y applyType son independientes: un trabajo instantáneo puede mostrar igualmente el botón de chat, para que el jugador pregunte antes de aceptarlo. Real Estate Agent y Tow Truck Operator vienen así de serie.

El servidor comprueba el tipo. Una contratación instantánea solicitada para una oferta que no es "instant" se trata como un exploit, y el jugador es expulsado con Attempted to exploit job hiring system.

El chat#

Cada jugador tiene una conversación por oferta. El solicitante escribe desde el Job Center; los jefes de ese trabajo leen y responden desde el panel de jefe.

• En vivo en ambas direcciones. Se notifica a todos los jefes conectados — New message in <job> (n unread) — y el hilo se actualiza en su panel. Se notifica al solicitante con New reply from <job> (n unread) y la respuesta aparece en su chat abierto.

• Los solicitantes desconectados se ponen al día. Una respuesta enviada mientras el solicitante no está se le anuncia en su siguiente inicio de sesión, y la tarjeta lleva una insignia hasta que abre el chat.

• Anti-spam. Cinco segundos entre mensajes, por remitente. La ventana muestra Please wait before sending another message y el servidor ignora todo lo que llegue más rápido.

• Nombres. Los jugadores conectados aparecen con el nombre de su personaje. Un solicitante desconectado aparece como Applicant más el inicio de su identificador; un jefe desconectado aparece como Boss.

Los chats viven en la memoria del servidor. Reiniciar el recurso o el servidor los borra — consulta La base de datos.

El panel de jefe#

Se abre con /jobchats (Config.BossCommand) o usando la tablet de jefe (Config.BossItem). Cada uno tiene su propio interruptor, Config.UseBossCommand y Config.UseBossItem.

Lista a los solicitantes del trabajo que tienes, bajo el título de ese trabajo: su nombre, el inicio de su último mensaje y, mientras no esté leído, el número de mensajes. Haz clic en uno para abrir el hilo — se marca como leído para ti, y cada jefe mantiene su propio estado de lectura.

La ✕ de un solicitante cierra la solicitud: el hilo se elimina para ambas partes, y ese jugador puede volver a postularse desde cero.

Quién es jefe#

bossGrades de cada oferta indica los grados que pueden abrir el panel de ese trabajo:

bossGrades = {3, 4}   -- grades 3 and 4 of this job, and nobody else

• Es una lista exacta, no un mínimo. {3} no deja entrar al grado 4. Incluye cada grado que deba tener acceso.

• Solo cuenta el trabajo actual. Un jugador con otro trabajo — o con este trabajo en otro grado — recibe You don't have access to this command del comando y You can't use this item de la tablet.

• Los grados se numeran como los numera tu framework. ESX y QBCore cuentan desde 0, el rango más bajo.

Escribir una oferta#

Cada oferta es una entrada en Config.Jobs, en shared/config.lua. La clave es el nombre del trabajo en tu framework — el nombre que asigna una contratación instantánea, y el nombre con el que se compara el trabajo de un jugador para el acceso de jefe.

Config.Jobs = {
    police = {                                   -- the framework's job name
        title       = 'Police Officer',
        company     = 'Los Santos Police Department',
        icon        = 'fas fa-shield-alt',
        image       = 'https://images.unsplash.com/photo-1568515387631-8b650bbcdb90?w=600&h=300&fit=crop',
        salary      = '$4,500 - $6,200',
        status      = 'High Demand',
        category    = 'emergency',               -- a key of Config.JobCategories
        description = 'Maintain law and order throughout the city.',
        requirements = { 'Clean criminal record', "Valid driver's license" },
        benefits     = { 'Pension plan', 'Health insurance' },
        location    = 'Mission Row Police Station',
        coords      = vector3(428.23, -984.28, 30.71),
        hasChatbox  = true,
        bossGrades  = {3, 4},
        applyType   = 'chatbox',                 -- 'instant' · 'chatbox' · 'link' · 'hobby'
        -- applyLink = 'https://discord.gg/yourserver',   -- for 'link'
    },
}

El texto de una oferta se muestra exactamente como está escrito — no se traduce mediante locales/. Escribe tus ofertas en el idioma de tu servidor.

Categorías#

Config.JobCategories = {
    emergency = { label = 'Emergency Services', icon = 'fas fa-ambulance' },
    business  = { label = 'Business & Finance', icon = 'fas fa-building' },
    -- the key is what a listing's category points to
}

Vienen diez de serie — emergency, business, transport, service, entertainment, industrial, legal, medical, criminal y food. Una categoría sin ofertas muestra No jobs available in this category.

Qué viene de serie#

24 ofertas, listas para editar o eliminar:

Haz coincidir las claves con tu framework. El paramédico viene como ems y el taxista como taxidriver, mientras que ESX y QBCore estándar llaman a esos trabajos ambulance y taxi. Una clave que tu framework no conoce sigue apareciendo en el Job Center, pero no puede contratar a nadie y nadie es su jefe.

El empleado y el blip#

Config.JobCenterPed = {
    model  = 'a_f_y_business_01',
    coords = vector4(-268.95, -956.13, 31.22, 204.35),  -- x, y, z, heading
    label  = 'Open Job Center',
}

Config.JobCenterBlip = {
    enabled    = true,
    coords     = vector3(-268.95, -956.13, 31.22),      -- keep it on the clerk
    sprite     = 407,
    color      = 3,
    scale      = 0.8,
    name       = 'Job Center',
    shortRange = true,                                  -- on the radar only when nearby
}

El empleado está congelado en su sitio, no puede recibir daño e ignora lo que ocurre a su alrededor. Toma coords donde esté un jugador — los pies del empleado quedan un metro por debajo de z — y usa el cuarto valor para orientarlo hacia la calle. label es el texto de la opción de target y del aviso.

El blip tiene sus propias coords: mueve ambos cuando muevas al empleado, o establece enabled = false para que el Job Center no aparezca en el mapa.