Efeitos visuais

Efeitos visuais são as partículas que o jogo desenha no mundo: fumaça, faíscas, sangue, cacos de vidro, respingos de água.

Existem três formas de usá-los:

• efeitos contínuos — createEffect devolve um elemento do tipo effect que fica no mundo até você destruí-lo, e cuja densidade e velocidade podem ser ajustadas depois;
• efeitos instantâneos — as funções fxAdd* disparam um efeito uma única vez numa posição e não deixam nada para trás;
• partículas avulsas — fxCreateParticle injeta partículas soltas num sistema de partículas do jogo, com cor, tamanho e duração definidos por você.

Estas 20 funções existem somente no cliente. Chamá-las de um script de servidor resulta em erro de valor nulo.

Efeitos contínuos

Um efeito contínuo é um elemento de verdade: ele aparece em getElementType como "effect", aceita setElementPosition e setElementRotation, e some com destroyElement. Todos os efeitos criados por um resource são destruídos quando ele para.

Quando um argumento inválido é passado — um elemento que não é um efeito, um efeito já destruído — a função devolve false e escreve o motivo no console de debug.

createEffect Cria um efeito de partículas contínuo numa posição do mundo.

getEffectDensity Lê a densidade atual de um efeito.

setEffectDensity Altera quantas partículas o efeito emite.

getEffectSpeed Lê a velocidade atual de um efeito.

setEffectSpeed Altera a velocidade com que o efeito é reproduzido.

Efeitos instantâneos

As funções fxAdd* disparam um efeito uma única vez, na hora, numa posição do mundo. Elas não criam elemento nenhum: não há o que guardar, alterar ou destruir depois.

Todas devolvem true quando o efeito foi disparado e false quando o jogo ainda não está desenhando o mundo — por exemplo, antes de o jogador entrar nele. Esse caso não escreve nada no console de debug. Os únicos avisos vêm de fxAddSparks, fxAddDebris e fxAddGlass, quando um dos argumentos opcionais tem o tipo errado.

Sobre os números de ajuste

Os argumentos numéricos de intensidade (brilho, forca, escala, abertura, duracao, intensidadeDaFumaca) são multiplicadores repassados direto ao motor de partículas. Eles não têm unidade nem faixa fixa: o padrão 1 corresponde ao efeito normal. O jeito de acertar é testar em jogo.

O vetor dx, dy, dz presente na maioria delas é a direção em que o efeito é lançado, e não um segundo ponto no mundo.

fxAddBlood Espirra sangue numa posição.

fxAddWood Lasca de madeira, como quando um tiro acerta uma caixa ou uma cerca.

fxAddGlass Estilhaços de vidro coloridos.

fxAddDebris Detritos coloridos, como os cacos que sobram de uma explosão.

fxAddSparks Chuva de faíscas.

fxAddBulletImpact Impacto de bala: fumaça e faíscas no ponto atingido.

fxAddPunchImpact Impacto de soco.

fxAddGunshot Fogo de boca de arma, opcionalmente com faíscas.

fxAddTankFire Disparo de canhão de tanque.

fxAddTyreBurst Pneu estourando.

fxAddWaterHydrant Jato de hidrante.

fxAddWaterSplash Respingo de água, do tamanho de algo caindo na água.

fxAddBulletSplash Respingo pequeno, de uma bala entrando na água.

fxAddFootSplash Respingo de passo em água rasa.

Partículas avulsas

fxCreateParticle Injeta partículas soltas num sistema de partículas do jogo, com cor, tamanho e duração escolhidos por você.