Ramps/Trailers

Troubleshooting

Troubleshooting

Common issues

Messages are quoted in Spanish, as they appear in game.

Symptom Fix
suty-rampas doesn't start: dependency suty-rampas-assets missing Both folders must be in resources, with ensure suty-rampas-assets before ensure suty-rampas.
The server says «You lack the required entitlement to use suty-rampas-assets» Your server's key doesn't have both resources. Check them on your Cfx.re portal and open a ticket if one is missing.
Console: no se encontró qbx_core, qb-core ni es_extended Start your framework before suty-rampas, or check Config.Framework.
Using an item does nothing on ox_inventory The entry needs client = { export = 'suty-rampas.useKit' } or 'suty-rampas.useTrailer', and the folder must be named exactly suty-rampas. Restart ox_inventory after adding the items.
Using an item does nothing on qb-inventory The entry needs useable = true. Do a full server restart after editing qb-core/shared/items.lua.
The item is gone with no trailer on the ground (ox_inventory) Leave consume = 0 on all four items: the script takes the item, not ox_inventory.
«Esta pickup no tiene rampas configuradas» That model has no ramps yet. Set it up with /rampasghost (Commands).
«Acércate a una pickup estacionada» The pickup has to be stopped, within 6 m of the player.
«Esa pickup ya tiene las rampas de otro jugador» One set per pickup. Whoever placed them has to pick them up.
«No tienes espacio en el inventario para el kit de rampas» Make room first. The ramps stay on the pickup until the kit fits.
No E prompt behind the ramps Line the vehicle up and stop. It has to be within Config.AutoLoad.distance (6 m), facing the pickup, and be a bike or a quad. Cars only load on the 7x16 trailer.
«Primero descarga el que está detrás» Unload the vehicle behind that one first.
«No hay espacio en el remolque para este vehículo» The trailer is full for that kind of cargo. A car goes alone on the 7x16.
«Este vehículo no cabe entre los rieles del remolque» That car is too wide for the 7x16.
A vehicle sits wrong on the bed Adjust it with /ajustaratv and it's saved for that truck and vehicle model.
The trailer's outline stays red The text at the bottom says why: the ground is too steep (placing.maxSlope) or uneven, or something is in the way.
«Ese remolque no es tuyo» Only whoever placed it can store it. To let anyone do it, set placing.anyoneStores = true.
Guardar remolque doesn't show The trailer must be empty, unhitched, stopped, with the gate shut and nobody on it.
«Trailer muy pesado, baja el vehículo primero» A loaded trailer can't be carried. Unload it, or back a pickup up to it and use Enganchar a la pickup with the eye.
«Esa pickup no tiene bola de enganche» That vehicle's model has no attach_female bone, so it can't tow.
«Ponte detrás de la pickup, del lado izquierdo de la bola» Stand on the ring behind the ball while holding the trailer.
Subir jetski doesn't show On land the trailer must be unhitched, with the jetski behind it, its bow within 6 m and lined up. An addon jetski may need jetskiModels (Configuration).
An addon jetski sits wrong on the trailer Fit it with /ajustarjetski (Commands).
An admin gets «Ese comando es solo para administradores» The ACE is missing: add_ace group.admin admin allow, and that player must be in group.admin.
/creartrailer, /rampasreporte and the like say the command doesn't exist They only exist with debug = true in config/trailer.lua.
Saved layouts don't reach another server Make suty-rampas/data writable. With debug = true the console says no se pudo escribir when it can't save there.
Trailers stop loading after restarting suty-rampas-assets Players need to reconnect after that resource restarts. Restarting suty-rampas alone is fine.
Item images are missing Copy them from install/, renaming ramp_kit.png to suty_ramp_kit.png (Installation).

Verifying the install

  1. Console: the server prints [suty-rampas] framework: <name>, inventario: <name>.
  2. Items: the four items show in your inventory with their images.
  3. Ramps: set up a pickup with /rampasghost, then use the kit on it.
  4. Trailer: use suty_trailer_5x8, place it and store it again with the eye.

Reporting a bug

  1. Set debug = true in config/trailer.lua and restart suty-rampas.
  2. Look at the server console at start. The [rampas-debug][arranque] lines give the version, any dependency that's off, the framework and inventory it found, and any missing item. Many install problems show up right there.
  3. Join the game and repeat what fails. Right after, run /rampasreporte as an admin: it writes the state of everything around you to F8 and the clipboard.
  4. Open a ticket on Discord with the [rampas-debug] lines from both sides, what you did and what you expected:
    • Server console: txAdmin → Live Console, or the server window.
    • F8 of the player who had the problem: also saved in %LocalAppData%\FiveM\FiveM.app\logs\ (the newest CitizenFX_log).
  5. Set debug = false again.

With debug on you can see every event, every server answer and why something was refused, every notice the player got, and every error with its traceback. The lines include player names and citizen IDs: check them before posting them anywhere public.

Merry Christmas.

From Suty.