qb-flatbed

🛻 Flatbed Towing System

A lightweight, smooth, and fully configurable towing system designed for flatbed vehicles. Players can tow nearby vehicles, attach them to a flatbed, transport them, and release them safely.

---

📁 Configuration File

This system uses a single config file containing all tow settings, offsets, notifications, and allowed vehicle models. config

---

🌍 Localization

Below are all in-game messages shown to players:

Key	Message
notify_control_fail	Failed to obtain vehicle control.
notify_towed	Vehicle has been towed.
notify_no_vehicle	No vehicle on the flatbed.
notify_released	Vehicle released.
notify_must_be_in_vehicle	You must be inside a vehicle (inside the flatbed truck).
notify_not_flatbed	This vehicle is not a flatbed. Add its model to Config.FlatbedModels.
notify_already_towing	You are already towing a vehicle.
notify_no_target_found	No vehicle found nearby to tow.
notify_cannot_tow_self	You cannot tow your own vehicle.
notify_tow_failed	Towing failed.
notify_no_attached	There is no attached vehicle to release.
notify_must_stop	You must stop the flatbed before performing this action.
notify_action_canceled	Action canceled.
notify_progress_attach	Attaching vehicle…
notify_progress_release	Releasing vehicle…

---

🚚 Flatbed Models

Only vehicles listed here are treated as flatbeds:

Config.FlatbedModels = {"flatbed"}

You can add more:

Config.FlatbedModels = {"flatbed", "flatbed3", "mycustomflatbed"}

---

📏 Towing Distance

Maximum distance from which a vehicle can be attached:

Config.MaxTowDistance = 10.0

Players must be within 10 units of the target vehicle to tow it.

---

🔗 Attach Position Offset

These values determine where the towed vehicle is placed on the flatbed:

Config.AttachOffset = {
    x = 0.0, y = -3.0, z = 1.0,
    rx = 0.0, ry = 0.0, rz = 0.0
}

• x, y, z → Position relative to flatbed

• rx, ry, rz → Rotation relative to flatbed

---

📤 Drop Offset

These values determine where the vehicle is placed when released:

Config.DropOffset = {
    x = 0.0, y = -10.0, z = 0.0,
    rx = 0.0, ry = 0.0, rz = 0.0
}

When dropped, the vehicle appears 10 units behind the flatbed.

---

🎮 Gameplay Flow

1️⃣ Be in a Flatbed

Player must be inside a vehicle whose model exists in Config.FlatbedModels.

2️⃣ Look at a Vehicle to Tow

The system checks for a valid vehicle within the tow radius.

3️⃣ Attach Sequence

Displays the progress message:

Attaching vehicle…

If successful → vehicle is placed using AttachOffset.

4️⃣ Transport the Vehicle

Drive freely with the attached vehicle secured.

5️⃣ Release Sequence

Displays:

Releasing vehicle… Vehicle appears behind the flatbed using DropOffset.

---

🧩 Customization Tips

🔧 Adjust Attach Position

To place the vehicle further forward/backward or at a different height:

• Increase/decrease y

• Adjust z for higher/lower placement

• Modify rz for angle correction

🚛 Add Custom Flatbeds

Just add model names to:

Config.FlatbedModels

📐 Modify Drop Behavior

Change DropOffset.y to control how far the released vehicle appears.