Rollback Controller

The tow_controller item pairs with a compatible rollback by vehicle plate. Pairing is stored on the individual item's metadata, so it survives resource and server restarts and follows the controller when it is transferred to another player.

#Install the Item

1. Copy the tow_controller definition from zyke_towing/extras/items/ox_inventory.txt or zyke_towing/extras/items/qb-core.txt into the inventory provider configured through zyke_lib.
2. For another supported inventory, create an equivalent usable item named tow_controller and keep it non-stackable/unique. Each controller needs its own metadata.
3. Copy zyke_towing/extras/items/images/tow_controller.png into the inventory's image directory.
4. Restart the inventory and zyke_towing so the definition and usable-item registration are loaded.

The controller is not consumed when it is paired or used.

#Pair a Controller

1. Sit inside a configured rollback vehicle with a tow_controller in your inventory.
2. Use the controller from your inventory.
3. Wait for the Controller paired confirmation.

Pairing requires Config.Settings.commandPermission and the access configured under Config.Settings.beds. It writes a unique controller ID and the vehicle's normalized plate to that exact item's metadata. Use the item inside another compatible rollback to replace its existing pairing.

Permission and bed-access checks apply when pairing. Afterward, anyone holding that exact paired controller can operate the rollback bed remotely.

#Operate the Rollback

1. Exit the vehicle and use the paired controller from your inventory.
2. Stay within 20 metres of the paired rollback.
3. Hold Up Arrow to raise the bed or Down Arrow to lower it. Release the key to stop movement.
4. Press X or use the controller item again to put it away.

The keys can be remapped in GTA / FiveM keybind settings. Walking remains available while the controller is equipped.

If the matching rollback is in the same routing bucket but more than 20 metres away, the controller remains equipped and its controls stay disabled until you return to range. Entering a vehicle, dying, changing routing bucket, or losing or moving the item from its inventory slot ends the remote session.

The controller selects the nearest compatible rollback with its saved plate. Plate matching ignores surrounding whitespace and letter case, so duplicate vehicle plates can make a controller operate a different matching rollback.

The controller's Up Arrow and Down Arrow inputs operate the bed hydraulics. Loading, unloading, and winching keep their normal interactions, proximity checks, and access rules. Seated bed controls remain available without a controller.