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 ^[1]

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. 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.
KEEP_CAMERA_BEHIND
CAN_AIM	Allows weapon to be auto-aimed
CAN_FREE_AIM	Allows weapon to free aim
ANIM_RELOAD
ANIM_CROUCH_FIRE

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.

Tools

• IV Needle by CoMPMStR

External Link

•  GTAForums: Weaponsinfo.xml
• ^  GTAForums: Weapon types