Documentation

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.