Bring true gunsmithing to your FiveM server with Advanced Weapon Inspect & Customization, a professionally developed resource created by Mythic Scripts.

This system turns weapon modification into a real roleplay moment. Players walk up to a workbench, see their actual weapon rendered live in 3D, rotate it in their hands, and fit parts onto it one by one. Every interaction is built around a clean interface, an in-game 3D preview, and optimized performance.

Features

Inspect the real weapon in 3D, not a static image. The weapon the player is holding is rendered live in a dedicated studio scene with three-point lighting and a seamless backdrop. Rotate it freely with the mouse, zoom in on any detail, or enable auto-rotation to admire the finished build.

Eleven customization slots are supported: optic, muzzle, magazine, foregrip, grip, flashlight, barrel, slide, trigger, stock and skin. The workbench reads your ox_inventory setup and automatically files every compatible component into the right slot, with a manual override table for weapon packs that use unusual naming.

Only what the player actually owns can be installed. Every compatible part is still listed so the player can try it on the 3D preview and see how it looks, but parts that are not in the inventory are clearly marked as preview only and are rejected on save, on the client and on the server.

Live performance bars recalculate as the player builds. Precision, damage, range, fire rate, mobility and control are computed from the game natives and the mounted parts, and each bar shows the gain or loss of the current draft over the saved configuration before anything is committed.

Weapon finishes include the full GTA tint range, plus all 32 MK2 tints on MK2 weapons, each with its own rarity tag and colour swatch.

A dedicated Inspect tab shows the technical sheet of the weapon: serial number, caliber, category, tier, magazine capacity, ammunition, weight, registration and durability, along with the list of parts currently mounted.

Twenty-eight streamed prop attachments are included: coloured and textured grips, camo grips, weapon-specific grips, vertical foregrips, a foregrip with an integrated light, two optics and a laser. They are real streamed models, not weapon components, so they work on weapons whose packs never shipped attachment metadata.

Attachments are visible to everyone around. Worn attachments are broadcast through a replicated statebag and bound to the weapon by the engine itself, so they never drift or jitter while the player walks, sprints, rolls or drives, and every nearby player sees exactly the same build.

A built-in placement editor lets players position their attachments precisely. Every weapon carries its grips and optics in a different spot, so the editor provides a live 3D gizmo with move and rotate modes, per-axis control, bone selection, and fine sliders down to the millimetre. Each player tunes their own attachment on their own weapon, and the setting is stored in the weapon metadata so it follows the weapon when it is traded, dropped or stashed. Server administrators can additionally save a default placement per weapon model that applies to everyone, gated by an ACE permission or a job.

Workbenches are placed through ox_target zones, or through ox_lib points with an [E] prompt when ox_target is not installed. The menu can also be opened with a command, a keybind, or an export from your own scripts.

Access can be restricted by job and by grade, checked on the client and enforced again on the server. Every write goes through a server session, is rate limited, and is validated independently of what the client claims.

The interface is built with Svelte 5, Tailwind and Vite, and scales in vmin so it stays proportional on every resolution. Fonts and icons are embedded, so nothing breaks when the NUI has no network access. Translated in English, French and Spanish.

Configurable Settings

• Workbench locations, radius and labels
• Job and grade restrictions
• Command, keybind and export entry points
• Equipped-weapon-only mode
• Install time per part
• 3D scene position, camera distance, FOV, zoom limits and sensitivity
• Studio lighting, backdrop colour and timecycle
• Background image and cut-out window geometry
• Attachment render distance and sync interval
• Placement editor permissions (everyone, ACE or job)
• Slot definitions, keywords and manual overrides
• Attachment list, models, rarities, weights and colour swatches
• Magazine capacities, weapon categories, tiers and caliber labels
• Tint list and rarities
• Notification style and position
• Language

Framework Support

• ESX Legacy (job and grade restrictions)
• QBCore and Qbox (running ox_inventory)
• Standalone

Dependencies

• ox_lib
• ox_inventory
• ox_target (optional, falls back to ox_lib points)

What's Included

• Full script resource
• 28 streamed prop attachments (.ydr / .ytd / .ytyp)
• Configuration file and data files
• Ready-to-paste ox_inventory setup files
• Installation guide
• Documentation
• Future updates
• Discord support

Important Information

This script does NOT add weapon magazines, scopes, suppressors or any other weapon components to your server. It is a workbench, not a weapon pack. It reads the components already declared in your ox_inventory data/weapons.lua and presents them in the right slot. If a weapon has no components declared, its slots will be empty. Two ready-to-paste setup files are provided to help you declare the components your weapon packs already contain.

The 28 prop attachments included in the script are the only physical items shipped with the resource. Inventory icons for them are not included, so you will need to supply your own PNG files in ox_inventory/web/images/ if you want thumbnails in the inventory.

Slots such as slide, trigger and stock will only be populated if your weapon packs actually declare components for them. Most weapon packs do not.

Please review the dependencies and installation instructions before purchasing.

This product uses FiveM Asset Escrow to protect important files. All configurable files remain accessible: config.lua, the data files, the locales and the setup files.

All purchases are final. Refunds will not be provided for installation errors, missing dependencies, missing weapon components in your own weapon packs, server incompatibility, or failure to read the product requirements.

Support

Need assistance with installation or configuration? Open a support ticket in the official Mythic Scripts Discord.

• Documentation: https://mythic-scripts.gitbook.io/mythic-scripts-documentation/
• Discord: https://discord.gg/mythicscripts