From GTAMods Wiki
Jump to navigation Jump to search
40px-Ambox rewrite orange.svg.png This article may need to be rewritten.
Please help improve this article. The discussion page may contain suggestions.

The weaponinfo.xml file was first introduced with GTA IV. It is used to define the behavior of weapons, similar to the weapon.dat used in previous games. This file can be viewed with any web browser, XML editor or simple text editor.


This file is split in three big sections, for each type of weapon: Melee, gun weapons and projectiles.


weapon type=""
Determines weapon name. You can create up to 25 additional weapons by using the unassigned names UNUSED0 and/or EPISODIC_1 - EPISODIC_24 [1]
data slot=""
Slot to carry weapon in.
Bullet characteristics to use...is also defined under "PROJECTILE TYPE="
Determines type of impact damage...is also defined under "EXPLOSION TYPE=".
Determines what effect to create from weaponFx.dat file.
Distance auto-aim can be used and target's health appears in reticule.
Defines how far the weapon shoots. Distances are also determined by the projectile's velocity, mass, etc defined under "projectile type=".
Ammo per clip.
Max ammo allowed for weapon.
Time in milliseconds between each shot. Is also determined by the gunfire animation speed which cannot be edited in WeaponInfo.
damage base=""
Damage dealt by bullets. Projectile and explosion damage is defined in explosionFx.dat.
Modifier for the weapon's damage in multiplayer.
Same as above but for peds in multiplayer.
physics force=""
Projectile's impact force. Can also be defined under "PROJECTILE TYPE=".
reload time=""
Reload time in milliseconds.
Time it takes to aim in milliseconds.
Time it takes to crouch in milliseconds.
aiming accuracy=""
Auto-aim accuracy while standing.
offset x="" y="" z=""
Determines auto-aim drift on the x,y,z coords
crouchedoffset x="" y="" z=""
Auto-aim accuracy while crouched.
reticule standing="" ducked="" scale=""
Reticule size while standing and crouched and target scale (zoom).
pickup regentime=""
Time in milliseconds it takes pickups to respawn.
Ammo given on weapon pickup.
rumble duration=""
Controller rumble time in milliseconds.
Controller rumble strength.


Flags go inside the <flag> stack. Example: <flag>GUN</flag>

Flag Description
GUN Identifies the weapon as a firearm
MELEE_CLUB Used for victims behavior when hit
MELEE_BLADE Used for victims behavior when hit
2HANDED Weapon is held with both hands
THROWN Weapon is thrown (affected by gravity)
TREAT_AS_2HANDED_IN_COVER Weapon is held in both hands while in cover
FIRST_PERSON First person aim with no crosshair
HEAVY Forces heavy weapon anims to be used
CREATE_VISIBLE_ORDNANCE Shows projectile before it is fired.
HIGHER_BREAK_FORCE Destroys objects faster
EXPLOSION_BASED_ON_IMPACT Determines when weapon explodes based on explodeimpactthreshold=""
explodeimpactwithvehiclethreshold="": data defined under <projectile>
ADD_SMOKE_ON_EXPLOSION Adds smoke effect to explosion.
SILENCED Silences the projectile/thrown weapon while in flight.
INSTANT_KILL_IN_MP Instant kill on impact in a MP game
ARMOUR_PENETRATING Bypasses body armor hit check.
CAN_AIM Allows weapon to be auto-aimed
CAN_FREE_AIM Allows weapon to free aim


Projectile data goes inside the <projectile> stack

projectile type=""
Defines the projectile type. "NONE" makes a copy of the item held in your hand.
typetocreate type=""
Defines projectile type. Used in special cases such as creating a rocket.
Time in milliseconds it takes for projectile to explode after it is fired/thrown.
explosion type=""
Defines the effect to use from explosionFx.dat
Defines the projectile's speed.

<assets model="">
Weapon model to use.
<anim group="">
Weapon animation to use.
Weapon melee animation to use.


<muzzle fx="">
Muzzle effect to use.
<shell fx="">
Shell effect to use.
<trail fx="">
Projectile trail effect to use.


External Link