setElementPosition | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

setElementPosition

Client-side
Server-side
Shared

Pair: getElementPosition

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 sets the position of an element to the specified coordinates.

Caution

Do not use this function to spawn a player . It will cause problems with other functions like warpPedIntoVehicle . Use spawnPlayer instead.

Syntax

 setElementPosition ( )

Code Examples

server

This example lets admins teleport 5 random players to themselves

function randomPlayersToLocation(p)
    if not isPlayerStaff(p) then return end


  local playersOnline = getElementsByType("player")
  local amount = #playersOnline


  if amount == 0 then return end


  for index = 1,(amount > 5 and 5 or amount) do
    local player = playersOnline[index]
    setElementPosition(player, getElementPosition(p))
  end
end
addCommandHandler("randomtp", randomPlayersToLocation)
addCommandHandler("playershere", randomPlayersToLocation)


-- Utility function
local staffACLs = {
    aclGetGroup("Admin"),
    aclGetGroup("Moderator")
}


function isPlayerStaff(p)
  if isElement(p) and getElementType(p) == "player" and not isGuestAccount(getPlayerAccount(p)) then
    local object = getAccountName(getPlayerAccount(p))


    for _, group in ipairs(staffACLs) do
      if isObjectInACLGroup("user." .. object, group) then
        return true
      end
    end
  end
  return false
end

Issues

ID Description
539 Changing player position when he/she has a jetpack will remove the jetpack and bug when skin is changed
529 Player falls from his bike when its teleported by setElementPosition

See Also

Element Functions
Element Events
Reference