createFoliage

Cria uma mancha de vegetação: um triângulo sobre o qual o jogo faz crescer grama e arbustos — as mesmas plantas que o material da superfície cria em outros pontos do mapa.

Sintaxe

-- servidor
foliage createFoliage ( number x1, number y1, number z1, number x2, number y2, number z2, number x3, number y3, number z3, number superficie [, number densidade = 1.0 [, number luz = 60 ] ] )

-- cliente
foliage createFoliage ( number x1, number y1, number z1, number x2, number y2, number z2, number x3, number y3, number z3, number superficie [, number densidade = 1.0 [, number luz = 60 [, bool visivel = true ] ] ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
x1, y1, z1	number	—	Primeiro canto do triângulo.
x2, y2, z2	number	—	Segundo canto do triângulo.
x3, y3, z3	number	—	Terceiro canto do triângulo.
superficie	number	—	Material de superfície, de 0 a 177. No cliente ele precisa ter um registro de plantas; o servidor só confere a faixa.
densidade	number	1.0	Multiplicador aplicado às quantidades plantadas.
luz	number	60	Pré-iluminação das plantas, de 0 a 255. Valores fora dessa faixa dão a volta.
visivel	bool	true	Somente no cliente. Se as plantas são desenhadas. O servidor sempre cria vegetação visível e ignora este argumento.

No cliente cada canto também pode ser passado como um único Vector3 no lugar dos três números; o servidor recebe apenas números soltos.

Retorno

O elemento de vegetação, ou false com um aviso quando falta um argumento ou ele é do tipo errado, quando superficie está fora de 0 a 177, ou — no cliente — quando o material não tem registro de plantas ou o sistema de vegetação não está disponível.

O servidor aceita qualquer triângulo e o envia aos jogadores; se algo cresce, cada cliente decide. No cliente, quando o pool de plantas está cheio, o elemento ainda é criado — mas nada cresce nele.

Exemplo

-- cliente: cria uma mancha sobre a primeira superficie em que o jogo consegue plantar
local material = getPlantableSurfaces()[1]

local mancha = createFoliage(
    2495.0, -1670.0, 13.0,
    2495.0, -1650.0, 13.0,
    2515.0, -1670.0, 13.0,
    material
)

Veja também

• getFoliageVertices — Devolve os três vértices de uma mancha de vegetação.
• setFoliageSurface — Troca o material de superfície de uma mancha de vegetação.
• setFoliageDensity — Define o multiplicador de densidade de uma mancha de vegetação.
• isFoliageVisible — Diz se uma mancha de vegetação está sendo desenhada.