Lettify: Lettify moved page BR-PT/setElementPosition to PT-BR/setElementPosition: Wrongly titled during creation

2025-09-06T00:02:05Z

Lettify moved page BR-PT/setElementPosition to PT-BR/setElementPosition: Wrongly titled during creation

← Older revision

Revision as of 00:02, 6 September 2025

Lettify: Translation to Brazilian Portuguese

2025-09-05T23:59:06Z

Translation to Brazilian Portuguese

New page

__NOTOC__
{{BR/Funcao compartilhada}}
Esta função define a posição de um elemento para as coordenadas especificadas.
{{BR/Warning|Não use essa função para ''spawnar'' um [[Elemento/Player|jogador]]. Isso vai causar problemas com outras funções, como [[warpPedIntoVehicle]]. Em vez disso, use [[spawnPlayer]].}}

==Sintaxe==
<syntaxhighlight lang="lua">
bool setElementPosition ( element theElement, float x, float y, float z [, bool warp = true ] )
</syntaxhighlight>
{{BR/OOP||[[PT-BR/Elemento|elemento]]:setPosition|position|getElementPosition}}

===Argumentos Necessários===
*'''theElement:''' Um [[PT-BR/Elemento|elemento]] válido para ser movido.
*'''x:''' A coordenada '''X''' de destino.
*'''y:''' A coordenada '''Y''' de destino.
*'''z:''' A coordenada '''Z''' de destino.

===Argumentos Opcionais===
*'''warp:''' teletransporta o jogador, resetando qualquer animação que esteja rodando. Definindo esse argumento com ''false'', a animação permanecerá.

===Retorno===
Retorna ''true'' se foi executado com sucesso, caso contrário retorna ''false''.

==Exemplo==
<section name="Server" class="server" show="true">
Este exemplo permite que os administradores teletransportem 5 jogadores aleatórios para si mesmos
<syntaxhighlight lang="lua">
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)

-- Utilitário
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
</syntaxhighlight>
</section>

Se você quiser colocar um veículo ou jogador fora da água ou simular o comportamento de redefinição de posição caso CJ fique muito abaixo do solo, será necessário recuperar uma coordenada recomendada no solo para colocar o elemento. Dê uma olhada [https://forum.mtasa.com/topic/132891-important-helprespawn-vehicle/?do=findComment&comment=1003198 nesse posto do Fórum do MTA] para os passos na direção certa.

==Problemas==
{{Issues|
{{Issue|539|Alterar a posição do jogador quando ele/ela tiver um jetpack removerá o jetpack e o bug quando a skin for alterada}}
{{Issue|529|Jogador cai da bicicleta quando ela é teletransportada por setElementPosition}}
}}

==Veja também==
{{Element functions}}

[[hu:setElementPosition]]
[[ru:setElementPosition]]

PT-BR/setElementPosition - Revision history

Lettify: Lettify moved page BR-PT/setElementPosition to PT-BR/setElementPosition: Wrongly titled during creation

Lettify: Translation to Brazilian Portuguese