Template:Ped events

2025-08-20T05:12:44Z

Derex: Add missing onPedWeaponReload

<ul>
<li>[[onPedDamage]]</li>
{{Added feature/item|1.5.9|1.5.8|20740|
<li>[[onPedVehicleEnter]]</li>
<li>[[onPedVehicleExit]]</li>
}}
<li>[[onPedWasted]]</li>
<li>[[onPedWeaponSwitch]]</li>
{{Added feature/item|1.6.1|1.6.0|22909|
<li>[[onPedWeaponReload]]</li>
}}
</ul>

<noinclude>[[Category:Events templates]]</noinclude>

OnPlayerWeaponReload

2025-02-10T12:34:09Z

Derex: Created page with "__NOTOC__ {{Server event}} {{Added feature/item|1.6.1|1.6.0|22909|This event is triggered when a player is reloading their weapon.}} ==Parameters== <syntaxhighlight lang="lua"> int weapon, int ammoInClip, int ammo </syntaxhighlight> *'''weapon''': an int representing weapon used for firing a shot. *'''ammoInClip''': an int amount of ammo left for this weapon type in clip. *'''ammo''': an int amount of ammo left for this weapon..."

__NOTOC__
{{Server event}}
{{Added feature/item|1.6.1|1.6.0|22909|This event is triggered when a [[player]] is reloading their weapon.}}

==Parameters==
<syntaxhighlight lang="lua">
int weapon, int ammoInClip, int ammo
</syntaxhighlight>

*'''weapon''': an [[int]] representing [[weapons|weapon]] used for firing a shot.
*'''ammoInClip''': an [[int]] amount of ammo left for this [[weapons|weapon]] type in clip.
*'''ammo''': an [[int]] amount of ammo left for this [[weapons|weapon]] type.

==Source==
The [[event system#Event source|source]] of this event is the [[player]] who's reloading their weapon.

===Canceling===
If this event is [[Event system#Canceling|canceled]], then the players will not be able to reload their [[weapons|weapon]] manually by pressing R key.
The weapons will still reload when the '''ammoInClip''' reaches zero. Using [[SetGlitchEnabled|quickreload]] will also reload the [[weapons|weapon]].

==Example==
This example will output informations when a [[player]]'s weapon is reloading.
<syntaxhighlight lang="lua">
addEventHandler("onPlayerWeaponReload", root, function(weapon, ammoInClip, ammo)
outputChatBox(getPlayerName(source) .. " is reloading their weapon: ")
outputChatBox("Weapon: " .. getWeaponNameFromID(weapon))
outputChatBox("AmmoInClip: " .. ammoInClip)
outputChatBox("Ammo: " .. ammo)
end)
</syntaxhighlight>
{{See also/Server event|Player events}}

Talk:PairsByKeys

2025-01-31T16:03:23Z

Derex: Useful Functions authors

Dutchman101: Mentioning author names on script examples isn't adopted practise on the MTA wiki, thanks for understanding

Im not the author if this page, but if you check other useful functions, most of them will have an author so it should be deleted on every of these or should be restored.

Multi Theft Auto: Wiki - User contributions [en]

Template:Ped events

OnPlayerWeaponReload

Talk:PairsByKeys