Function

createProjectile

Creates a projectile element on the server (grenade, rocket, Molotov, satchel charge, etc.) with a creator, type, force and target. Fires onProjectileCreation. The type is a weapon ID, e.g. 16 grenade, 17 tear gas, 18 Molotov, 19 rocket, 20 heat-seeking rocket, 39 satchel.

Syntax

projectile createProjectile(element creator, int weaponType [, float x = pozycja twórcy, float y = pozycja twórcy, float z = pozycja twórcy, float force = 1, element target = nil, float rx = 0, float ry = 0, float rz = 0, float vx = nil, float vy = 0, float vz = 0])

Arguments

creatorelement: Who fired it (player, ped, vehicle).
weaponTypeint: Projectile type (weapon ID).
xfloat, optional = pozycja twórcy: Start X.
yfloat, optional = pozycja twórcy: Start Y.
zfloat, optional = pozycja twórcy: Start Z.
forcefloat, optional = 1: Launch force.
targetelement, optional = nil: Homing projectile target.
rxfloat, optional = 0: Rotation X.
ryfloat, optional = 0: Rotation Y.
rzfloat, optional = 0: Rotation Z.
vxfloat, optional = nil: Velocity X.
vyfloat, optional = 0: Velocity Y.
vzfloat, optional = 0: Velocity Z.

Differences from MTA:SA

These MTA:SA arguments are not here: int model

In MTA:SA

createProjectile(element creator, int weaponType, float posX, float posY, float posZ, float force = 1.0, element target = nil, float rotX, float rotY, float rotZ, float velX, float velY, float velZ, int model)

Returns

The new projectile, or false.

Example

addCommandHandler("granat", function(player)
    local x, y, z = getElementPosition(player)
    local grenade = createProjectile(player, 16, x, y + 5, z)
    setProjectileCounter(grenade, 3000)
end)

Notes

Limitation. The projectile is not drawn in the game yet and does not fly by itself. The explosion is triggered by setProjectileCounter or detonateSatchels (via createExplosion at the projectile's position).