weaponinfo.xml

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.

Structure

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

Weapon

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 (Explained in more detail here:Topic at Gtaforums)

data slot=""

Slot to carry weapon in.

firetype=""

Bullet characteristics to use...is also defined under "PROJECTILE TYPE="

damagetype=""

Determines type of impact damage...is also defined under "EXPLOSION TYPE=".

group=""

Determines what effect to create from weaponFx.dat file.

targetrange=""

Distance auto-aim can be used and target's health appears in reticule.

weaponrange=""

Defines how far the weapon shoots. Distances are also determined by the projectile's velocity, mass, etc defined under "PROJECTILE TYPE=".

clipsize=""

Ammo per clip.

ammomax=""

Max ammo allowed for weapon.

timebetweenshots=""

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.

networkplayermod=""

Modifier for the weapon's damage in multiplayer.

networkpedmod=""

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.

fasttime=""

Time it takes to aim in milliseconds.

crouchtime=""

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.

ammoonstreet=""

Ammo given on weapon pickup.

rumble duration=""

Controller rumble time in milliseconds.

intensity=""

Controller rumble strength.

Flags

Flags go inside the <flag> stack

<flag>GUN</flag>

Identifies the weapon as a firearm

<flag>MELEE_CLUB</flag>

Used for victims behavior when hit

<flag>MELEE_BLADE</flag>

Used for victims behavior when hit

<flag>2HANDED</flag>

Weapon is held with both hands

<flag>THROWN</flag>

Weapon is thrown (affected by gravity)

<flag>TREAT_AS_2HANDED_IN_COVER</flag>

Weapon is held in both hands while in cover

<flag>FIRST_PERSON</flag>

First person aim with no crosshair

<flag>HEAVY</flag>

Forces heavy weapon anims to be used

<flag>CREATE_VISIBLE_ORDNANCE</flag>

Shows projectile before it is fired.

<flag>HIGHER_BREAK_FORCE</flag>

<flag>EXPLOSION_BASED_ON_IMPACT</flag>

Determines when weapon explodes based on explodeimpactthreshold="" explodeimpactwithvehiclethreshold="": data defined under <projectile>

<flag>ADD_SMOKE_ON_EXPLOSION</flag>

Adds smoke effect to explosion.

<flag>SILENCED</flag>

Silences the projectile/thrown weapon while in flight.

<flag>INSTANT_KILL_IN_MP</flag>

Instant kill on impact in a MP game

<flag>ARMOUR_PENETRATING</flag>

Bypasses body armor hit check.

<flag>KEEP_CAMERA_BEHIND</flag>

<flag>CAN_AIM</flag>

Allows weapon to be auto-aimed

<flag>CAN_FREE_AIM</flag>

Allows weapon to free aim

<flag>ANIM_RELOAD</flag>

<flag>ANIM_CROUCH_FIRE</flag>

Projectile

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.

fusetime=""

Time in milliseconds it takes for projectile to explode after it is fired/thrown.

explosion type=""

Defines the effect to use from explosionFx.dat

vehiclevelocity=""

Defines the projectile's speed.

<assets model="">

Weapon model to use.

<anim group="">

Weapon animation to use.

<meleegroup1="">

Weapon melee animation to use.

Effects

<muzzle fx="">

Muzzle effect to use.

<shell fx="">

Shell effect to use.

<trail fx="">

Projectile trail effect to use.

External Links

• Weaponsinfo.xml - GTA Forums topic used for research and test of this file.

Tools

• Weapon editor - Tool to edit the file, by CoMPMStR.