Custom weapons for FiveM, from a GLB model
Updated 2026-07-23
A custom weapon is more than a model: the game needs weapon metadata, an archetype, components, and the model held correctly in the ped hand. Doing that by hand means juggling half a dozen files. The weapon builder generates all of it from a GLB gun model and hands you an install-ready resource.
Start with the model
- Export the gun as .glb with textures embedded; marketplace and Sketchfab-style models generally work as-is.
- Rough orientation does not matter: the builder auto-fits the model to the ped hand and aims it down the barrel.
- Already have a converted .ydr weapon? The builder imports that too, along with zips and folders.
Build the weapon
- 1Drop the model into the weapon builder.
- 2Check the live preview: the ped holds the weapon and cycles aim and fire stances, so grip and scale problems are visible immediately.
- 3Nudge the fit if needed, then pick the weapon type and adjust its settings.
- 4Export. The ZIP contains the model, textures, weapon metas, and the client and server scripts, with install and testing instructions.
The aim-and-fire preview is worth a careful look: a grip that is slightly off reads as fine in a still pose and obviously wrong mid-animation.
Install and test on your server
- 1Drop the exported resource into your resources folder and ensure it in server.cfg.
- 2Restart and give yourself the weapon by its name with your admin menu, or follow the bundled testing instructions.
- 3Test aiming, firing, and holstering in game; the animations exercise the fit from angles the preview cannot.
Frequently asked questions
- Does the weapon need to be rigged?
- No. Weapons are static models attached to the hand bone; the builder handles placement. Moving parts like slides are a modeling topic beyond a basic addon weapon.
- Which weapon types can I base mine on?
- You pick the weapon class in the builder (pistol, rifle, and so on); the generated metadata inherits sensible behavior for that class.
- Can I check the license of a downloaded model?
- Check the source before shipping it on a public server. Non-commercial licenses are common on model marketplaces, and the builder includes attribution in the ZIP when the source requires it.
- Is the weapon builder free?
- The preview with the ped holding your weapon is free. You sign in with Discord to use the tool, and exporting the resource uses tokens.