Trucker Job

RequisitosRequirements

Compatibilidad opcionalOptional compatibility

Se detecta si está arrancado. No hay que instalar nada.Detected when running. Nothing has to be installed.

InstalaciónInstallation

1. Descarga el script desde Keymaster → Granted Assets con la cuenta de Cfx.re que compró.Download the script from Keymaster → Granted Assets with the Cfx.re account that bought it.
2. Copia la carpeta lt-trucker en resources/ sin cambiar el nombre (si usas FTP, en modo binario).Copy the lt-trucker folder into resources/ without renaming it (if using FTP, binary mode).
3. Añade al server.cfg, después de ox_lib, oxmysql y tu framework (abajo tienes el bloque de cada uno):Add to server.cfg, after ox_lib, oxmysql and your framework (each framework's block is below):

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'.

Restart the server. Tables and a sample job are created automatically: there is no SQL to import. The framework is auto-detected; to force one, set Config.Framework to 'qs', 'qbx', 'qb' or 'esx'.

Según tu frameworkFramework setup

En cualquier framework, esta línea da el creador a otro grupo (o a group.admin si tus admins no pueden abrirlo):On any framework, this line gives the creator to another group (or to group.admin if your admins cannot open it):

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).

qs-core comes first in detection, even if es_extended or qb-core run as compatibility layers on top of it. With qs-banking, the pay also shows in the bank history (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:

⚠ Vehicle blacklist. Qbox ships with a list in qbx_smallresources/qbx_entitiesblacklist/config.lua that includes mule. A blacklisted truck spawns and vanishes at once, the route ends and the console prints vehicle_lost. The default truck is benson, which is not on the list. If your job uses mule:

• Recomendado: en Ajustes, cambia el modelo a benson, pounder o boxville y vuelve a pulsar Calibrar bodega.Recommended: in Settings, change the model to benson, pounder or boxville and press Calibrate bay again.
• Mantener el mule: borra la línea [`MULE`] = true, de ese archivo y reinicia qbx_smallresources. Afecta a todo el servidor.Keep the mule: remove the [`MULE`] = true, line from that file and restart qbx_smallresources. This applies to your whole server.

Pasa lo mismo con cualquier otro modelo que escribas en el creador: revisa antes esa lista.The same applies to any other model you type in the creator: check that list first.

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.

There is no vehicle key integration for ESX. The truck spawns unlocked and without hotwiring, so it works without keys. If your key script locks it, add its call to ClientBridge.giveKeys in bridge/client.lua.

Primeros pasos en el juegoFirst setup in game

1. Escribe /truckercreator y abre la pestaña Ajustes.Run /truckercreator and open the Settings tab.
2. Coloca el NPC, la zona de retorno y el aparcamiento del camión.Place the NPC, the return zone and the truck spawn.
3. Pulsa Calibrar bodega para tu camión. Así se alinean las cajas y las etiquetas.Press Calibrate bay for your truck. This lines up the boxes and the labels.
4. En la pestaña Rutas, revisa las rutas de ejemplo o crea las tuyas.In the Routes tab, check the sample routes or create your own.

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.

The NPC and its blip only appear once the job has been saved in the creator and nothing is missing. Until then, the sample job stays hidden. The Routes tab lists what is left.

Cómo funciona el trabajoHow the job works

1. Habla con el NPC y elige una ruta desbloqueada. Aparece el camión.Talk to the NPC and pick an unlocked route. The truck spawns.
2. Sube al camión y sigue la ruta hasta el punto de recogida. Las cajas aparecen al llegar.Get in the truck and follow the route to the pick-up point. The boxes appear when you arrive.
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.If the job has a label point, take the labels there with E. Then press E on a box, drag the right label onto it, and the box can be picked up.
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.Pick a box from the floor with E, carry it to the back of the truck and press E. The box slides into place.
5. Conduce hasta la parada y pulsa E en la parte trasera para abrir la vista de la carga.Drive to the stop and press E at the rear to open the cargo view.
6. Haz doble clic en una etiqueta verde. La caja se desliza hasta las puertas y a tus manos.Double click a green label. The box slides to the doors and into your hands.
7. Llévala al marcador y pulsa E.Carry it to the marker and press E.
8. Tras la última caja de la parada, firma el albarán con el ratón. Se abre la siguiente parada.After the last box of the stop, sign the bill of lading with the mouse. The next stop opens.
9. Vuelve a la zona de retorno y pulsa E dentro del camión. El pago va al banco y se suma la XP.Drive back to the return zone and press E inside the truck. The pay goes to the bank and the XP is added.

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).

Boxes load in a fixed order: the last stop goes in first, so the first stop ends up next to the doors. The first time, a guide walks the player through it, with Continue and Skip (Config.Tutorial).

GruposGroups

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.

Up to 2 players. The leader invites a nearby player from the NPC panel and starts the route. Both load, unload and deliver at the same time, and either can sign and return the truck. If the leader cancels, the route ends for both. If the other player leaves or disconnects, the route goes on and any box they were carrying goes back.

El creadorThe creator

Hay un trabajo con un NPC y tantas rutas como necesites.There is one job with one NPC, and as many routes as you need.

• 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.Boxes split evenly across the stops, unless you set how many each one unloads. The stops have to add up to the total.
• Una parada con 2 cajas o más tiene un radio mayor (Config.Delivery.multiRadius).A stop with 2 boxes or more gets a bigger radius (Config.Delivery.multiRadius).
• Al colocar un punto de carga, H cambia entre los props de la ruta; ese punto muestra primero ese prop.While placing a cargo location, H changes between the route's props; that point shows that prop first.
• Un cambio de cooldown se aplica al momento: nadie espera más de lo que la ruta pide ahora.A cooldown change applies at once: nobody waits longer than the route now asks for.
• 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.A truck has room for 6 standard boxes (Config.Limits.maxBoxes). Each model takes its space in Config.BoxModels: 12 small boxes fit, or 3 large wooden crates.

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.

Trucks offered: mule, benson, pounder, boxville and hauler with trailers, trailers2 and trailers3 (Config.Trucks, Config.Trailers). You can type any other model in the creator, addons included.

Calibrar bodegaCalibrate bay

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.

GTA vehicles have very different interiors and addons have their own, so the values in Config.Bays are only estimates. Calibrate bay spawns a local copy of the vehicle with the real camera of the cargo view, and draws the bay and every box place.

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.

Keep the camera behind the doors but under the roof. For a vehicle with no interior, Config.Cargo.shell.enabled = true paints walls over the view. All keys can be changed in Config.Keys.

Pago y nivelesPay and levels

• 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 %.Pay = payBase + what each delivered box pays, plus Config.LevelPayBonus % per level above 1, times the vehicle percentage. By default bigger boxes pay more, and the vehicle pays 60 %.
• XP = xpPerDelivery por caja entregada, más xpBonus por entregarlo todo.XP = xpPerDelivery per delivered box, plus xpBonus for delivering everything.
• Niveles: siguen la curva de Config.Levels (hasta 50 por defecto).Levels follow the curve in Config.Levels (up to 50 by default).
• Grupos: por defecto el pago se reparte y cada jugador recibe la XP completa (Config.Group.payMode).Groups: by default the pay is split and each player gets the full XP (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.

The pay goes straight to the bank, with a notice on qs-smartphone or lb-phone; without a phone, the notice shows on screen.

ComandosCommands

Los dos nombres se cambian enBoth names can be changed in Config.Command yand Config.CancelCommand.

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

Without a target, players interact with the E key. Each player can rebind it in Settings → Key Bindings → FiveM.

Configuración principalMain configuration

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.

config.lua is commented section by section. Run restart lt-trucker after editing it. What is saved in the creator goes to the database and overrides that file.

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/.

Visible text lives in locales/, not in config.lua. To use other resources (another bank, phone or keys), adapt the files in bridge/.

SeguridadSecurity

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.

The server owns all route state: it checks distances, times, stop order, box ownership and speed between stops, works out pay and XP from stored data, and limits requests per player. Every creator request checks the permission again.

Problemas comunesTroubleshooting

SoporteSupport

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

Still stuck? Open a ticket on our Discord with the script version, your framework and the full console error.