This event is triggered when a projectile is created.

Parameters

element creator

• creator: the element that created the projectile.

Source

element: The source of this event is the projectile that was created.

Canceling

This event cannot be cancelled. To remove the projectile you can use setElementPosition (somewhere far away) and then destroyElement (which makes it explode).

Code Examples

Example 1 Example 2 Example 3

client

This will output a chatbox message when someone creates a projectile.

function projectileCreation()
  outputChatBox("A projectile was created!")
end
addEventHandler("onClientProjectileCreation", root, projectileCreation)

client

This will punish a player for throwing a teargas grenade. When he throws it he keeps getting warped to the location where the teargas got created, and also the teargas keeps getting warped to it. This will result in +/-60hp loss for the creator.

function projectileCreation( creator )
  local projectileType = getProjectileType( source ) -- We get the projectile type
  if projectileType == 17 then -- If is tear gas then...
    local creatorName = getPlayerName( creator ) -- We get the player name who creates the projectile
    local x, y, z = getElementPosition ( source ) --Getting the position from the projectile creator
    outputChatBox ( creatorName.." is a noob teargas user! But he got punished for it don't worry." )
    setTimer ( setElementPosition, 50, 250, source, x, y, z-0.5 )
    setTimer ( setElementPosition, 50, 250, creator, x, y, z-0.5 )
  end
end
addEventHandler( "onClientProjectileCreation", root, projectileCreation )

client

This will disable people from creating flares. ( Dropped by Hydras )

function disableFlares ( )
local projType = getProjectileType( source ) --  get the projectile type

    if projType == 58 then -- if the projectile is a flare

  destroyElement(source) -- notice cancelEvent() does not work, so this destroys the projectile element after it was created.

    end

end

addEventHandler( "onClientProjectileCreation", root, disableFlares ) -- when a projectile gets created call disableFlares.

See Also

Projectile Events

• onClientProjectileCreation

Projectile Functions

• detonateSatchels
• createProjectile
• getProjectileCounter
• getProjectileCreator
• getProjectileForce
• getProjectileTarget
• getProjectileType
• setProjectileCounter

Reference

• Scripting Events