setElementData
Servidor
Guarda um dado num elemento e, conforme o sync, envia aos jogadores.
Também existe no cliente, com outra implementação: setElementData
bool setElementData(element element, string key, any value [, bool|string sync = true])
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
| element | element | O elemento. |
| key | string | Nome do dado. Chaves com mais de 128 caracteres são cortadas, com um aviso. |
| value | any | O valor a guardar. |
| sync | bool|string | true ou "broadcast" envia a todos os jogadores; false ou "local" fica só no servidor; "subscribe" envia só aos jogadores inscritos com addElementDataSubscriber. Outro valor dá erro.padrão true |
Retorno
true se guardou, false se o elemento já tinha esse valor com esse sync, se um handler cancelou a mudança ou se o valor é grande demais para sincronizar.
Dispara onElementDataChange. Cancelar o evento devolve o valor anterior. Ao trocar para "subscribe" um dado que já existia, os inscritos continuam.
Exemplo
addEventHandler("onPlayerJoin", root, function()
setElementData(source, "money", 500)
setElementData(source, "admin.notes", "", "local")
end)AtençãoUm valor que passa de 10 MB ou de 1048576 valores não é sincronizado: a função registra um erro e devolve
false.