addEvent

Cria um evento novo, para que ele possa ser disparado com triggerEvent.

Sintaxe

bool addEvent ( string nomeDoEvento [, bool permitirRemoto = false ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
nomeDoEvento	string	—	Nome do evento.
permitirRemoto	bool	false	Se true, clientes podem disparar este evento no servidor.

Retorno

true se o evento foi registrado — ou já estava, com o mesmo permitirRemoto. false se o nome estiver vazio, ou se o evento já existir com o outro valor de permitirRemoto; nesse segundo caso o servidor também registra um aviso, o cliente não.

Cuidado

Só marque permitirRemoto como true quando o evento realmente precisar vir do cliente, e valide tudo o que chegar. Um evento remoto é uma porta aberta: qualquer jogador pode chamá-lo com os argumentos que quiser.

Exemplo

addEvent("onDinheiroAlterado", false)   -- só o servidor dispara
addEvent("onLojaComprar", true)         -- o cliente pode disparar

Veja também

• addEventHandler — Registra uma função para rodar quando um evento dispara.
• removeEventHandler — Desfaz um addEventHandler.
• getEventHandlers — Lista os manipuladores que o seu resource anexou a um elemento.
• triggerEvent — Dispara um evento no lado que o chama.
• cancelEvent — Cancela o evento em execução.
• wasEventCancelled — Diz se um evento foi cancelado — o que está rodando, no servidor; o último que terminou, no cliente.
• getCancelReason — Devolve o motivo passado ao cancelEvent.