Changelog
Released version and their changes.
#Changes
- Added support for displaying the resource in each player's chosen language.
- Grinder key prompts now use the
zyke_libkey panel, with minigame keys shown below the minigame card. - Fixed an unanswered server request leaving the grinder's unequip key locked.
- Fixed unanswered disc or battery requests blocking further grinder menu actions.
- Fixed held grinders being left behind when the resource stops.
- Fixed vendor prices not using
zyke_libcurrency formatting. - Fixed the grinder menu staying open after the tool is put away or lost, or the resource stops.
#Files Affected
Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.
- client/locked/*
- client/unlocked/examples.lua
- client/unlocked/keybinds.lua
- client/unlocked/menu.lua
- client/unlocked/vendors.lua
- nui/*
- README.md
- locales/*
- fxmanifest.lua
2026-11-11 20:58 CET
#Changes
- Added the
StartGrindclient export to run a complete grind and return whether it completed.- Integrations can configure grind behavior, tool wear, witness handling, approach and validity checks, camera settings, and resumed progress.
- Without an entity or coordinates, the grind targets a spot in front of the player.
- Stages, wear, and results are client-controlled;
ConsumeGrindSessioncannot consume these sessions, so integrations requiring server-controlled outcomes must use server-opened sessions.
- Added per-target cinematic camera customization.
- Targets can customize camera framing, field of view, and blend-in and blend-out durations, with configured defaults for unspecified values.
- Targets can keep the gameplay camera instead of using a cinematic shot; cinematic shots remain unavailable when disabled in the server configuration.
- Added the permission-gated
/grindexamplecommand to demonstrateStartGrindwith sample settings and notify the player when the grind completes. - The use key now activates only the interest point the player aims at; when no point is aimed at, the press is left to other resources instead of selecting the nearest target.
- Removed the
RegisterUseClaimandRemoveUseClaimclient exports and their use-claim mechanism.
#Files Affected
Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.
- client/locked/*
- client/unlocked/examples.lua
- client/unlocked/keybinds.lua
- server/locked/*
- README.md
- locales/*
- types/types.lua
- fxmanifest.lua
#Changes
- The grinder can no longer be taken out, put away, or have its disc swapped while the player's hands are busy.
- Players are notified why the action was refused.
- Integrations can register and remove their own busy checks, and a check blocks the action only when it returns
true.
- The vendor menu now stays open after buying, selling, or selling worn discs, with stock and prices updating after each trade.
- Added the
zyke_anglegrinder:OnGrinderEquipChangedclient event, which reports the new state when the player's own grinder comes out or goes away.
#Files Affected
Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.
- client/locked/*
- client/unlocked/can_checks.lua
- client/unlocked/vendors.lua
- README.md
- locales/*
- types/types.lua
- fxmanifest.lua
#Changes
- Added a cinematic close-up camera that blends in when a grind starts and blends back out when it ends.
- Integrations can opt out per target with
cinematic = false.
- Integrations can opt out per target with
- Added support for integrations to run their own grind minigame while grinder sessions handle cut stages and server-verified reporting.
- The server caps reported cuts by elapsed time and still handles disc wear, battery drain, motor sound, sparks, and witness checks.
- Integrations can claim the grinder use key so the grinder adds no competing action or refusal; claims can be removed explicitly and are removed when the registering resource stops.
- Integrations can set a replicated held-tool grip for their work animation and read the held disc's front edge for alignment.
- Integrations can set the held grinder down within 3 m of the player, or return it to the hand; a stale set-down position is cleared when the resource starts.
- Integrations can supply a local stand-in grinder prop; the player's own sparks follow its disc, the held grinder is hidden for them while it is active, and other players still see the held grinder.
- Integrations can save a grind's progress and pass it to the next session so completed stages are skipped and a cut-based stage resumes partway.
- Active custom grinds no longer time out, though disconnects and owner-resource stops still end them.
- Added aimable interest points that mark grinder targets while the grinder is equipped.
- Aiming at a point in reach shows its use prompt, and pressing the use key passes that point's data to the integration; without an aimed point, the closest target is used.
- Vendors can now buy back worn standard, pro, and elite discs, with prices based on durability.
- Full-durability discs sell for up to 80% of the vendor's item price, and broken discs sell for the broken-disc buyback price.
- Added a golden spot in the middle of the pressure-cut target zone that cuts and wears the disc 1.5× faster.
- The gauge highlights the golden band and shows when you are in it.
- Pressure cuts now take 25% longer on easy, medium, and hard difficulties.
- Fixed scaled grinder sparks drifting off the disc edge as intensity changes.
- Shared prop textures larger than 1024px now drop their top mips, reducing the texture dictionary's memory use from 26 MiB to 9 MiB.
#Files Affected
Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.
- client/locked/*
- client/unlocked/keybinds.lua
- client/unlocked/vendors.lua
- server/locked/*
- server/unlocked/vendors.lua
- shared/unlocked/config.lua
- shared/unlocked/functions.lua
- nui/*
- README.md
- locales/*
- stream/zyke_anglegrinder_shared.ytd
- types/types.lua
- fxmanifest.lua
#Config Changes
shared/unlocked/config.lua- Added the full
Config.Settings.grindertable. Copy the entire table from the new config.
- Added the full
#Changes
- Added grinding effects that follow disc contact.
- Disc sparks stream from the front edge and intensify with cutting pressure for everyone nearby, with a fallback effect on older builds and an option to disable them.
- Motor sound plays in range with spin-up, pressure-matched grind and cut loops, and spin-down stop.
- Pressure cuts vary in intensity while skill-check cuts hold a steady cut.
- Added a custom grinding animation that positions the player so the disc edge lands on the grind point.
- Held grinder switches to a work grip that points the disc at the work for everyone, then returns.
- Added a 5.2-second disc spin-down after each grind that blocks holstering and vehicle entry with a notice.
- The disc load menu now lists the highest-tier carried disc first, then best condition and largest stack, with the best-tier icon on the load row.
- Melee and reload inputs stay suppressed from the moment the grinder draw starts until it is put away.
- Renamed grinder, disc, broken disc, and battery items to the
anglegrinderprefix, including vendor stock and buyback.- Upgrading requires manually updating inventory, vendor, shop, and stored item and metadata names, with no automatic migration.
- All 21 streamed grinder models now share a single texture dictionary.
#Files Affected
Note: Due to the number of files changed, we recommend a full reinstall instead of swapping out individual files.
- client/locked/*
- client/unlocked/keybinds.lua
- client/unlocked/menu.lua
- server/locked/*
- shared/unlocked/config.lua
- shared/unlocked/functions.lua
- README.md
- extras/grinder_assets.md
- extras/items/README.md
- extras/items/images/256/anglegrinder.png
- extras/items/images/256/anglegrinder_battery.png
- extras/items/images/256/anglegrinder_broken.png
- extras/items/images/256/anglegrinder_broken_nobatt.png
- extras/items/images/256/anglegrinder_disc.png
- extras/items/images/256/anglegrinder_disc_broken.png
- extras/items/images/256/anglegrinder_disc_elite.png
- extras/items/images/256/anglegrinder_disc_elite_broken.png
- extras/items/images/256/anglegrinder_disc_pro.png
- extras/items/images/256/anglegrinder_disc_pro_broken.png
- extras/items/images/256/anglegrinder_elite.png
- extras/items/images/256/anglegrinder_elite_broken.png
- extras/items/images/256/anglegrinder_elite_broken_nobatt.png
- extras/items/images/256/anglegrinder_elite_nobatt.png
- extras/items/images/256/anglegrinder_empty.png
- extras/items/images/256/anglegrinder_empty_nobatt.png
- extras/items/images/256/anglegrinder_nobatt.png
- extras/items/images/256/anglegrinder_pro.png
- extras/items/images/256/anglegrinder_pro_broken.png
- extras/items/images/256/anglegrinder_pro_broken_nobatt.png
- extras/items/images/256/anglegrinder_pro_nobatt.png
- extras/items/images/256/artwork/anglegrinder.png
- extras/items/images/256/artwork/anglegrinder_battery.png
- extras/items/images/256/artwork/anglegrinder_broken.png
- extras/items/images/256/artwork/anglegrinder_broken_nobatt.png
- extras/items/images/256/artwork/anglegrinder_disc.png
- extras/items/images/256/artwork/anglegrinder_disc_broken.png
- extras/items/images/256/artwork/anglegrinder_disc_elite.png
- extras/items/images/256/artwork/anglegrinder_disc_elite_broken.png
- extras/items/images/256/artwork/anglegrinder_disc_pro.png
- extras/items/images/256/artwork/anglegrinder_disc_pro_broken.png
- extras/items/images/256/artwork/anglegrinder_elite.png
- extras/items/images/256/artwork/anglegrinder_elite_broken.png
- extras/items/images/256/artwork/anglegrinder_elite_broken_nobatt.png
- extras/items/images/256/artwork/anglegrinder_elite_nobatt.png
- extras/items/images/256/artwork/anglegrinder_empty.png
- extras/items/images/256/artwork/anglegrinder_empty_nobatt.png
- extras/items/images/256/artwork/anglegrinder_nobatt.png
- extras/items/images/256/artwork/anglegrinder_pro.png
- extras/items/images/256/artwork/anglegrinder_pro_broken.png
- extras/items/images/256/artwork/anglegrinder_pro_broken_nobatt.png
- extras/items/images/256/artwork/anglegrinder_pro_nobatt.png
- extras/items/images/4096/README.md
- extras/items/images/grinder.png
- extras/items/images/grinder_battery.png
- extras/items/images/grinder_broken.png
- extras/items/images/grinder_broken_nobatt.png
- extras/items/images/grinder_disc.png
- extras/items/images/grinder_disc_broken.png
- extras/items/images/grinder_disc_elite.png
- extras/items/images/grinder_disc_elite_broken.png
- extras/items/images/grinder_disc_pro.png
- extras/items/images/grinder_disc_pro_broken.png
- extras/items/images/grinder_elite.png
- extras/items/images/grinder_elite_broken.png
- extras/items/images/grinder_elite_broken_nobatt.png
- extras/items/images/grinder_elite_nobatt.png
- extras/items/images/grinder_empty.png
- extras/items/images/grinder_empty_nobatt.png
- extras/items/images/grinder_nobatt.png
- extras/items/images/grinder_pro.png
- extras/items/images/grinder_pro_broken.png
- extras/items/images/grinder_pro_broken_nobatt.png
- extras/items/images/grinder_pro_nobatt.png
- extras/items/ox_inventory.txt
- extras/items/qb-core.txt
- locales/*
- stream/zyke_anglegrinder.ydr
- stream/zyke_anglegrinder.ytyp
- stream/zyke_anglegrinder_battery.ydr
- stream/zyke_anglegrinder_battery.ytyp
- stream/zyke_anglegrinder_broken.ydr
- stream/zyke_anglegrinder_broken.ytyp
- stream/zyke_anglegrinder_broken_nobatt.ydr
- stream/zyke_anglegrinder_broken_nobatt.ytyp
- stream/zyke_anglegrinder_disc.ydr
- stream/zyke_anglegrinder_disc_broken.ydr
- stream/zyke_anglegrinder_disc_elite.ydr
- stream/zyke_anglegrinder_disc_elite.ytyp
- stream/zyke_anglegrinder_disc_elite_broken.ydr
- stream/zyke_anglegrinder_disc_elite_broken.ytyp
- stream/zyke_anglegrinder_disc_pro.ydr
- stream/zyke_anglegrinder_disc_pro.ytyp
- stream/zyke_anglegrinder_disc_pro_broken.ydr
- stream/zyke_anglegrinder_disc_pro_broken.ytyp
- stream/zyke_anglegrinder_discs.ytyp
- stream/zyke_anglegrinder_elite.ydr
- stream/zyke_anglegrinder_elite.ytyp
- stream/zyke_anglegrinder_elite_broken.ydr
- stream/zyke_anglegrinder_elite_broken.ytyp
- stream/zyke_anglegrinder_elite_broken_nobatt.ydr
- stream/zyke_anglegrinder_elite_broken_nobatt.ytyp
- stream/zyke_anglegrinder_elite_nobatt.ydr
- stream/zyke_anglegrinder_elite_nobatt.ytyp
- stream/zyke_anglegrinder_empty.ydr
- stream/zyke_anglegrinder_empty.ytyp
- stream/zyke_anglegrinder_empty_nobatt.ydr
- stream/zyke_anglegrinder_empty_nobatt.ytyp
- stream/zyke_anglegrinder_grind.ycd
- stream/zyke_anglegrinder_nobatt.ydr
- stream/zyke_anglegrinder_nobatt.ytyp
- stream/zyke_anglegrinder_pro.ydr
- stream/zyke_anglegrinder_pro.ytyp
- stream/zyke_anglegrinder_pro_broken.ydr
- stream/zyke_anglegrinder_pro_broken.ytyp
- stream/zyke_anglegrinder_pro_broken_nobatt.ydr
- stream/zyke_anglegrinder_pro_broken_nobatt.ytyp
- stream/zyke_anglegrinder_pro_nobatt.ydr
- stream/zyke_anglegrinder_pro_nobatt.ytyp
- stream/zyke_anglegrinder_shared.ytd
- types/types.lua
- fxmanifest.lua
#Config Changes
shared/unlocked/config.lua- Added the full
Config.Settings.grindertable. Copy the entire table from the new config.
- Added the full