getWorldPropsWithinRange

Lista os objetos de cenário originais — os prédios e adereços que o próprio jogo posicionou — que estão a até uma distância de um ponto. Cada entrada traz modelo, posição, rotação, interior, se o jogo pode movê-lo e o raio delimitador dele.

Sintaxe

table getWorldPropsWithinRange ( number x, number y, number z, number alcance [, table modelos ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
x, y, z	number	—	Centro da busca. Apenas números soltos, sem Vector3.
alcance	number	—	Raio da busca. Valores negativos são tratados como 0.
modelos	table	—	Listar só estes IDs de modelo: um array de números inteiros de 0 a 65535. Omita para listar todos os modelos.

Retorno

Um array com uma tabela por objeto: model, x, y, z, rx, ry, rz (rotação, em graus), interior, dynamic (se o jogo pode mover ou remover o objeto) e radius (o raio delimitador). No máximo 4096 objetos são devolvidos.

false com um aviso quando um argumento não é um número finito, quando modelos não é uma tabela nem nil, quando uma das entradas dele não é um número inteiro de 0 a 65535, ou quando o mundo do jogo ainda não carregou.

Exemplo

-- todas as palmeiras perto do jogador
local px, py, pz = getElementPosition(localPlayer)
local palmeiras = getWorldPropsWithinRange(px, py, pz, 300, {615, 616, 617})

for _, objeto in ipairs(palmeiras) do
    outputDebugString(("palmeira %d em %.0f, %.0f"):format(objeto.model, objeto.x, objeto.y))
end

Veja também

• removeGameWorld — Tira do jogo todo o cenário original.
• restoreGameWorld — Devolve o cenário original removido por removeGameWorld.