onElementDataChange

Disparado quando um dado de elemento é escrito ou removido.

Origem

O elemento cujo dado mudou.

Parâmetros

Posição	Nome	Tipo	Descrição
1	chave	string	Nome do dado.
2	valorAntigo	any	Valor anterior, ou nil quando a chave ainda não existia.
3	valorNovo	any	Novo valor, ou nil quando a chave foi removida.

Cancelável

Sim.

Se cancelado, o valor antigo é restaurado e setElementData / removeElementData devolvem false.

O evento só dispara quando algo de fato mudou. Escrever o valor que a chave já tem, ou remover uma chave que não existia, não muda nada: sem evento, sem pacote, e o setElementData devolve false.

É aqui também que você fiscaliza as escritas do cliente

Uma escrita vinda de um cliente dispara este evento igual a uma do servidor, e cancelá-la desfaz o valor e reenvia o verdadeiro àquele cliente. Uma chave aberta com confiancaDoCliente = "allow" deve ser validada aqui — veja o setElementData.

A escrita já passou pela conferência de confiança neste ponto. Uma escrita que foi recusada nunca chega aqui; ela dispara o onPlayerChangesProtectedData em vez disso.

Exemplo

addEventHandler("onElementDataChange", root, function(chave, antigo, novo)
    if chave == "dinheiro" and type(novo) == "number" and novo < 0 then
        cancelEvent(true, "saldo negativo")
    end
end)

-- limitando um valor que o cliente tem permissão de escrever
addEventHandler("onElementDataChange", root, function(chave, antigo, novo)
    if chave == "sensibilidadeMira" then
        local n = tonumber(novo)
        if not n or n < 0.1 or n > 3.0 then cancelEvent(true, "fora do intervalo") end
    end
end)

Veja também

• onElementCreated — Disparado assim que um elemento é criado, logo depois de o servidor avisar os clientes sobre ele.
• onElementDestroy — Disparado quando um elemento está sendo destruído.
• onElementModelChange — Disparado quando setElementModel muda o modelo de um elemento.
• onElementDimensionChange — Disparado quando a dimensão de um elemento muda de verdade.
• onElementInteriorChange — Disparado quando o interior de um elemento muda de verdade.
• onElementClicked — Disparado quando um jogador clica em cima de um elemento.
• onElementAttach — Disparado quando attachElements prende um elemento a outro.
• onElementDetach — Disparado quando detachElements solta um elemento.