setElementFrozen

Client-side

Server-side

Shared

Pair: isElementFrozen

This page is incomplete! Help wanted!

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

This function freezes an element (stops it in its position and disables movement) or unfreezes it.

Caution

This function cancels any animation set by setPedAnimation if you freeze the ped.

Syntax

 setElementFrozen ( )

Code Examples

server

This example binds the "p" key to a function to freeze/unfreeze the player's current vehicle.

function toggleFreezeStatus(thePlayer) -- This function freezes the specified player's vehicle, if he's in one
  local playerVehicle = getPedOccupiedVehicle(thePlayer) -- Check if player's in vehicle

  if playerVehicle then -- if so
    local isPlayerVehicleFrozen = isElementFrozen(playerVehicle) -- Check if vehicle is frozen

    setElementFrozen(playerVehicle, not isPlayerVehicleFrozen) -- Set opposite state
  end
end

local connectedPlayers = getElementsByType("player") -- Get all connected players

for playerID = 1, #connectedPlayers do -- Loop through each player
  local playerElement = connectedPlayers[playerID] -- Get player element by accessing it via playerID

  bindKey(playerElement, "p", "down", toggleFreezeStatus, "Toggle freeze status") -- Bind function for player
end

Issues

ID	Description
1291	Ped rotation is always zero on client side if ped has been frozed after creating it
541	Frozen ped rotation goes wrong with latency reduction enabled
442	Client-side setElementFrozen should sync vehicle driven by local player

setElementFrozen

Syntax

Code Examples

Issues

See Also

Element Functions

Element Events

Reference