Documentation

Resource Description

How the grinder, discs, batteries, pressure cut, and Hardware Supplier work.

#The Grinder

Using the anglegrinder item takes it out or puts it away. Every nearby player sees the held grinder, and its model follows the fitted disc and battery, including broken-disc and battery-less variants. The inventory icon changes the same way.

Taking the grinder out holsters a drawn weapon, and no weapon can be drawn while it is held. Dying or getting into a vehicle puts it away. A new grinder, including one bought from the vendor, comes with the disc and battery set under starterItems.

#Discs & Batteries

Discs come in three tiers. The pro disc lasts twice as long as the standard disc and the elite disc four times as long. Each disc keeps its own durability, so a disc ejected halfway returns with what it has left. A spent disc returns as its broken item.

The battery is detachable and rechargeable. It drains a little on every grind, and the grinder will not run without a charged battery fitted. The battery mechanic can be turned off entirely.

#Pressure Cut

Every grind is a pressure cut by default. Players hold a key to push the disc into the material and keep a needle inside a wandering zone. The cut only advances inside the zone. Outside it, the disc keeps wearing several times faster. A golden band in the middle of the zone cuts faster. Clean play wears only the base amount. zyke_lib skill checks and progress bars can replace it.

#Presentation

A grind walks the player into position, crouches them when the animation calls for it, and plays a work animation with a cinematic close-up camera. Sparks fly from the disc edge and follow the cutting pressure, and the motor sound follows the pressure through Sounds. Each grind ends with a spin-down, during which the grinder cannot be put away and the player cannot enter a vehicle.

#Interest Points

While the grinder is out, everything a supported resource lets it cut is marked with a dot. Aiming at a dot within reach shows the use key on it, and pressing the use key cuts that point. A press with no dot aimed at is left to other resources on the same key.

#Witnesses

Each integration decides whether its grind is legal. During an illegal grind, NPCs within hearing range notice it, and NPCs and drivers further out need to see it. The first witnessed grind of a session calls a single editable hook where you connect your dispatch resource.

#Hardware Supplier

The vendor ped sells the grinder, discs, and batteries. He buys back broken discs at a flat price and used discs by their durability, and recharges carried batteries for a flat price. The menu stays open after each trade, with stock and prices updated.

#Language & Logging

Text follows each player's chosen language through zyke_lib. Grinding, wear, and equip actions are server-authoritative, with server events, Discord webhook logging, and editable can-check hooks.