Antes de empezar#
Antes de instalar Lifeguard Job, asegúrate de que tu servidor cumple los requisitos mínimos. Tres cosas son obligatorias; todo lo demás es opcional y se detecta por sí solo.
Requisito | Estado | Notas |
|---|---|---|
oxmysql | Obligatorio | Acceso a la base de datos. Las tablas se crean solas. |
ox_lib | Obligatorio | Callbacks del servidor y las barras de progreso cuando qs-interface no está en ejecución. |
Framework | Obligatorio | ESX, QBCore o Qbox — detectado automáticamente. El trabajo, el pago y los niveles pasan por él. |
Ropa | Opcional |
|
ox_target | Opcional | Solo con |
Llaves de vehículos | Opcional | Entrega al socorrista las llaves del ATV o la moto acuática que retira. Se admiten once scripts de cerraduras. |
Combustible | Opcional | Llena el depósito al retirarlo cuando |
qs-interface · qs-textui | Opcional | Las barras de progreso y los avisos en pantalla de Quasar, usados automáticamente cuando están en ejecución. |
qs-job-management | Opcional | Cuando está en ejecución, el pago de las llamadas pasa por Job Management + Multijob en lugar de ir directamente al efectivo del jugador. |
Todo lo específico del framework o de terceros está detrás de un pequeño archivo puente sin cifrar, y el recurso elige el correcto viendo lo que ya está en ejecución:
Capa | Detección |
|---|---|
Framework |
|
Llaves | qs-vehiclekeys · qb-vehiclekeys · qbx_vehiclekeys · wasabi_carlock · vehicles_keys · ti_vehicleKeys · xd_locksystem · mono_carkeys · glfp10_carkeys · fivecode_carkeys · F_RealCarKeysSystem |
Barras de progreso | qs-interface → ox_lib |
Avisos | ox_target (cuando está activado) → qs-textui → texto 3D nativo |
Pago | qs-job-management → el efectivo del framework |
Cada integración opcional se desactiva sin avisar. Si falta un script de cerraduras, el paso de las llaves no hace nada, y sin un target los avisos se dibujan en pantalla. Integraciones tiene los detalles y cómo añadir las tuyas.
github.comReleases · overextended/oxmysqlMySQL resource for FXServer.github.comReleases · overextended/ox_libA FiveM resource and script library for Lua and JS.Descargar Lifeguard Job#
Después de comprar Lifeguard Job, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en el CFX Portal con la misma cuenta usada al finalizar la compra, abre Granted Assets y descarga Lifeguard Job.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-lifeguard/
├── config/ -- what you may edit
├── client/framework/ -- framework bridges (editable)
├── client/vehiclekeys/ -- lock-script bridges (editable)
├── server/framework/ -- framework bridges (editable)
├── locales/ -- 18 languages
├── data/stats.json -- the statistics board
├── web/ -- the interface, ready to use
└── qs-Lifeguard.sql -- optional: the same schema, by handInstalar el recurso#
Mueve la carpeta qs-lifeguard al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-lifeguard/Una vez copiada, abre tu server.cfg y asegúrate de que cada dependencia — y todo lo que deba detectar — se inicie antes de Lifeguard Job:
ensure oxmysql
ensure ox_lib
# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Optional: target, keys, fuel, prompts, progress bars, job pay
ensure ox_target
ensure qs-vehiclekeys
ensure LegacyFuel
ensure qs-textui
ensure qs-interface
ensure qs-job-management
ensure qs-lifeguardEl orden de carga importa. La detección solo ve los recursos que ya están iniciados, así que un framework o un script de cerraduras que se inicie después de Lifeguard Job no se encuentra.
La base de datos#
No hay ningún archivo SQL que tengas que importar. Lifeguard Job crea lo que necesita en el primer inicio:
Tabla | Contiene |
|---|---|
| El nivel y la experiencia de cada socorrista — según el identificador de ESX, o según el citizen id en QBCore y Qbox, así que cada personaje sube de nivel por su cuenta. |
| Cada ajuste guardado desde el panel de ajustes, una fila por ajuste. Borrar una fila devuelve ese ajuste al archivo de configuración. |
| Solo ESX. El trabajo |
El tablero de estadísticas se guarda en data/stats.json dentro del recurso, no en la base de datos, así que el servidor debe tener permiso para escribir en esa carpeta.
qs-Lifeguard.sqlhace exactamente el mismo trabajo a mano, para preparar una base de datos fuera del servidor. Cada sentencia en él esIF NOT EXISTSoINSERT IGNORE, así que importarlo sobre una instalación en marcha no cambia nada.
Registrar el trabajo#
De serie, solo los jugadores con el trabajo lifeguard pueden trabajar en la playa. ESX guarda sus trabajos en la base de datos, así que se hace por ti; QBCore y Qbox los guardan en un archivo, así que añádelo ahí una vez:
Nada que hacer. El trabajo y su grado se escriben en jobs y job_grades en el primer inicio. Reinicia el servidor una vez después para que ESX cargue el nuevo trabajo y luego asígnalo como siempre:
/setjob <id> lifeguard 0Añade el trabajo a qb-core/shared/jobs.lua, reinicia y luego /setjob <id> lifeguard 0:
['lifeguard'] = {
label = 'Lifeguard',
defaultDuty = true,
offDutyPay = false,
grades = {
['0'] = { name = 'Lifeguard', payment = 10 },
},
},Añade el trabajo a qbx_core/shared/jobs.lua, reinicia y luego /setjob <id> lifeguard 0:
['lifeguard'] = {
label = 'Lifeguard',
defaultDuty = true,
offDutyPay = false,
grades = {
[0] = { name = 'Lifeguard', payment = 10 },
},
},¿Prefieres que cualquiera pueda trabajar como socorrista? Establece Config.RequireJob = false. ¿Usas un trabajo con otro nombre, o varios? Enuméralos en Config.LifeguardJob:
Config.RequireJob = true
Config.LifeguardJob = { ['lifeguard'] = true, ['beachpatrol'] = true }Obtener el acceso de administrador#
El panel de ajustes (/lifeguardadmin) está protegido por el ACE command.lifeguard, que se comprueba en el servidor al abrir el panel y de nuevo en cada botón dentro de él. Casi todos los server.cfg ya conceden todo el espacio command a los administradores, así que un administrador existente normalmente tiene acceso sin configurar nada:
# Already in most configs — grants every command, this one included
add_ace group.admin command allow
# Or grant only the lifeguard panel
add_ace group.admin command.lifeguard allow
add_principal identifier.fivem:1234567 group.adminEl ACE y el nombre del comando están ambos en Config.AdminPanel, donde el panel también se puede desactivar por completo.
Configurar el recurso#
Todo está en config/ y locales/, y casi todo también se puede cambiar en el juego desde el panel de ajustes:
Archivo | Contenido |
|---|---|
| Quién puede trabajar, target o avisos, idioma, moneda, el interruptor del uniforme, las tres estaciones, el capitán, blips y marcador, vehículos y su pago, combustible, las rutas de patrulla, la curva de experiencia, el panel de ajustes, debug y los logs de Discord. |
| Cada llamada — categoría, nivel, ruta, pago, experiencia, límite de tiempo y dónde ocurre — además de la probabilidad de una llamada por nivel, los pesos de las categorías y los tres rescates cooperativos. |
| El uniforme, para personajes masculinos y femeninos. |
| Cada línea de texto en pantalla, incluidos los nombres de las estaciones y la guía del trabajo. |
| El texto de ayuda del panel de ajustes, generado a partir de los comentarios de los dos archivos de configuración. No está pensado para editarse. |
Los valores que conviene revisar primero:
Config.Language = 'en' -- en · es · pt · fr · de · it · nl · ro · da · hu · tr · ru · bg · ar · hi · ja · ko · zh-CN
Config.RequireJob = true -- false lets anyone work as a lifeguard
Config.Target = false -- true = ox_target, false = walk up and press E
Config.Clothing = true -- put the uniform on when a shift starts
Config.CurrencyPosition = 'prefix' -- $500, or 'suffix' for 500 $
Config.Fuel = false -- true fills the tank on sign-out
Config.FuelExport = exports['LegacyFuel']
Config.AdminPanel = {
Enabled = true,
Ace = 'command.lifeguard',
ConfigCommand = 'lifeguardadmin',
}Un ajuste guardado desde el panel tiene prioridad sobre el archivo. Los archivos de configuración siguen siendo los valores por defecto; todo lo que se cambia en el juego se guarda en
qs_lifeguard_configy se aplica encima en cada inicio. Si editasconfig.luay nada cambia, probablemente ese ajuste se guardó desde el panel — reviértelo ahí y vuelve el valor del archivo.
Verificar la instalación#
Después de completar la instalación, reinicia tu servidor y observa la consola. Un inicio limpio no muestra nada en rojo; con Config.Debug = true el script explica cada paso que da, en la consola del servidor y en la consola del cliente (F8). Luego entra con el trabajo y completa el primer ciclo:
Visita una estación
Tres blips de Lifeguard Station se encuentran a lo largo de Vespucci Beach. Acércate al capitán bajo el marcador azul y pulsa
E: la cámara pasa a él y se abre el panel de la estación.Empieza una patrulla
Elige la patrulla Land, el ATV Blazer, y pulsa Start Mission. Estás de servicio, con uniforme, en el asiento — y el primer punto de control está en tu mapa.
Responde a una llamada
Ve de punto de control en punto de control. En el nivel 1, cada uno tiene un 40% de probabilidad de generar una llamada; complétala y el pago y la experiencia llegan al instante.
Abre el panel de ajustes
/lifeguardadminabre todos los ajustes del trabajo. Desde ahí, Uso cubre todo lo que pueden hacer un socorrista y un administrador.
Los ajustes guardados desde el panel surten efecto en el próximo reinicio del recurso, no al instante — el panel lo sigue indicando hasta que lo hagas. Reiniciarlo termina todos los turnos en curso, así que elige un momento tranquilo.