Common Issues
Checks for fitting, snow handling, saving and props.
#Using the Item Does Nothing
Check that zyke_lib and your inventory have loaded and that the item exists with the name in Config.Settings.items.chain. For ox_inventory, leave consume unset on the item so the framework's usable-item callback runs.
Use the item on foot. Using it again, or pressing X, puts the chain away. With Config.Settings.jobs set, only those jobs may take a chain out. Check your can-check hooks too.
#No Wheel Markers Show
Markers only show within fitting.markerDistance of a wheel, on vehicles that aren't in blockedClasses or blockedModels. Motorcycles, cycles, boats, aircraft, trains and open wheel vehicles are blocked by default. Wheels that already have a chain show the remove option instead.
#The Fit Won't Finish
The vehicle has to stand still, and you must stay within fitting.reach of the hub. Pull with A and D in turn: pulling with the same hand twice, or stopping for fitting.slipAfter seconds, slips the chain back one pull. Press Space once the chain is round to tighten it. Someone else working on the same wheel also blocks it.
#Roads Aren't Slippery
Snow handling applies only in the weathers listed in snow.weathers, or on the ground materials in snow.surfaces. If your weather script has no snow weather, use /snowroads on or the SetSnowOverride export. Check that handling.enabled is true.
#Chains Disappear After a Garage or Restart
Check that saving.enabled is true. With saving.ownedOnly, only vehicles a player owns are kept, so spawned or job vehicles lose their chains. Chains are kept by plate, so a garage that changes the plate won't get them back.
#Another Script Resets the Handling
Handling scripts that write traction or brake force directly still work: Snow Chains takes the new value as the base and puts the snow change back on top within a quarter of a second. To stack cleanly, use the handling exports in Exports & Events.
#Clients Crash After a Restart
Restarting zyke_snowchains_assets while chains are out can crash clients that still show the props. Restart zyke_snowchains instead, which is safe.
#A Chain Doesn't Sit Right on a Tyre
Some models report a tyre size that doesn't match the visible tyre. Add the model to Config.WheelOverrides with a radius, width or offset adjustment.