AddonWeapons 2.5
12,898
183
-
May 29, 2024
The box of weapons is located in the two Ammu-nations with a shooting range in Los Santos.
The script finds new weapons automatically, just install them like any addon mod (eg. cars).
IMPORTANT: This mod by itself doesn't bring any new weapons to the game.
Join my Discord server: https://discord.gg/vvxmKP5y5J
Source code: https://github.com/sruckstar/AddonWeapons
Installation
1. Install ScriptHookV
2. Install ScriptHookVDotNet
3. Install LemonUI (SHVDN3)
4. Move the scripts folder into your main GTAV folder (press Replace the files in the destination if Windows asks you to).
MP Characters Support
The script saves purchased weapons in the inventory separately for male and female MP characters. But there is an unpleasant bug: all Ammu-nations are closed if you change the skin of the main character to another one. Solution: change the skin directly in the shop before buying weapons, not on the street.
Commandline.txt
Commandline.txt allows you to add new categories to the menu, move weapons from one category to another, and set your own weapon prices. The file can be found in the AddonWeapons folder.
Available commands at this time:
CreateWeaponCategory(Name)
PutWeaponToCategory(ModelName, CategoryName)
SetWeaponCost(ModelName, IntCost)
Read more on GitHub
Trainer Mode (BETA)
You can customize AddonWeapons into trainer mode. In this case, the weapon purchase menu can be opened anywhere. Set the menu activation key in the AddonWeapons\settings.ini file
Weapon components (for mod authors)
To display weapon components in the menu, fill in the weapon shop.meta file correctly.
Weapon tints (for mod authors)
In order for the tints names to be displayed correctly in the purchase menu, you need to adhere to Rockstar standards: either use a set of 8 tints from standard weapons, or a set of 32 tints from MKII weapons. If you are not adding all the tints in your mod, or combining them from different types of weapon, you will need to create a text file in the AddonWeapons/tints folder with the name of the weapon from weapon shop.meta, and write all the tints names line by line. Otherwise, the menu will display tints without names (Tint 1, Tint 2, etc.), or the names will not correspond to the actual weapon tint.
Changelog
2.5
- Added a Commandline.txt file that can be used to add new categories, move weapons from one category to another, and set weapon prices.
- Fixed a bug where MP characters couldn't buy components for a weapon.
- Fixed a bug where the component removed from the weapon would reappear when the script was reloaded.
- Fixed bug with drawing multiple menus on the screen.
- Exiting the weapon component menu now opens the previous page instead of closing the menu completely.
- The name of the selected weapon is now displayed in the components menu.
- Weapon tint prices are now consistent with GTA Online prices.
2.4
- Added inventory saving for MP characters
- Fixed KeyNotFoundException error
First Uploaded: May 25, 2024
Last Updated: 10 days ago
Last Downloaded: 31 minutes ago
All Versions
212 Comments
More mods by andre500:
The box of weapons is located in the two Ammu-nations with a shooting range in Los Santos.
The script finds new weapons automatically, just install them like any addon mod (eg. cars).
IMPORTANT: This mod by itself doesn't bring any new weapons to the game.
Join my Discord server: https://discord.gg/vvxmKP5y5J
Source code: https://github.com/sruckstar/AddonWeapons
Installation
1. Install ScriptHookV
2. Install ScriptHookVDotNet
3. Install LemonUI (SHVDN3)
4. Move the scripts folder into your main GTAV folder (press Replace the files in the destination if Windows asks you to).
MP Characters Support
The script saves purchased weapons in the inventory separately for male and female MP characters. But there is an unpleasant bug: all Ammu-nations are closed if you change the skin of the main character to another one. Solution: change the skin directly in the shop before buying weapons, not on the street.
Commandline.txt
Commandline.txt allows you to add new categories to the menu, move weapons from one category to another, and set your own weapon prices. The file can be found in the AddonWeapons folder.
Available commands at this time:
CreateWeaponCategory(Name)
PutWeaponToCategory(ModelName, CategoryName)
SetWeaponCost(ModelName, IntCost)
Read more on GitHub
Trainer Mode (BETA)
You can customize AddonWeapons into trainer mode. In this case, the weapon purchase menu can be opened anywhere. Set the menu activation key in the AddonWeapons\settings.ini file
Weapon components (for mod authors)
To display weapon components in the menu, fill in the weapon shop.meta file correctly.
Weapon tints (for mod authors)
In order for the tints names to be displayed correctly in the purchase menu, you need to adhere to Rockstar standards: either use a set of 8 tints from standard weapons, or a set of 32 tints from MKII weapons. If you are not adding all the tints in your mod, or combining them from different types of weapon, you will need to create a text file in the AddonWeapons/tints folder with the name of the weapon from weapon shop.meta, and write all the tints names line by line. Otherwise, the menu will display tints without names (Tint 1, Tint 2, etc.), or the names will not correspond to the actual weapon tint.
Changelog
2.5
- Added a Commandline.txt file that can be used to add new categories, move weapons from one category to another, and set weapon prices.
- Fixed a bug where MP characters couldn't buy components for a weapon.
- Fixed a bug where the component removed from the weapon would reappear when the script was reloaded.
- Fixed bug with drawing multiple menus on the screen.
- Exiting the weapon component menu now opens the previous page instead of closing the menu completely.
- The name of the selected weapon is now displayed in the components menu.
- Weapon tint prices are now consistent with GTA Online prices.
2.4
- Added inventory saving for MP characters
- Fixed KeyNotFoundException error
First Uploaded: May 25, 2024
Last Updated: 10 days ago
Last Downloaded: 31 minutes ago
-
-
Something in your script causes massive lag spikes when using the mp characters for only certain scenarios (entering building cutscenes and seeing other mp characters). It only happens when there is more than one mp character in render distance or when the game loads a fake mp character for a transition cutscene or a menu viewing. I think your script might be trying to load multiple profiles it can't use or something.
February 04, 2025 -
@andre500 Testing the mod, i added a new category called Less Lethal and put my Rubber Gun in there, but seems the menu for the new category is buggy
1. Pressing Less Lethal seems to exit the menu but still enable the new Less Lethal category
2. Pressing enter on the weapon in the new Less Lethal category opens two menus at once, it does not close the initial weapon selection menu and puts the weapon customization menu on topFebruary 05, 2025 -
-
@Hazekware I was going to add this in version 2.5, but ran into bugs that took a long time to fix. At the moment the script can load 11 weapon crates and it won't work with less. I need time to rewrite the part of the code responsible for spawning crates so that they can be added in unlimited numbers.
10 days ago -
Failed to instantiate script AddonWeapons because constructor threw an exception: System.IO.FileNotFoundException
9 days ago -
@andre500 I tested the new update, it causes a Much FPS Drop when you get close to the characters in Hang Out
8 days ago -
@HeySlickThatsMe sorry i have a problem with script messageboards its possibile that error its the version of SHVDN?? Thanks and sorry at all
If i write here.4 days ago -
-
-
Hello i have a problem, i already purchased one of DLC weapon in Ammunition, but when I finished some missions and save the game, and i loaded the game second time, the DLC weapon in missing in the weapon wheel. Does anyone know how to fix it ? Thanks
3 days ago -
@reaperone I have the same issue, addon weapons are not saving correctly. Hopefully @andre500 can find a solution for this.
3 days ago -
Is there any way for the character to hold a specific weapon or even not holster the weapon when the menu appears (Trainer mode)? Or perhaps a way to see the weapon being modified in real time?
3 days ago -
-
@reaperone I figured it out. The problem is with the addon weapons themselves. For each one, go to it's shop_weapon file in common/data. Then, just below the WeaponComponents line, this needs to be added:
<availableInSP value="true" />
This will prevent the game from removing these weapons from your inventory on startup.2 days ago -
-
hello how can i disable the ai spawns the add on weapons? i am playing lspdfr and backup comes with my add on weapons. Thanks in advance
1 day ago -
This script only spawns addon weapons, but does not create them.
So far there is no ready tool to convert replaceable weapons to addon, but you can use these tools:
https://www.gta5-mods.com/tools/vweaponstoolki-addon-weapon-generator
https://www.gta5-mods.com/misc/modding-dlc-pack-v
For weapon creators:
Add all components to the shop_weapon.meta file so that AddonWeapons can detect them.