Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

---

Fires one shot from a custom weapon.

OOP Syntax Help! I don't understand this!

• Method: weapon:fire(...)

Syntax

bool fireWeapon ( weapon theWeapon )

Required Arguments

• theWeapon: The weapon to be fired.

Returns

• bool: value

Returns true if the shot weapon is valid and therefore the shot was fired, false otherwise.

Code Examples

Example 1 Example 2

shared

This function creates and fires a weapon.

function createAndFire()
    local weaponElement = createWeapon("mp5", 0, 0, 3) -- Create a MP5 at the coordinates 0, 0, 3

    fireWeapon(weaponElement) -- Fire the weapon we spawned
end
addEventHandler("onClientResourceStart", resourceRoot, createAndFire)

shared

This example will create an M4, attach it to the local player and fire it every frame. Be aware that neither the weapon nor the shots are synced between players and that normally weapons don't fire every frame.

local weaponElement = nil

function onClientResourceStart()
  weaponElement = createWeapon("m4", 0, 0, 0) -- when the resource starts, create the M4 and attach it to the local player with an offset to place it above their head facing forwards
  attachElements(weaponElement, localPlayer, 0, 0, 1, 0, 0, 90)
end
addEventHandler("onClientResourceStart", resourceRoot, onClientResourceStart)

function onClientRender() -- fire the M4 every frame using the "onClientRender" event
  fireWeapon(weaponElement)
end
addEventHandler("onClientRender", root, onClientRender)

See Also

Reference

• Scripting Functions