restoreWorldModel

Desfaz remoções feitas com removeWorldModel.

Sintaxe

-- servidor
bool restoreWorldModel ( number modelo, number raio, number x, number y, number z [, number interior = -1 ] )

-- cliente
bool, number restoreWorldModel ( number modelo, number raio, number x, number y, number z [, number interior = -1 ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
modelo	number	—	Identificador do modelo, de 0 a 65535. No cliente, um valor fora dessa faixa dá a volta em vez de ser recusado.
raio	number	—	Aceito por compatibilidade, mas não entra na comparação.
x, y, z	number	—	Ponto de referência.
interior	number	-1	Interior. -1 casa com qualquer interior.

São desfeitas as remoções do mesmo modelo cujo centro esteja dentro do próprio raio delas em relação ao ponto informado.

Remoções do mesmo modelo podem se sobrepor. Uma remoção inteiramente contida em outra do mesmo modelo não remove nada por conta própria, então desfazê-la não muda nada — a remoção maior continua cobrindo aqueles objetos. Numa sobreposição parcial, desfazer uma delas devolve apenas o que a outra não cobre.

Retorno

No servidor, true se pelo menos uma remoção foi desfeita, false se nenhuma casou ou se os argumentos estiverem fora do intervalo aceito. No cliente, dois valores: true e a quantidade de objetos devolvidos ao mundo — quando nenhuma remoção casa, o retorno é true com quantidade 0, porque o cliente não usa false para dizer que não encontrou nada. Argumentos do tipo errado, ou uma chamada feita antes de o mundo do jogo carregar, devolvem apenas false com um aviso, sem o segundo valor.

O alcance segue o mesmo da remoção: restaurar no servidor devolve o cenário para todos os jogadores, restaurar no cliente só mexe no mundo daquele jogador.

Exemplo

-- servidor
restoreWorldModel(620, 100, 1500, -1200, 15)

-- cliente
local ok, quantidade = restoreWorldModel(620, 100, 1500, -1200, 15)
outputDebugString("objetos devolvidos: " .. quantidade)

Veja também

• removeWorldModel — Remove do mapa todos os objetos de um modelo dentro de uma esfera.
• restoreAllWorldModels — Desfaz todas as remoções de uma vez.