Changelog | Zyke Resources Docs

Changelog - Version 0.5.0

Changelog - Version 0.4.2

Changelog - Version 0.4.1

Changelog - Version 0.4.0

#Changes

Added portable winches that mount to any vehicle and provide a reusable steel cable for towing.
- Install with the tow_winch item or permission-checked /tow_winch on a stationary vehicle, positioning it with the placement gizmo; limited to one per vehicle and requires solid mounting contact.
- Take the cable nearby with targeting or /tow_winch_use; the winch end stays attached so only the free end needs a bumper anchor before driving either vehicle to tow.
- Load a steel cable from inventory into an empty winch, then unload it with targeting or /tow_winch_unload leaving the winch mounted or take it directly into hand with a brief pickup animation; the drum shows loaded or empty and broken winches refuse handling.
- Remove the winch nearby with targeting or /tow_winch_remove to recover the winch and any loaded cable if you can carry them; animated removal requires staying nearby, is blocked while towing, and confirms success or failure.
- Steel cables work only from an installed winch while bumper-to-bumper towing uses rope.
- Detaching a winch tow keeps the free end in hand, and condition checks show winch and cable wear separately.
- Winch and cable wear only while the cable is taut and either vehicle moves, with heavier loads wearing faster; sudden hard pulls add extra wear, and depleting either part detaches the tow, consuming the cable, with a snapped-cable or broken-winch warning.
- Flatbed carriers include a built-in rear winch and cable that needs no item and cannot be loaded, unloaded, removed, or inspected, with no wear.
- Steel cable tows must start from the winch end, and reeling control follows that winch vehicle rather than the tow chain leader.
- Installed winches persist through garage parking, respawns, and restarts, with props hidden during garage handling without losing the installation.
- Short winch cables stay taut instead of going slack.
Fixed deleted flatbeds leaving bed motion state behind so guards, freezes, and prompts no longer stick, and rollback waits no longer stall while a carrier prompt is shown.

#Files Affected

Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.

client/locked/*
client/unlocked/can_checks.lua
server/locked/*
server/unlocked/can_checks.lua
server/unlocked/items.lua
shared/locked/*
shared/unlocked/config.lua
nui/*
README.md
extras/items/images/tow_winch.png
extras/items/images/tow_winch_empty.png
extras/items/ox_inventory.txt
extras/items/qb-core.txt
extras/portable-winch.md
extras/rollback_cable.md
locales/*
stream/zyke_winch.ydr
stream/zyke_winch.ytyp
stream/zyke_winch_empty.ydr
stream/zyke_winch_empty.ytyp
types/types.lua
fxmanifest.lua

#Config Changes

shared/unlocked/config.lua
- Added the full Config.Settings.beds.models table. Copy the entire table from the new config.
- Added the full Config.Settings.towing.mountedWinch table. Copy the entire table from the new config.

Changelog - Version 0.3.5

Changelog - Version 0.3.4

Changelog - Version 0.3.3

Changelog - Version 0.3.2

Changelog - Version 0.3.1

Changelog - Version 0.3.0

#Changes

Added rollback-bed towing.
- Supports the Freightliner M2 and Zyke Flatbed replacement/addon, with hydraulic or sliding-and-tilting beds. Vehicle assets are installed separately; the Zyke Flatbed integrations require their matching vehicle resource to be running.
- Hold Up Arrow or Down Arrow from the cab to raise or lower the bed. Releasing stops it partway, and changing direction works without releasing first. Secured cargo follows the moving bed.
- Manually connect a metal cable to either bumper and winch vehicles onto the deck, including rear-first loading. Fitting vehicles secure once aligned on the bed; oversized vehicles can still be pulled without automatically securing.
- Releasing the winch keeps the cable attached at its current length, allowing cable towing without loading the vehicle onto the deck. Lower the bed fully before winching secured cargo off.
- Untie a stopped cable from either end to recover the cable item. If your inventory cannot receive it, the cable stays attached.
- Controlled unloading helps vehicles roll off the deck, with restored tyre clearance and collision when the bed attachment releases.
- Bed operation from the cab applies a configurable driving-speed limit, defaulting to 30 km/h. Driving above 10 km/h with an unsecured cable load cuts the cable if the bed is insufficiently lowered; the default threshold is 80%, with a warning when it cuts.
- Zyke Flatbeds have a separate rear towing outlet that does not block bed operation. With the bed fully raised and stationary, winch controls prioritize an active ordinary tow.
- Bed travel, movement speed, winch behavior and vehicle-fit limits can be configured per model. Conventional carriers retain their menu-based loading workflow.
Added shareable, plate-paired towing controllers.
- Pair a controller inside a compatible rollback, then operate its bed and bed winch on foot within 20 metres. Pairing is stored on the item and survives restarts and vehicle respawns with the same plate.
- Lend the paired controller to another player so they can operate the bed without needing the original operator's towing permission or keys.
- The controller also operates the carrier's ordinary tow winch from outside, subject to towing permission and bed access. It has an in-hand prop and animations, and disconnects when taken out of range or lost.
Added trailer and cargo weight effects.
- Hitched trailers and vehicles secured to carrier beds reduce acceleration according to their combined weight, without counting nested loads twice or changing braking and collision handling.
- Configure the extra weight penalty and minimum available power, or disable the penalty. Existing vehicle handling and rope-pulling assistance remain part of the calculation.
- /tow_debug now shows trailer/cargo weight and its effect on engine power, including when no rope tow is active.
Changed the default winch controls: Page Up now reels in and Page Down pays out, for both ordinary towlines and rollback cables.
Carrier height checks now use sampled vehicle collision instead of counting decorative geometry such as antennas, reducing false “too tall” rejections.
Increased the TR2 carrier's supported vehicle width from 2.6 m to 2.9 m.
Added a final loading check to prevent attaching a vehicle that became occupied, unavailable or no longer controlled during the operation.
Tow winching now stops when an interface takes input focus, preventing it from continuing behind an open menu.
Extras templates and supporting files are now excluded from escrow encryption so they remain editable.

#Config Changes

In shared/unlocked/config.lua, add Config.Settings.towing.loadPhysics with massMultiplier = 0.3 and minimumPowerMultiplier = 0.2. Set massMultiplier to 0.0 to disable the extra weight penalty.
Add Config.Settings.beds.operatingSpeedKmh = 30.0 and Config.Settings.beds.cableCutLoweredPercent = 80.
Merge the new flatbedm2 and flatbed_zyke model entries and the updated flatbed entry, including their rollback, slot and rear-winch settings. The stock Flatbed integration now requires zyke_flatbed; the addon uses zyke_flatbed_addon.
Update the TR2 maxVehicleSize width to 2.9, keeping its existing length and height limits.
Add the new tow_controller inventory item and its image, and ensure the zyke_controller prop is available before using the remote.
Existing saved FiveM key bindings may override the new winch defaults; update them if Page Up and Page Down still behave as before.

Changelog - Version 0.2.0

#Changes

Added a personal settings menu with a modal UI for viewing and changing per-player towing settings, including slider and option-style settings with a command hint footer.
The UI now waits for loading to finish before rendering and warns after 10 seconds unless warnings are silenced.
Added configurable permissions to allow or deny using a tow rope by material, showing a custom denial message when provided and a generic message otherwise.
Added configurable permissions to allow or deny attaching a tow between specific vehicles, ends, and materials, also checked during target selection.
Added configurable permissions to allow or deny detaching an active tow.
Added configurable permissions to allow or deny winching a tow in or out, checked while winching is held; stopping the winch is always allowed.
Added configurable permissions to allow or deny loading, unloading, and repositioning vehicles in tow bed slots.
Added configurable permissions to allow or deny opening the tow bed menu for a carrier.
Missing tow rope denials now show the specific server-provided reason when available instead of always showing a generic message.

#Files Affected

Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.

client/locked/*
client/unlocked/can_checks.lua
client/unlocked/menus/personal_settings.lua
server/locked/*
server/unlocked/can_checks.lua
server/unlocked/items.lua
shared/locked/*
shared/unlocked/beds.lua
shared/unlocked/config.lua
shared/unlocked/functions.lua
shared/unlocked/loader.lua
nui/*
README.md
types/types.lua
fxmanifest.lua

#Config Changes

shared/unlocked/config.lua
- Added the full Config.Settings.beds table. Copy the entire table from the new config.
- Added the full Config.Settings.personalSettings table. Copy the entire table from the new config.
- Added the full Config.Settings.towing table. Copy the entire table from the new config.
- Added three new Config.Settings.personalSettings.settings entries:
  - winchMeterScale
  - winchMeterHideDelay
  - winchMeterAlwaysShow

Changelog - Version 0.1.0