Documentation

Common Issues

Checks for items, equipping, cutting, the Hardware Supplier, sound, and alerts.

#Items or Icons Are Missing

Check the server console on start for Configured item '<name>' does not exist in your inventory, add it from extras/items. Copy the definitions from extras/items into the configured inventory and restart both resources. Copy every icon from extras/items/images/256/ as well, since the grinder's icon switches between them to show its disc and battery.

#Old grinder Items Stopped Working

Item names changed from grinder and grinder_* to anglegrinder and anglegrinder_*, and the resource does not migrate stored items. Rename them in your shops, other resources, and database, including the discItem and image metadata on grinders. See extras/items/README.md.

#Grinder Cannot Be Taken Out or Put Away

"You can't do that right now." means the player is dead or in a vehicle, and "You are already occupied." means another grinder action or a grind is running. "Your hands aren't free." comes from IsPlayerHandsBusy() or another resource's busy check, and "The disc is still spinning down." blocks putting it away for grinding.spinDown.seconds after a grind. Check CanEquipGrinder in the hooks.

#Pressing E Does Nothing

The use key only cuts a dot the player aims at within reach, so a resource that offers targets, such as zyke_wheelclamp, must be running and points.enabled must be true. Dots are hidden in vehicles and during other grinder actions, and need a clear line of sight. Run /grindexample to test the grinder on its own.

#Grind Will Not Start

The grinder needs a fitted, unbroken disc and a charged battery, or the player sees "No cutting disc is fitted.", "The fitted disc is broken, unload it first.", "No battery is attached.", or "The attached battery is dead." Fit parts with their items or the grinder menu on R; disc and battery items need the grinder out first, or show "Take the grinder out first." Check CanUseGrinderTool in the hooks.

#Disc or Battery Cannot Be Ejected

"You need more inventory space." means the returned part does not fit. A spent disc disappears instead when its brokenItem, or brokenDiscItem for the standard disc, is false or missing from your inventory.

#Grind Stops Partway

"You moved away, so grinding stopped." means the player moved more than grinding.moveTolerance, the target disappeared, or the work animation was interrupted. "The cutting disc broke.", "The grinder stopped, check its disc and battery.", and "You couldn't hold the zone and the cut stalled." mean the disc or battery ran out or the cut spent too long outside the zone. "You slipped and the cut failed." is a failed skill check. Wear for what was already ground still applies.

#Cannot Enter a Vehicle or Draw a Weapon

The disc spins down for grinding.spinDown.seconds after a grind, blocking vehicles while spinDown.blockVehicle is enabled. "You can't draw a weapon while holding the grinder." is expected; put the grinder away first.

#Hardware Supplier Cannot Be Used

The vendor's Browse option needs ox_target or qb-target, started before zyke_lib. A missing ped prints Failed to load vendor model '<model>' for vendor #<n> in F8. "The vendor is unavailable right now." means the player is more than 5 metres from coords, and "You can't afford that." means cash and bank both fall short.

#Battery Does Not Appear for Recharging

Batteries attached to the grinder or already full are not listed. Detach it from the grinder menu first.

#Grinding Is Silent

Start Sounds as zyke_sounds and check grinding.sound.enabled.

#No Police Alert

OnIllegalGrind in server/unlocked/hooks.lua is empty by default; add your dispatch call there. It only fires for illegal grinds, once per grind, when an NPC hears or sees it. Set witnesses.debug = true to see each check's result.

#Discord Logs Do Not Arrive

Copy extras/webhooks/anglegrinder.lua to zyke_lib/webhooks/anglegrinder.lua, set a URL for each action, and restart zyke_anglegrinder.

#Test Commands Are Refused

"You don't have permission to do this." means the player lacks the command ACE permission, which /grindexample, /grindtest, /grindpose, and /grindprop need.