getResourceMapRootElement

Devolve o elemento raiz de um dos arquivos de mapa de um resource.

Sintaxe

element getResourceMapRootElement ( resource oResource [, string nomeDoMapa ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oResource	resource	—	Resource dono do mapa. Passe getThisResource() para o seu.
nomeDoMapa	string	primeiro mapa	Caminho do mapa, exatamente como está escrito no map_files do manifesto.

Retorno

O elemento raiz do mapa, ou false quando o resource não tem esse mapa. Um mapa inexistente também escreve o motivo no console de depuração.

Cada arquivo listado em map_files é carregado sob um elemento raiz de tipo "map" cujo ID é o caminho daquele arquivo. Tudo o que o arquivo de mapa criou fica pendurado nele, o que faz dele a alça para tratar o conteúdo de um mapa como um grupo — contar, esconder, mover ou destruir tudo de uma vez.

Omitir nomeDoMapa devolve o primeiro mapa que o resource carregou, que é o que você quer quando o resource traz um mapa só.

local raizDoMapa = getResourceMapRootElement(getThisResource(), "maps/arena.map")

-- tudo o que o arquivo de mapa criou
for _, spawn in ipairs(getElementsByType("spawnpoint", raizDoMapa)) do
    setElementDimension(spawn, 7)
end

-- um resource com um único arquivo de mapa
local raiz = getResourceMapRootElement(getResourceFromName("race"))

Nota

Esta função não é o getResourceRootElement. Aquele é a raiz do próprio resource, pai de tudo o que o resource cria — inclusive destas raízes de mapa.

Veja também

• getResources — Lista todos os resources encontrados pelo servidor.
• getResourceOrganizationalPath — Devolve a cadeia de pastas organizacionais em que um resource foi encontrado.
• getResourceInfo — Lê um campo declarado no manifest do resource.
• getResourceLoadTime — Quando o resource foi carregado.
• getResourceLastStartTime — Quando o resource foi iniciado pela última vez.
• getResourceLoadFailureReason — Explica por que a última inicialização falhou.
• startResource — Inicia um resource.
• stopResource — Agenda a parada de um resource.