Marcadores

Marcadores são as formas coloridas desenhadas no mundo — o cilindro que o jogador pisa para entrar em uma loja, o anel de um checkpoint de corrida, a seta que aponta o próximo objetivo.

As funções que recebem coordenadas aceitam tanto números soltos quanto um Vector3 no lugar deles — createMarker(Vector3(x, y, z)) e setMarkerTarget(m, Vector3(x, y, z)) funcionam normalmente.

Os marcadores criados por um resource são destruídos junto com ele.

No cliente os setters respondem pelo elemento que você passou, não pela árvore: os marcadores abaixo de um elemento pai continuam sendo alterados, mas a chamada devolve o resultado do próprio pai — false quando ele não é um marcador (setMarkerType devolve true para qualquer elemento vivo). Um nome de tipo ou ícone desconhecido, ou um canal de cor fora do intervalo, faz um setter do cliente devolver false sem aviso.

Estas 14 funções existem no servidor e no cliente. Você pode usá-las em scripts declarados em server_files, client_files ou shared_files.

Tipos de marcador

O tipo é sempre uma string e não diferencia maiúsculas de minúsculas.

Tipo	Aparência
"checkpoint"	Checkpoint em forma de disco, com seta apontando para o alvo.
"default"	Apelido para "checkpoint".
"ring"	Anel flutuante, usado em corridas aéreas.
"cylinder"	Cilindro apoiado no chão.
"arrow"	Seta apontando para baixo.
"corona"	Esfera de luz difusa.

Ícones de checkpoint

O ícone também é uma string e não diferencia maiúsculas de minúsculas.

Ícone	Descrição
"none"	Sem ícone. É o padrão.
"arrow"	Seta dentro do marcador.
"finish"	Bandeira quadriculada de chegada.

createMarker Cria um marcador em uma posição do mundo.

getMarkerCount Conta quantos marcadores existem no servidor.

getMarkerType Devolve o tipo de um marcador.

getMarkerSize Devolve o tamanho de um marcador.

getMarkerColor Devolve a cor de um marcador.

getMarkerTarget Devolve a posição de destino de um marcador, usada pela seta do checkpoint.

getMarkerIcon Devolve o ícone de um marcador.

getMarkerTargetArrowProperties Devolve a cor e o tamanho da seta que aponta para o alvo do checkpoint.

setMarkerType Troca o tipo de um marcador.

setMarkerSize Troca o tamanho de um marcador.

setMarkerColor Troca a cor de um marcador.

setMarkerTarget Define para onde a seta de um checkpoint aponta.

setMarkerIcon Define o ícone desenhado dentro do marcador.

setMarkerTargetArrowProperties Muda a cor e o tamanho da seta que aponta para o alvo de um checkpoint.