Trucker Job

Requisitos

Compatibilidad opcional

Se detecta si está arrancado. No hay que instalar nada.

Instalación

1. Descarga el script desde Keymaster → Granted Assets con la cuenta de Cfx.re que compró.
2. Copia la carpeta lt-trucker en resources/ sin cambiar el nombre (si usas FTP, en modo binario).
3. Añade al server.cfg, después de ox_lib, oxmysql y tu framework (abajo tienes el bloque de cada uno):

ensure ox_lib
ensure oxmysql
ensure qs-core   # qbx_core, qb-core o/or es_extended
ensure lt-trucker

Reinicia el servidor. Las tablas y un trabajo de ejemplo se crean solos: no hay SQL que importar. El framework se detecta solo; para forzarlo, pon Config.Framework a 'qs', 'qbx', 'qb' o 'esx'.

Según tu framework

En cualquier framework, esta línea da el creador a otro grupo (o a group.admin si tus admins no pueden abrirlo):

add_ace group.mod lt_trucker.admin allow

Quasar (qs-core)

qs-core va primero en la detección, aunque es_extended o qb-core corran como capas de compatibilidad. Con qs-banking, el pago sale también en el historial del banco (Config.BankHistory).

Qbox

⚠ Lista negra de vehículos. Qbox trae una lista en qbx_smallresources/qbx_entitiesblacklist/config.lua que incluye mule. Un camión de la lista aparece y desaparece al momento, la ruta termina y la consola muestra vehicle_lost. El camión por defecto es benson, que no está en la lista. Si tu trabajo usa mule:

• Recomendado: en Ajustes, cambia el modelo a benson, pounder o boxville y vuelve a pulsar Calibrar bodega.
• Mantener el mule: borra la línea [`MULE`] = true, de ese archivo y reinicia qbx_smallresources. Afecta a todo el servidor.

Pasa lo mismo con cualquier otro modelo que escribas en el creador: revisa antes esa lista.

ESX

No hay integración de llaves para ESX. El camión aparece abierto y sin necesidad de puentearlo, así que funciona sin llaves. Si tu script de llaves lo bloquea, añade su llamada en ClientBridge.giveKeys de bridge/client.lua.

Primeros pasos en el juego

1. Escribe /truckercreator y abre la pestaña Ajustes.
2. Coloca el NPC, la zona de retorno y el aparcamiento del camión.
3. Pulsa Calibrar bodega para tu camión. Así se alinean las cajas y las etiquetas.
4. En la pestaña Rutas, revisa las rutas de ejemplo o crea las tuyas.

El NPC y su blip solo aparecen cuando el trabajo se ha guardado en el creador y no falta nada. Hasta entonces, el trabajo de ejemplo queda oculto. La pestaña Rutas muestra lo que falta.

Cómo funciona el trabajo

1. Habla con el NPC y elige una ruta desbloqueada. Aparece el camión.
2. Sube al camión y sigue la ruta hasta el punto de recogida. Las cajas aparecen al llegar.
3. Si el trabajo tiene punto de etiquetas, recógelas ahí con E. Luego pulsa E en una caja, arrastra la etiqueta correcta sobre ella y ya se puede coger.
4. Coge una caja del suelo con E, llévala a la parte trasera del camión y pulsa E. La caja se desliza a su sitio.
5. Conduce hasta la parada y pulsa E en la parte trasera para abrir la vista de la carga.
6. Haz doble clic en una etiqueta verde. La caja se desliza hasta las puertas y a tus manos.
7. Llévala al marcador y pulsa E.
8. Tras la última caja de la parada, firma el albarán con el ratón. Se abre la siguiente parada.
9. Vuelve a la zona de retorno y pulsa E dentro del camión. El pago va al banco y se suma la XP.

Las cajas se cargan en orden fijo: la última parada entra primero, así que la primera queda junto a las puertas. La primera vez, una guía acompaña al jugador, con Continuar y Saltar (Config.Tutorial).

Grupos

Hasta 2 jugadores. El líder invita a un jugador cercano desde el panel del NPC y empieza la ruta. Los dos cargan, descargan y entregan a la vez, y cualquiera puede firmar y devolver el camión. Si el líder cancela, la ruta termina para los dos. Si el otro se va o se desconecta, la ruta sigue y la caja que llevaba vuelve a su sitio.

El creador

Hay un trabajo con un NPC y tantas rutas como necesites.

• Las cajas se reparten a partes iguales entre las paradas, salvo que indiques cuántas descarga cada una. La suma tiene que dar el total.
• Una parada con 2 cajas o más tiene un radio mayor (Config.Delivery.multiRadius).
• Al colocar un punto de carga, H cambia entre los props de la ruta; ese punto muestra primero ese prop.
• Un cambio de cooldown se aplica al momento: nadie espera más de lo que la ruta pide ahora.
• Un camión tiene sitio para 6 cajas estándar (Config.Limits.maxBoxes). Cada modelo ocupa su space en Config.BoxModels: caben 12 cajas pequeñas o 3 cajas grandes de madera.

Camiones ofrecidos: mule, benson, pounder, boxville y hauler con remolques trailers, trailers2 y trailers3 (Config.Trucks, Config.Trailers). En el creador puedes escribir cualquier otro modelo, incluidos los addon.

Calibrar bodega

Cada vehículo de GTA tiene un interior distinto y los addon el suyo, así que los valores de Config.Bays son solo estimaciones. Calibrar bodega crea una copia local del vehículo con la cámara real de la vista de la carga y dibuja la bodega y cada hueco de caja.

Deja la cámara detrás de las puertas pero por debajo del techo. Para un vehículo sin interior, Config.Cargo.shell.enabled = true pinta paredes sobre la vista. Todas las teclas se cambian en Config.Keys.

Pago y niveles

• Pago = payBase + lo que paga cada caja entregada, más un Config.LevelPayBonus % por cada nivel por encima de 1, por el porcentaje del vehículo. Por defecto, las cajas grandes pagan más y el vehículo paga el 60 %.
• XP = xpPerDelivery por caja entregada, más xpBonus por entregarlo todo.
• Niveles: siguen la curva de Config.Levels (hasta 50 por defecto).
• Grupos: por defecto el pago se reparte y cada jugador recibe la XP completa (Config.Group.payMode).

El pago va directo al banco, con aviso en qs-smartphone o lb-phone; sin móvil, el aviso sale en pantalla.

Comandos

Los dos nombres se cambian en Config.Command y Config.CancelCommand.

Sin target, se interactúa con la tecla E. Cada jugador puede cambiarla en Ajustes → Asignación de teclas → FiveM.

Configuración principal

config.lua está comentado por secciones. Haz restart lt-trucker después de editarlo. Lo que se guarda en el creador va a la base de datos y tiene prioridad sobre ese archivo.

Los textos están en locales/, no en config.lua. Para usar otros recursos (otro banco, móvil o llaves), adapta los archivos de bridge/.

Seguridad

El servidor controla todo el estado de la ruta: comprueba distancias, tiempos, orden de paradas, propiedad de las cajas y velocidad entre paradas, calcula el pago y la XP con los datos guardados y limita las peticiones por jugador. Cada petición del creador vuelve a comprobar el permiso.

Problemas comunes

Soporte

¿No lo resuelves? Abre un ticket en nuestro Discord con la versión del script, tu framework y el error completo de la consola.