[HOW TO] Stream Add-on Weapons

Hi guys! I finally bring you my tutorial on adding new weapons to your server! No more replacing those weapons of yours. So if you read my tutorial on melee weapons, you will find some similarities here. This will require OpenIV.

NOTE: this is a basic setup for streaming add-on weapons. This will not spoonfeed you on exactly what you want to do. You will need to research for the weapon you want to create.

UPDATE: 11/3/19 - Weapon Component pool size has been increased!

UPDATE: 3/25/21 - Retired from FiveM Development. Link to my add-on creations are below

Step 1: Choosing your model

So why is this a step?

GTA V reads 2 different models when loading your weapon, one being your base model, and the other one being the Hi def model. You will find that some weapon mods on sites (Like GTA5-MODS) will only have the HI def model. These cannot be streamed if the creator of the mod did not make the base model. Here is an example of what is correct;


If the mod also includes the HI def textures, these may be included IF the base model is present.

Step 2: Resource Setup

Ok! The model has been selected and we are ready to setup the resource! Put your models into a “stream” folder.

Next; you will need your META files for these weapons! back to my example for the AK47 NEON, I have copied the META files from the ASSAULT RIFLE. These can be found in OPENIV. here is what I have; (Red lines meaning these files are not required.)

Next; to setup our __resource.lua. Make sure that your Weapons.meta is AFTER everything else, (in this case, my Weapons.meta is renamed to WeaponAKP.meta) and your weaponcomponents.meta being loaded first, otherwise some things will not work! Here is my example;

Once that is squared away, you can proceed with editing/adding weapons!

Step 3: Weapon.meta editing

The weapon meta is the main configuration of the gun; what it’ll shoot, how fast, what it is classified as, etc. First is the ordering of the weapons, which is shown as below;

As you can tell; the numbers do not really matter, as long as they are not the same as another weapon.
The slot name should be identical to the weapon for that slot.

Next is the basic weapon information;

Here, you list the name of the weapon, the audio for it, slot, etc. everything on the top is pretty self explanatory, and mostly what you want to edit. Change the name, model, and slot. Then simply scroll down until you find “ATTACHPOINTS” like so;

and simply change the name to “COMPONENT_WEAPONNAME_CLIP_01” to set up the gun’s magazine for later. You can also add more attachments for the weapon here as well.

If you are just adding a basic weapon; you are now finished!

Step 4: Weaponcomponents.meta editing

Next we will set up the components for the gun! Really, this part is just a cut and paste.
All you need to do here is change the name, model, and clip size (if it is a magazine) to your liking. The clip size here will override what you put in weapons.meta.


Step 5: Weapon animations

This part will be a full on copy and paste. Find what your add-on weapon would originally replace (EX. My AK47 would replace the ASSAULT RIFLE, so you would copy the animations from an ASSAULT RIFLE in the Weaponanimations.meta in OpenIV.) Make sure you copy all animations that are for that weapon, then change the name of the weapon to the name you set in Weapons.meta

Step 6: Other Meta files

Finally; we will finish the other meta files. Only the weaponarchetypes and pedpersonality metas should be left.

For the weaponarchetypes, the format is always the same, just change the names. You should have any weapons/weapon components that you are adding in here


And lastly; The Pedpersonality.meta

There are 4 categories for this meta; unarmed, 1h, 2h, and minigun.

Unarmed is any melee weapon or any handheld bombs

1h is Pistols, and small SMG’s

2h is Anything else but minigun

Minigun is… well the minigun.

Follow the format that is given in any pedpersonality.meta in OpenIV. The only thing you change in here the weapon names like so;

Once this is done, you are finished!

Now just load up your server, and spawn in your weapon! Yay!

Hope you guys find use in this, and hope this opens your server up to much more! :smile:

A few other notes
  1. This tutorial was made simple for now just because of my time restraints. Over time, I will add more information here to make it more accessible to people who have troubles finding certain information. This tutorial does not include pointers for making weapons such as RPG’s or bombs, but these are not hard to make. This tutorial was made to show you the basics of setting up your add-on weapon(s)

  2. There is no template for this tutorial as this tutorial is a basic format for any weapon. Though, you can use the template from the melee tutorial, and replace what’s needed.


Q: Is there any restrictions as to how much I can add?
A: For the weapons themselves, I have not noticed yet.

Q: I want to use vehicle weapon ammo for my guns. Is this possible?
A: Yes. Might be buggy, but it is possible to tweak it correctly.

Q: My weapon isn’t showing! :frowning:
A: Check to make sure all the names match up & you are actually streaming your models!

Q: My weapon shows up… But where’s my attachments?
A: Make sure you are streaming the model for the attachments, the attachments are identified in Weaponarchetypes.meta, and the default value is set to TRUE for the attachment in Weapons.meta if the gun is to have it by default.

Q: Can I use clips/attachments from other weapons?
A: Yes! Just make sure you set them in Weapons.meta

Q: Isn’t there supposed to be a pickups.meta with the gun?
A: Technically, yes. But I have yet to get this to work properly. FiveM has troubles with mounting/unmounting this file, and causes crashes. I just use pickups from other guns for now. If anyone finds a fix for this before me, be sure to inform me!

My Add-ons

With a lot going on in my life now, I have decided to drop any form of development for FiveM and will most likely not return. Below will be a link to my creations over the years in the scene. You are free to use them as you please, but are mainly for reference purposes. Do not contact me for any assistance, I will most likely not reply.



do you have a template for this?

1 Like

You can use the addon Melee weapons temp, and change what is needed

1 Like


1 Like

Could u share ur template with us? Should be more easly for us start

Thanks in advance

1 Like

There is one in the previous post. It uses the same files, just have to replace things.

1 Like

pleaseeee can you give template i try with addon melee weapons but this dont work

1 Like

Don’t have a template. If the weapon is a replace for a certain weapon, copy the original weapon’s meta’s.

1 Like

You can make the download available for this addon ?

1 Like

This is not an Add-On.

NOTE: this is a basic setup for streaming add-on weapons. This will not spoonfeed you on exactly what you want to do. You will need to research for the weapon you want to create.


Thank you for this! I managed to get an add-on glock to stream but I’m having an issue…
Whenever I reload the gun it crashes my game with code “music-july-autumn”. It only happens when I reload the gun. I tried changing the mag models to vanilla combat pistol mags and it worked, but i’d like to get the custom mags streamed if possible. Anyone have ideas?

1 Like

Found the issue. I forgot to add the magazine models to weaponarchetypes.meta along with my weapon model.

1 Like

oof. I remember when i did that. nearly pulled my hair out over a noob mistake


I just noticed that if I disconnect from my server and reconnect, the game crashes with a CWeaponManager error. I have to restart my client every time I want to reconnect to the server. Do you have this issue?

1 Like

Sometimes. For some reason, FiveM does not like to unmount these files.


Is it not possible to have multiple addon weapons in 1 resource? Because everytime I go over 7 components total for DIFFERENT weapons in the 1 resource it crashes or doesn’t let any components work. I’ve tried to have multiple weaponcomponents.meta in the 1 resource but that doesn’t work either… I really don’t want to have 25 resources for 25 guns

1 Like

This is a pool size that can’t be changed in the gameconfig.xml either, so not much you can do with components.

1 Like

So multiple resources will fix the problem or not? Because if not that means add-on weapons are useless without components. Because each addon weapon needs minimum 1 component (The magazine), so there is a limiation of 7 addon guns?

1 Like

well what you can do is use components from base game guns to find a matching model, or even replace a component that is not used in your server. I wish there was a way around this, but it seems we will have to wait until GTA V updates this value to add any other custom components.

I know that may seem a bit downgrading, but for some of the weapons, it doesn’t look terrible with it. Other ones… eh not so much.

1 Like

Yeah it is rather limiting, but replacing components from base guns should suffice I guess.

1 Like