OnPlayerWeaponFire

2024-11-17T21:03:21Z

Iroak:

{{Server event}}
__NOTOC__
{{New feature/item|3.0153|1.5.3|9921|
This event is called when a player fires a weapon. This does not trigger for projectiles, melee weapons, or camera.
}}
{{Note|This event works only with weapons which have enabled bullet sync. See [[Weapons]] for more information. }}
==Parameters==
<syntaxhighlight lang="lua">
int weapon, float endX, float endY, float endZ, element hitElement, float startX, float startY, float startZ
</syntaxhighlight>
*'''weapon''': an [[int]] representing [[weapons|weapon]] used for making a shot.
*'''endX''', '''endY''', '''endZ''': [[float]] world coordinates representing an end point.
*'''hitElement''': an [[element]] which was hit by a shot. Currently this can be only another [[player]]. '''Note: hitElement could be incorrect and should not be relied upon.'''
*'''startX''', '''startY''', '''startZ''': [[float]] world coordinates representing the start of the bullet. '''Note: This is not the gun muzzle.'''

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who fired the weapon.

==Example==
This code creates explosions when the source players shoots.
<syntaxhighlight lang="lua">
addEventHandler ("onPlayerWeaponFire", root,
function (weapon, endX, endY, endZ, hitElement, startX, startY, startZ)
createExplosion(endX, endY, endZ, 2, source);
end
)
</syntaxhighlight>

{{See also/Server event|Player events}}

Weapons

2024-11-17T21:00:18Z

Iroak:

Scripting functions that ask for a weapon ID need an integer that refers to the GTASA weapon ID list. They are listed below.
{{Note|
*Clip size () denotes clip size when the weapon is dual wielded. Weapons without this specification are not dual wield weapons.
*GTASA [[Weapon_skill_levels|weapon stats]] will affect movement, accuracy, damage, and dual wield capability. See [[setPedStat]] to change these stats. The default MTA server package comes with a resource called "defaultStats" that sets GTASA weapon stats to 999. See the weapon stats link for more info.
*For death reasons, especially in event handlers for onPlayerWasted or similar, also have a look at the [[Damage Types]].
*'''Name''' is compatible with functions [[getWeaponNameFromID]], [[getWeaponIDFromName]].
*'''Bullet Sync''' refers to whether they are triggered by the [[OnPlayerWeaponFire]] event.
}}
{|class="wikitable sortable" style="text-align:center; margin: 1em auto 1em auto; border:1px solid black"
|-
! Slot || class="unsortable" | Type || class="unsortable" | Image || Name || ID || class="unsortable" | Model ID || class="unsortable" | Clip || class="unsortable" | Sharing slot ammo || class="unsortable" | Bullet Sync
|-
! rowspan="2" | 0
! rowspan="2" | Hand
| [[Image:Fist.png]] || align="left" | Fist || 0 || - || -
| rowspan="2" | -
| rowspan="2" | No
|-
| [[Image:Knuckle.png]] || align="left" | Brassknuckle || 1 || 331 || -
|-
! rowspan="8" | 1
! rowspan="8" | Melee
| [[Image:Golfclub.png]] || align="left" | Golfclub || 2 || 333 || -
| rowspan="8" | -
| rowspan="8" | No
|-
| [[Image:Nitestik.png]] || align="left" | Nightstick || 3 || 334 || -
|-
| [[Image:Knife.png]] || align="left" | Knife || 4 || 335 || -
|-
| [[Image:Bat.png]] || align="left" | Bat || 5 || 336 || -
|-
| [[Image:Shovel.png]] || align="left" | Shovel || 6 || 337 || -
|-
| [[Image:Poolcue.png]] || align="left" | Poolstick || 7 || 338 || -
|-
| [[Image:Katana.png]] || align="left" | Katana || 8 || 339 || -
|-
| [[Image:Saw.png]] || align="left" | Chainsaw || 9 || 341 || -
|-
! rowspan="3" | 2
! rowspan="3" | Handguns
| [[Image:Colt45.png]] || align="left" | Colt 45 || 22 || 346 || 17 (34)
| rowspan="3" | '''No''' ''Replacing handgun resets slot 2 ammo''
| rowspan="3" | Yes
|-
| [[Image:Silenced.png]] || align="left" | Silenced || 23 || 347 || 17
|-
| [[Image:Deagle.png]] || align="left" | Deagle || 24 || 348 || 7
|-
! rowspan="3" | 3
! rowspan="3" | Shotguns
| [[Image:Shotgun.png]] || align="left" | Shotgun || 25 || 349 || 1
| rowspan="3" | Yes
| rowspan="3" | Yes
|-
| [[Image:Sawnoff.png]] || align="left" | Sawed-off || 26 || 350 || 2 (4)
|-
| [[Image:Spas12.png]] || align="left" | Combat Shotgun || 27 || 351 || 7
|-
! rowspan="3" | 4
! rowspan="3" | Sub-Machine Guns
| [[Image:Mac10.png]] || align="left" | Uzi || 28 || 352 || 50 (100)
| rowspan="3" | Yes
| rowspan="3" | Yes
|-
| [[Image:Mp5.png]] || align="left" | MP5 || 29 || 353 || 30
|-
| [[Image:Tec9.png]] || align="left" | Tec-9 || 32 || 372 || 50 (100)
|-
! rowspan="2" | 5
! rowspan="2" | Assault Rifles
| [[Image:Ak47.png]] || align="left" | AK-47 || 30 || 355 || 30
| rowspan="2" | Yes
| rowspan="2" | Yes
|-
| [[Image:M4.png]] || align="left" | M4 || 31 || 356 || 50
|-
! rowspan="2" | 6
! rowspan="2" | Rifles
| [[Image:Rifle.png]] || align="left" | Rifle || 33 || 357 || 1
| rowspan="2" | '''No''' ''Replacing rifle resets slot 6 ammo''
| rowspan="2" | Yes
|-
| [[Image:Sniper.png]] || align="left" | Sniper || 34 || 358 || 1
|-
! rowspan="4" | 7
! rowspan="4" | Heavy Weapons
| [[Image:Rocketla.png]] || align="left" | Rocket Launcher || 35 || 359 || 1
| rowspan="4" | '''No''' ''Replacing heavy weapon resets slot 7 ammo''
| rowspan="4" | No
|-
| [[Image:Heatseek.png]] || align="left" | Rocket Launcher HS || 36 || 360 || 1
|-
| [[Image:Flame.png]] || align="left" | Flamethrower || 37 || 361 || 50
|-
| [[Image:Minigun.png]] || align="left" | Minigun || 38 || 362 || 500
|-
! rowspan="4" | 8
! rowspan="4" | Projectiles
| [[Image:Grenade.png]] || align="left" | Grenade || 16 || 342 || 1
| rowspan="4" | '''No''' ''Replacing projectile resets slot 8 ammo''
| rowspan="4" | No
|-
| [[Image:Teargas.png]] || align="left" | Teargas || 17 || 343 || 1
|-
| [[Image:Molotov.png]] || align="left" | Molotov || 18 || 344 || 1
|-
| [[Image:Satchel.png]] || align="left" | Satchel || 39 || 363 || 1
|-
! rowspan="3" | 9
! rowspan="3" | Special 1
| [[Image:Spraycan.png]] || align="left" | Spraycan || 41 || 365 || 500
| rowspan="3" | '''No''' ''Replacing slot 9 weapon resets slot 9 ammo''
| rowspan="3" | No
|-
| [[Image:Fire_ex.png]] || align="left" | Fire Extinguisher || 42 || 366 || 500
|-
| [[Image:Camera.png]] || align="left" | Camera || 43 || 367 || 36
|-
! rowspan="5" | 10
! rowspan="5" | Gifts
| [[Image:Dildo1.png]] || align="left" | Dildo || 10 || 321 || -
| rowspan="5" | -
| rowspan="5" | No
|-
| [[Image:Dildo2.png]] || align="left" | Dildo || 11 || 322 || -
|-
| [[Image:Vibe1.png]] || align="left" | Vibrator || 12 || 323 || -
|-
| [[Image:Flowers.png]] || align="left" | Flower || 14 || 325 || -
|-
| [[Image:Cane.png]] || align="left" | Cane || 15 || 326 || -
|-
! rowspan="3" | 11
! rowspan="3" | Special 2
| [[Image:Irgoggle.png]] || align="left" | Nightvision || 44 || 368 || -
| rowspan="3" | -
| rowspan="3" | No
|-
| [[Image:Irgoggle.png]] || align="left" | Infrared || 45 || 369 || -
|-
| [[Image:Paracute.png]] || align="left" | Parachute || 46 || 371 || -
|-
! rowspan="1" | 12
! rowspan="1" | Satchel Detonator
| [[Image:Bomb.png]] || align="left" | Bomb || 40 || 364 || -
| rowspan="1" | -
| rowspan="1" | No
|}
Lua table of all weapon IDs.
<syntaxhighlight lang="lua">
local weaponsID = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 22, 23, 24, 25, 26, 27, 28, 29, 32, 30, 31, 33, 34, 35, 36, 37, 38, 16, 17, 18, 39, 41, 42, 43, 10, 11, 12, 14, 15, 44, 45, 46, 40}
</syntaxhighlight>
Lua table of all weapon IDs grouped by slot.
<syntaxhighlight lang="lua">
local weaponsBySlot = {
[0] = {0, 1}, -- Hand
[1] = {2, 3, 4, 5, 6, 7, 8, 9}, -- Melee
[2] = {22, 23, 24}, -- Handguns
[3] = {25, 26, 27}, -- Shotguns
[4] = {28, 29, 32}, -- Sub-Machine Guns
[5] = {30, 31}, -- Assault Rifles
[6] = {33, 34}, -- Rifles
[7] = {35, 36, 37, 38}, -- Heavy Weapons
[8] = {16, 17, 18, 39}, -- Projectiles
[9] = {41, 42, 43}, -- Special 1
[10] = {10, 11, 12, 14, 15}, -- Gifts
[11] = {44, 45, 46}, -- Special 2
[12] = {40}, -- Satchel Detonator
}
</syntaxhighlight>

==Functions==
{{Weapon functions|server}}== See Also ==
* [[Id|Ids]]

[[Category:ID Lists]]

[[hu:Weapons]]
[[it:Armi]]
[[ru:Weapons]]
[[de:Waffen]]
[[pl:Weapons]]

Multi Theft Auto: Wiki - User contributions [en]

OnPlayerWeaponFire

Weapons