Stow That Weapon - Version 3.1.1

The Details

Bring immersion to your GTA V / LSPDFR experience with Stow That Weapon, a highly customizable RPH plugin that visually stores your long guns and shotguns on your character when they're not in use. Weapons are attached realistically to your player, complete with attachments, tint, and fully adjustable positioning to suit your preference. With full AI support, the same realistic stowing behavior can be applied to NPCs as well - making patrols and scenes feel even more authentic.

The Features

• Automatic Weapon Stowing: Once you switch away from an accepted weapon, it's automatically placed on your character until needed again.

• Customizable Weapon Positions: Fine-tune weapon placement with adjustable offsets and rotation to achieve the perfect fit on your character.

• Customizable Weapon List: Define exactly which weapons should be stowed via configuration settings.

• Live In-Game Settings Menu: Use the built-in menu (default key F5) to tweak most settings on the fly, including positioning offsets and rotation.

• Attachment Support: Stowed weapons display their attachments and accessories, with optional support for addon components.

• AI Support: Enable weapon stowing for AI peds, with separate customizable settings, including only enabling support for cops or all peds.

• Quick Remove Key: A configurable hotkey lets you instantly remove the stowed weapon if needed.

• Additional Customization: Don't like the stowed weapon clipping through your vehicle? Choose to hide it while driving. Don't like how the game activates the flashlight on your stowed weapon while using the flashlight on your equipped weapon? Disable the flashlight from showing. Want the AI to show a stowed weapon even if they haven't equipped it? Enable best weapon to show whatever their best accepted weapon is in their inventory.

Installation

Installation is as simple as dragging the contents of the zip file to your GTA V folder.

• BackWeapon.dll and BackWeapon.pdb will end up in the plugins folder and RAGENativeUI.dll is in the main directory.

  • Please note if you already have RAGENativeUI installed, it is recommended to keep whichever is newer.

• Load with RPH.

Notes and Resources

GTA V NOTE: Sometimes the GTA V folder gets set as read-only. This may prevent the plugin from writing to the ini file which would likely result in a crash. Please ensure your GTA V folder is not set to read-only before using this plugin.

MENU NOTE: Almost all settings can be changed by the menu except the accepted weapons and addon components lists, which must be manually edited within the BackWeapon.ini file. The ini file can be reloaded via the Reload ini File menu option. The only setting that requires the plugin to be reloaded is EnableAI. Changing this in game will not have an effect until the plugin is reloaded.

INI NOTE: The .ini file is not provided with the download and is instead generated if it does not exist on first load of the plugin. If it does exist, the plugin will check for missing values and add them.

ADDON COMPONENTS NOTE: AddonComponents in the ini file is to be used if you have any addon weapon components (all default weapon components are already accounted for), so that they show up on the stowed weapon. You add them using the name (i.e., COMPONENT_AT_AR_FLSH) and separate multiple values with a comma.

LIST OF DEFAULT WEAPON IDs: https://wiki.rage.mp/index.php?title=Weapons

KEYS REFERENCE: https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.keys?view=netframework-4.8

DEFAULT INI VALUES AND EXPLANATION:

[Main]
HideWhileInVehicle = true  "If true, the weapon will be invisible while the player is in a vehicle."
DisableFlashlight = false  "If true, the weapon will not show the flashlight component on the back of both the player and AI."
AcceptedWeapons = weapon_smg, weapon_pumpshotgun, weapon_pumpshotgun_mk2, weapon_carbinerifle, weapon_carbinerifle_mk2, weapon_specialcarbine, weapon_specialcarbine_mk2  "List of weapons that will show on the player's back."
OffsetPosition = 0.0,-0.17,-0.02  "Position of the weapon relative to the player's Spine3 bone."
Rotation = 0.0,165,0.0  "Rotation of the weapon for the player."

[AI]
EnableAI = true  "If true, enables support for the AI."
EnableBestWeapon = true  "If true, the best weapon in the ped's inventory will show on their back if they have not yet equipped an accepted weapon."
CopsOnly = true "If true, will only show weapons on the back of cops. Otherwise, will work on all peds in the game."
HideWhileInVehicle = true  "If true, the weapon will be invisible while the ped is in a vehicle."
AcceptedWeapons = weapon_smg, weapon_pumpshotgun, weapon_pumpshotgun_mk2, weapon_carbinerifle, weapon_carbinerifle_mk2, weapon_specialcarbine, weapon_specialcarbine_mk2  "List of weapons that will show on the peds' backs."
OffsetPosition = 0.0,-0.17,-0.02  "Position of the weapon relative to the ped's Spine3 bone."
Rotation = 0.0,165,0.0  "Rotation of the weapon for AI."
  
[Advanced]
AddonComponents = None "Here you can add any addon weapon components you have installed so that they will show up on the stowed weapon. You need to use the name of component, ie COMPONENT_AT_AR_FLSH. Multiple entries should be separated by a comma."

[Keybindings]
DeleteWeaponKey = Decimal  "The key for deleting the weapon off the player's back."
MenuKey = F5 "The key for opening the menu added with version 3.0.0"
GunDown = Down "Keys for moving the weapon when customizing position"
GunUp = Up
GunLeft = Left
GunRight = Right
GunRollLeft = NumPad4
GunRollRight = NumPad6
GunForward = NumPad8
GunBackward = NumPad2
GunYawLeft = NumPad7
GunYawRight = NumPad9
GunPitchLeft = NumPad1
GunPitchRight = NumPad3