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

The following opcodes is related to weapons. Some of the opcodes are specific to one game so click on the opcode to see more information about it, if it exists.

• 0114, sets an actor's weapon ammo while in a vehicle
• 017B, sets an actor's weapon ammo
• 01B2, gives an actor a weapon
• 01B9, sets an actor's currently armed weapon
• 0237, sets a gang's weapons
• 02D6, checks if a weapon is being fired in a location
• 02D8, checks the current weapon an actor is holding
• 02E2, sets an actor's weapon accuracy
• 031D, checks if an actor is hit by a weapon
• 031E, checks if a vehicle is hit by a weapon
• 032B, creates a pickup with ammo info – usually used for weapons
• 041A, gets the current amount of ammo for the weapon
• 0467, resets 031D
• 0468, resets 031E
• 0470, gets an actor's current weapon
• 048F, removes weapons from an actor
• 0491, checks if an actor has the weapon
• 04B8, gets the weapon's data from an actor
• 0501, sets the player's ability to drive by
• 0555, removes a specific weapon from an actor
• 0563, sets the player's drive by ammo
• 06AB, hides all weapons
• 0713, makes an actor do drive bys
• 081A, sets an actor's weapon skill
• 087E, sets an actor to drop weapons after a death
• 0881, sets an actor be able to shoot
• 0946, sets an actor 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