Add missing events that were not properly listed on wiki

Author: Fernando-A-Rocha

events/Ped/examples/onClientPedChoke-1.lua

@@ -0,0 +1,5 @@
+addEventHandler( "onClientPedChoke", getRootElement( ),
+    function ( )
+        cancelEvent( );
+    end
+);

events/Ped/onClientPedChoke.yaml

@@ -0,0 +1,20 @@
+# Scraped from: https://wiki.multitheftauto.com/wiki/OnClientPedChoke
+name: onClientPedChoke
+type: client
+source_element:
+  type: element
+  description: The source of this event is the ped who is choking.
+description: This event is fired when a ped chokes due to the effect of a weapon such
+  as tear gas grenades, fire extinguishers and spray cans.
+parameters:
+- name: weaponID
+  type: int
+  description: an int representing the ID of the weapon which caused the choking.
+- name: responsiblePed
+  type: ped
+  description: the ped responsible for causing the choking, possiblly nil.
+examples:
+- path: examples/onClientPedChoke-1.lua
+  description: This example disables choking effects from the tear gas grenades.
+  side: client
+canceling: If this event is canceled, the ped will not be choked.

events/Player/examples/onPlayerDiscordJoin-1.lua

@@ -0,0 +1,21 @@
+function discordJoin(justConnected, key)
+    local myName = getPlayerName(source)
+    if justConnected == true then
+        outputChatBox ( myName .. " been referred here by " .. key )
+    else
+        outputChatBox ( myName .. " wanna play with " .. key )
+    end
+
+    local refer = getPlayerFromName(key)
+    setElementData(refer, "myUsers", getElementData(refer, "myUsers") + 1)
+    setPlayerDiscordJoinParams(refer, key, key, getElementData(refer, "myUsers"), 5)
+end
+addEventHandler("onPlayerDiscordJoin", getRootElement(), discordJoin)
+
+function storeDiscordParams()
+    local myName = getPlayerName(source)
+    setPlayerDiscordJoinParams(source, myName, myName, 1, 5)
+    setElementData(source, "myUsers", 1)
+end
+
+addEventHandler("onPlayerJoin", getRootElement(), storeDiscordParams)

events/Player/examples/onPlayerWeaponReload-1.lua

@@ -0,0 +1,6 @@
+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)

events/Player/onPlayerDiscordJoin.yaml

@@ -0,0 +1,23 @@
+# Scraped from: https://wiki.multitheftauto.com/wiki/OnPlayerDiscordJoin
+name: onPlayerDiscordJoin
+type: server
+source_element:
+  type: element
+  description: The source of this event is the player who is invited to the game/clicked
+    the "Join" button.
+description: This event is triggered when a player accepts game invites from a user
+  in discord or click on "Join" button from that player.
+parameters:
+- name: justConnected
+  type: bool
+  description: If true, player connected to the server using game invite, otherwise
+    he's already in the game and not joined the server using discord invite.
+- name: key
+  type: string
+  description: The key passed by setPlayerDiscordJoinParams to the player who invited
+    this user.
+examples:
+- path: examples/onPlayerDiscordJoin-1.lua
+  description: This example will announce the server that who invited that user from
+    discord.
+  side: server

events/Player/onPlayerTeleport.yaml

@@ -4,10 +4,13 @@ type: server
 source_element:
   type: element
   description: The source of this event is the player who triggered the teleport detection.
-description: When the player synchronizes data with the server, the server monitors
-  player positions to detect significant unexpected movements. If a player's position
-  deviates beyond the established threshold without server functions like [setElementPosition](/wiki/SetElementPosition
-  "SetElementPosition") being used, this event will be triggered.
+description: This event is triggered when a player's position changes significantly
+  without direct server intervention, such as the use of [setElementPosition](/wiki/SetElementPosition
+  "SetElementPosition"). When the player synchronizes data with the server, the server
+  monitors player positions to detect significant unexpected movements. If a player's
+  position deviates beyond the established threshold without server functions like
+  [setElementPosition](/wiki/SetElementPosition "SetElementPosition") being used,
+  this event will be triggered.
 parameters:
 - name: previousX
   type: float

events/Player/onPlayerWeaponReload.yaml

@@ -0,0 +1,25 @@
+# Scraped from: https://wiki.multitheftauto.com/wiki/OnPlayerWeaponReload
+name: onPlayerWeaponReload
+type: server
+source_element:
+  type: element
+  description: The source of this event is the player who's reloading their weapon.
+description: This event is triggered when a [player](/wiki/Player "Player") is reloading
+  their weapon.
+parameters:
+- name: weapon
+  type: int
+  description: an int representing weapon used for firing a shot.
+- name: ammoInClip
+  type: int
+  description: an int amount of ammo left for this weapon type in clip.
+- name: ammo
+  type: int
+  description: an int amount of ammo left for this weapon type.
+examples:
+- path: examples/onPlayerWeaponReload-1.lua
+  description: This example will output informations when aplayer's weapon is reloading.
+  side: server
+canceling: If this event is canceled, then the players will not be able to reload
+  their weapon manually by pressing R key.  The weapons will still reload when the
+  ammoInClip reaches zero. Using quickreload will also reload the weapon.