filo_bolt

3D Lug Nut Minigame · filo studios

A fully standalone wheel bolt minigame for FiveM. Lug nuts spawn directly on the vehicle wheel in 3D world-space — players click each one to tighten or loosen it. One export, works with any framework.

Features

3D World-Space Bolts — Lug nuts spawn physically on the wheel, not as a flat UI overlay. Players interact with each bolt individually in the game world.

Cursor-Driven Interaction — Raycast hover detection with draw-outline feedback and adaptive cursor styles. Finished bolts are visually distinct from remaining ones.

Smooth Rotation Animation — Each bolt animates with interpolated Y-axis rotation. Loosened bolts drop to the ground with physics; tightened bolts lock in place.

Custom Audio — Ratchet sound effect plays per-bolt via a named script audio bank. Positional audio — sound emits from the bolt's world location.

Fully Configurable — Lug nut count, tighten vs. loosen direction, cancel permission, hover outline colour, and one-at-a-time mode — all set per-call or in config.

Single Export API — Call exports.filo_bolt:Start() from any resource. Returns true on completion, false if the player cancels.

Dependencies

• ox_lib — for cache.ped and require

• No framework required

Support

Discord: discord.gg/bErPEKvRXg

Documentation: blamefilo.github.io/docs