Weapon

This article contains information about weapons related to mission scripting. For the definition of weapons through IDE files see WEAP and for the placement using IPL see PICK.

A weapon is anything that can damage other objects, including vehicles and pedestrians. It is one of the core gameplay features of Grand Theft Auto.

Mission script

Opcodes

0113		adds ammo to the player's weapon
0114		adds ammo to the character's weapon
017A		sets the player's weapon ammo
017B		sets the character's weapon ammo
01B1		gives the weapon to the player
01B2		gives the weapon to the character
01B8		sets the current weapon of the player
01B9		sets the current weapon of the character
0213		creates a pickup with predefined ammo
0237		sets the gang's weapons
02D7		checks the current weapon of the player
02D8		checks the current weapon of the character
02E2		sets the character's weapon accuracy
031D		checks if the character is damaged by the weapon
031E		checks if the vehicle is damaged by the weapon
032B		creates a pickup with ammo
0419		gets the ammo of the player's weapon
041A		gets the ammo of the character's weapon
0467		clears the character's last weapon damage
0468		clears the vehicle's last weapon damage
046F		gets the player's current weapon
0470		gets the character's current weapon
048F		removes all of the character's weapons
0490		checks if the player has the weapon
0491		checks if the character has the weapon
04B8		gets the character's weapon data
0501		sets player can do drive by
0555		removes the weapon from the character
0563		ensures player has a drive-by weapon
06AB		hides all weapons
0713		makes the character do drive bys
081A		sets the character's weapon skill
087E		sets the character to drop weapons after a death
0881		sets the character be able to shoot
0946		sets the character oblivious to weapon fire
0992		sets the player's ability to scroll through weapons

Native functions

• GET_AMMO_IN_CHAR_WEAPON
• GET_CHAR_WEAPON_IN_SLOT
• GET_CURRENT_CHAR_WEAPON
• GET_WEAPONTYPE_MODEL
• GET_WEAPONTYPE_SLOT
• GIVE_WEAPON_TO_CHAR

This section is incomplete. You can help by fixing and expanding it.

Lists of Weapons

GTA III

Unlike in Vice City and San Andreas, where each weapon has a separate mesh and texture, GTA3's weapons are stored in a single DFF and TXD file, namely weapons.dff and generic.txd; only the selected object from the model hierarchy, e.g. pistol or Uzi is visible when the player chooses a weapon. Most of the information on the weapons are located in the weapon.dat file.

Name	ID	Model	Number	Icon
Unarmed			0
Bat	172	#bat	1
Pistol	173	#pistol	2
Uzi	178	#uzi	3
Shotgun	176	#shotgun	4
AK47	171	#ak47	5
M16	180	#m16	6
Sniper Rifle	177	#sniper	7
Rocket Launcher	175	#rocket	8
Flamethrower	181	#flame	9
Molotov Cocktail	174	#molotov	10
Grenade	170	#grenade	11
Detonator			12

Vice City

Vice City is the first GTA that lets you replace a weapon of the same type. Most of the information on the weapons are located in the weapon.dat file. Information on melee combat is located in the melee.dat file. The textures and models of the weapons are located in the gta3.img file. The HUD icon of the first is located in the hud.txd file. All sound effects listed here are hardcoded and their values correspond to the SFX file.

Number	Name	ID	DFF/TXD name	Icon	Group	Swing[1]	Hit[2]	Reload[3]	Fire[4]	Halt fire[5]
0	Unarmed				0	81	167-170	-	-	-
1	Brass Knuckle	259	brassknuckle		0	81	174-175	-	-	-
2	Screw Driver	260	screwdriver		1	171	172-173	-	-	-
3	Golf Club	261	golfclub		1	81	165-166	-	-	-
4	Night Stick	262	nitestick		1	81	165-166	-	-	-
5	Knife	263	knifecur		1	171	172-173	-	-	-
6	Baseball Bat	264	bat		1	81	165-166	-	-	-
7	Hammer	265	hammer		1	81	174-175	-	-	-
8	Cleaver	266	cleaver		1	171	172-173	-	-	-
9	Machete	267	machete		1	171	172-173	-	-	-
10	Katana	268	katana		1	171	172-173	-	-	-
11	Chainsaw	269	chnsaw		1	-	-	-	-	-
12	Grenade	270	grenade		2	-	-	-	-	-
13	Remote Detonator	291	bomb		2	-	-	-	-	-
14	Tear Gas	271	teargas		2	-	-	-	-	-
15	Molotov	272	molotov		2	-	-	-	-	-
16	Missile	273	missile	-	2	-	-	79	59-60	-
17	Colt .45 (Pistol)	274	colt45		3	-	-	77	50-51	-
18	Python (.357)	275	python		3	-	-	77	88-89	-
19	Chrome Shotgun	277	chromegun		4	-	-	78	66-67	-
20	Spaz Shotgun (S.P.A.S. 12)	278	shotgspa		4	-	-	78	85-86	87
21	Stubby Shotgun	279	buddyshot		4	-	-	78	66-67	-
22	Tec-9	281	tec9		5	-	-	78	71-72	73
23	Uzi 9mm (Uz-I)	282	uzi		5	-	-	78	54-55	56
24	Ingram Mac 10	283	ingramsl		5	-	-	78	71-72	73
25	MP5 (MP)	284	mp5lng		5	-	-	78	90-91	56
26	M4	280	m4		6	-	-	78	74-75	76
27	Ruger (Kruger)	276	ruger		6	-	-	78	74-75	76
28	Sniper Rifle	285	sniper		8	-	-	80	57-58	76
29	PSG-1 (.308 Sniper)	286	laser		8	-	-	80	57-58	76
30	Rocket Launcher	287	rocketla		7	-	-	79	59-60	-
31	Flame Thrower	288	flame		7	-	-	-	-	-
32	M60	289	m60		7	-	-	78	68-69	70
33	Minigun	290	minigun		7	-	-	-	54-55	-
34	Detonator				9	-	-	-	-	-
35	HeliCanon			-	7	-	-	78	68-69	70
36	Camera	292	camera		9	-	-	-	-	-

The last five columns contain values that are associated with an entry in the SFX file. Hardcoded arrays are used to assign sound effects to the weapons. For VC v1.0:

1. ^ Array starts at 0x6B6558, for group 1 weapons only. Every swing of a melee weapon creates a sound.
2. ^ Array starts at 0x6B657C, for group 1 weapons only. Whenever the player hits a character, it plays a sound effect.
3. ^ Array starts at 0x6B65A0. For weapons that allow reloading, a sound is played each time the weapon is reloaded.
4. ^ Array starts at 0x6B65F0. For weapons that fires bullets, a combination of sounds is played each time the weapon is fired.
5. ^ Array starts at 0x6B6660. Certain weapons play a short and soft sound effect when the player stops firing the weapon.

Note that some weapons share the same SFX but plays them differently (M4 and Ruger firing sound for example).

San Andreas

San Andreas is the first GTA that lets you dual wield weapons. Information on weapons, melee combat, textures, and models are located in the same files as in Vice City.

Name	ID	Model	Group	Number	Icon
Unarmed			1	0
Brass Knuckle	331	#brassknuckle	1	1
Golf Club	333	#golfclub	2	2
Night Stick	334	#nitestick	2	3
Knife	335	#knifecur	2	4
Baseball Bat	336	#bat	2	5
Shovel	337	#shovel	2	6
Pool Cue	338	#poolcue	2	7
Katana	339	#katana	2	8
Chainsaw	341	#chnsaw	2	9
Purple Dildo	321	#gun_dildo1	11	10
White Dildo	322	#gun_dildo2	11	11
Long White Vibrator	323	#gun_vibe1	11	12
Short White Vibrator	324	#gun_vibe2	11	13
Flowers	325	#flowera	11	14
Cane	326	#gun_cane	11	15
Grenade	342	#grenade	9	16
Tear Gas	343	#teargas	9	17
Molotov Cocktail	344	#molotov	9	18
Pistol	346	#colt45	3	22
Silenced Pistol	347	#silenced	3	23
Desert Eagle	348	#desert_eagle	3	24
Shotgun	349	#chromegun	4	25
Sawnoff Shotgun	350	#sawnoff	4	26
Combat Shotgun	351	#shotgspa	4	27
Micro SMG	352	#micro_uzi	5	28
SMG	353	#mp5lng	5	29
AK47	355	#ak47	6	30
M4	356	#m4	6	31
Tec9	372	#tec9	5	32
Rifle	357	#cuntgun	7	33
Sniper Rifle	358	#sniper	7	34
Rocket Launcher	359	#rocketla	8	35
Heat Seeking Rocket Launcher	360	#heatseek	8	36
Flame Thrower	361	#flame	8	37
Minigun	362	#minigun	8	38
Satchel Charges	363	#satchel	9	39
Detonator	364	#bomb	13	40
Spray Paint	365	#spraycan	10	41
Fire Extinguisher	366	#fire_ex	10	42
Camera	367	#camera	10	43
Night-vision Goggles	368	#nvgoggles	12	44
Thermal Goggles	369	#irgoggles	12	45
Parachute	371	#gun_para	12	46

GTA IV

Main article: List of Weapons (GTA4)

External links

• http://www.gtavice.com/weapons/
• http://www.gtasanandreas.net/weapons/
•  GTAForums: Generic SA SCM Documentation