Tow Truck with WINCH
Documentation relating to the kd_towtruck.
1. Installation
Tow Truck with WINCH is a standalone script. So you don't need a specific framework to use it. It's also mean it works with all framework (Esx, QBCore, VRP, DRP, …).
- Drag and drop this 3 resources in your resources folder
- kd_custom_native
- kd_hud-event
- kd_towtruck
- Add this 3 ensures in your server.cfg
ensure kd_custom-native
ensure kd_hud-event
ensure kd_towtruck
- Congratulation, the Tow Truck with WINCH script is ready to be use !
2. Usage
By default, the script is configured to work with a custom flatbed : flatbed3
. Use your admin menu (or other scripts) to spawn it.
A help message with key will appears at the top left of your screen every time action is available. Please read them to know what keys are usable.
- Enter the truck to lower the bed. Wait the bed is fully down to get out of the truck.
- Go to the top of bed to take the winch.
- Go to the front of the car you want to tow to attach the winch.
- Go near the rear wheel of tow truck to roll up the winch
- If you need to detach the winch, go back to the front of car and take the winch. You can store it by go back to the top of bed.
- Once the car on the bed. You have the possibility to attach the car on it. Go near the rear wheel of the truck to have this option. It will automatically store the winch if you didn't do it before.
- Enter the truck to upper the bed.
3. Config.lua
Config = {}
-- Display helpfull information to setup a new truck
Config.Debug = false
-- Max length of the winch
Config.MaxLengthRope = 19.0
-- Can push the car with rope ? (unrealistic but useful to get off the vehicle of the bed)
Config.pushWithRope = true
-- Duration to synchronize the rope between players
Config.ResyncRopeFrenquency = 10000 --ms
-- Keys
Config.DefaultKeys = {
tow = "j",
winch = "h",
unwind = "g"
}
-- Model name of the hook object
Config.HookModel = 'prop_rope_hook_01'
-- List of truck available for this script (you can add more)
Config.ValidModel = {
-- Copy this array to add vehicle.
[`flatbed3`] = {
-- Set bedUp & bedDown to 0 if you don't need to move the bed to use the winch
referenceBone = "bodyshell", --optional, by default: bodyshell
--referenceBone <-> attachVehBone is the distance to define if the bed is up or down
bedUp = 3.7, -- Distance between bodyshell bone and attachVehBone when the bed is up
bedDown = 8.1, -- Distance between bodyshell bone and attachVehBone when the bed is down
ropeBone = "misc_b", -- Bone where the rope is attached
ropeOffset = vector3(0, 0, 0.3), -- offset from ropeBone to adjust the position of the rope
ropeDistancetake = 1.5, -- Max distance to take the winch
attachVehBone = "misc_a", -- Bone where the vehicle is attached
attachLocationOffset = vector3(0.0, 0.0, 0.0), --optional: offset from the attachVehBone bone
attachOffset = vector4(0.0, 0.0, 0.0, 0.0) -- for the vehicle location when attach (w value is the tilt)
},
[`slamtruck`] = {
bedUp = 0,
bedDown = 0,
ropeBone = "bodyshell",
ropeOffset = vector3(0.0, 0.7, 0.5),
ropeDistancetake = 1.5,
attachVehBone = "bodyshell",
attachOffset = vector4(0, 0.0, 0.0, 10.0)
},
}
4. Add a new vehicle
All tow trucks with movable bed are compatible with the script.
To add it, just copy the flatbed3
array in the Config.ValidModel variable and change the modelname. Sometime, you will have to change the configuration of the vehicle to make it more usable.
Video Tutorial
Written tutorial
1. Preparation
- Spawn the truck you want to configure (example:
lgc9
flatbed). - Open the script's
overwriteConfig.lua
file.
2. Enable Debug Mode
- Add
Config.Debug = true
into theoverwriteConfig.lua
file. - This will show useful markers and values in-game to help with setup.
3. Add Your Vehicle to the script's configuration
- Add the default value into the
overwriteConfig.lua
file
[`lgc9`] = {
referenceBone = "bodyshell", -- Reference bone
ropeBone = "misc_bone", -- Bone where the rope is attached
attachVehBone = "misc_attach", -- Bone where the vehicle is attached
bedUp = 0.0, -- Distance between bodyshell bone and attachVehBone when the bed is up
bedDown = 30.0, -- Distance between bodyshell bone and attachVehBone when the bed is down
bedSpeed = 0.3, -- Speed of the bed movement 0.0 <> 1.0
ropeOffset = vector3(0, 0, 0.0), -- offset from ropeBone to adjust the position of the rope
ropeDistancetake = 1.5, -- Max distance to take the winch
attachLocationOffset = vector3(0.0, 0.0, 0.0), --optional: offset from the attachVehBone bone
attachOffset = vector4(0.0, 0.0, 0.0, 0.0) -- for the vehicle location when attach (w value is the tilt)
},
4. Set the bones values
- Restart the script with the server command:
ensure kd_towtruck
. - In-game, you can see the vehicle's bones by aiming at it with right-click while standing outside.
- Define the
referenceBone
: Use a bone at the front of the truck (like "engine"). - Define the
ropeBone
: Use a bone near the winch reel. - Define the
attachVehBone
: The bone must be attached to the bed and follow its movement.
5. Define the bedUp value
- Restart the script
- Go inside the truck
- Be sure the bed is at its normal position.
- (If not, respawn the truck)
- Get the
bedUp/bedDown
value displayed above the bed when the bed is at its normal position. - Increase it by 0.01.
- Example:
bedUp/bedDown: 3.229874923
. UsebedUp = 3.24
6. Define the bedDown value
- Restart the script
- Stay inside the truck
- Use the
Config.DefaultKeys.tow
key (J by default) to lower the bed. - Get the new
bedUp/bedDown
value displayed above the bed. - (If the bed doesn't move enough, increase the default value of bedDown)
- Decrease it by 0.01.
- Example:
bedUp/bedDown: 7.78729384
. UsebedDown = 7.77
Done ! You can restart the script and test the bed movement. It should move right from the start to the end. If not, adjust the bedUp
and bedDown
values.
You can adjust the bed movement speed by edit the bedSpeed
value
5. Configure Rope and Attachment Points
- Exit the truck — debug markers will show up.
- Use the
ropeOffset
to fine-tune the position of the rope. - Use the
attachLocationOffset
to fine-tune the position of the attachment — it should align with the surface of the bed.
6. Test Your Setup
To tow a vehicle:
- Spawn the truck.
- Go inside the vehicle.
- Press
J
to lower the bed. - Go to the winch reel location.
- Press
E
to take the rope. - Go near the vehicle you want tow.
- Press
E
to attach the rope. - Go near the truck's rear wheels.
- Press
H
to wind the winch and release when the vehicle is on the truck. - Press
E
to attach the vehicle to the bed.- If the
E
prompt is not show, reduce yourbedDown
value. The prompt is only displayed when the bed is fully down.
- If the
- Go inside the truck.
- Press
J
to upper the bed. - Done, the vehicle is towed!
To untow a vehicle:
- Go inside the vehicle.
- Press
J
to lower the bed. - Go near the truck's rear wheels.
- Press
E
to detach the vehicle. - Go to the winch reel location.
- Press
E
to take the rope. - Go near the vehicle.
- Press
E
to attach the rope. - Go near the truck's rear wheels.
- Press
G
to unwind the rope and releaseG
when the vehicle is fully off. - Go near the vehicle.
- Press
E
to take the rope. - Go to the winch reel location.
- Press
E
to store the rope. - Go inside the vehicle.
- Press
J
to upper the bed. - Done, the vehicle is untowed!
7. Finalize
- Once everything is working think to Disable the debug mode by setting
Config.Debug = false
.
5. For developer
You can turn off the script for a specific player by using this client event
TriggerClientEvent('kd_towtruck:CanUse', source, false)
You can turn on the script again with the same client event
TriggerClientEvent('kd_towtruck:CanUse', source, true)
You can overwrite the notification function by added these functions in the overwriteConfig.lua
file:
---@param texts table
---Warning : Execute every frame
function Config.DisplayHelp(texts)
for _, text in pairs(texts) do
print(text)
end
end
---@param text string the content of the notification
---@param color integer the color of the notification
function Config.Notif(text, color)
print(text, color)
end
6. Some Towtrucks configuration
cortowmfd4
Config.ValidModel[`cortowmfd4`] = {
bedUp = 1.901,
bedDown = 6.0,
ropeBone = "attach_male",
ropeDistancetake = 1.5,
attachVehBone = "misc_z",
}
lgc19flatbed
Config.ValidModel[`lgc19flatbed`] = {
bedUp = 3.235,
bedDown = 7.7,
ropeBone = "misc_b",
ropeDistancetake = 1.5,
attachVehBone = "misc_a",
}
20ramrbc
Config.ValidModel[`20ramrbc`] = {
bedUp = 4.449,
bedDown = 6.87,
ropeBone = "attach_male",
ropeDistancetake = 1.5,
attachVehBone = "misc_z",
}
c3navistar
Config.ValidModel[`c3navistar`] = {
bedUp = 4.603,
bedDown = 9.8,
ropeBone = "misc_a",
ropeOffset = vector3(0.0, 0.0, -0.2),
ropeDistancetake = 1.5,
attachVehBone = "misc_b",
}
BFGWBerg
Config.ValidModel[`BFGWBerg`] = {
bedUp = 2.31,
bedDown = 6.45,
ropeBone = "misc_b",
ropeOffset = vector3(-0.20, 0.00, 0.0),
ropeDistancetake = 1.3,
attachVehBone = "misc_a",
}
Mercedes Atego
Config.ValidModel[`flatbed4`] = {
referenceBone = "misc_d",
bedUp = 1.92,
bedDown = 6.310,
ropeBone = "misc_b",
ropeOffset = vector3(0, -0.9, -0.1),
ropeDistancetake = 1.5,
attachVehBone = "misc_b",
attachLocationOffset = vector3(0.0, -3.0, -1.0),
}