setObjectFractureProfile

Arma um objeto para fraturar quando a sua vida de fratura acaba.

Definir um perfil dá ao objeto uma vida de fratura separada da vida normal. O dano reportado contra o objeto é escalado pelo multiplicador e subtraído dessa vida; quando ela chega a zero — ou um único golpe alcança o limiar de quebra instantânea — o servidor fratura o objeto sozinho, disparando onObjectFracture no caminho. Cancelar aquele evento remonta o objeto.

Sintaxe

bool setObjectFractureProfile ( object oObjeto [, table opcoes ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
oObjeto	object	—	O objeto a armar.
opcoes	table	—	Qualquer mistura dos campos abaixo; deixe de fora para todos os padrões.

A tabela opcoes aceita:

Campo	Tipo	Padrão	Descrição
health	number	40	Vida de fratura com que o objeto começa, limitada a 0–1000000.
damageMultiplier	number	1	Cada ponto de dano reportado é escalado por isto, limitado a 0–1000.
instantBreakThreshold	number	999999	Uma única perda pelo menos tão grande fratura o objeto de imediato, limitada a 0–1000000. O padrão desliga a quebra instantânea.

Retorno

true quando o perfil foi aplicado — ele substitui qualquer anterior, devolve a vida de fratura ao novo health e é enviado aos clientes. Devolve false, com um aviso no console de debug, quando o primeiro argumento não é um objeto.

A vida de fratura só se move por dano reportado — setObjectFractureHealth a escreve à mão, resetObjectFractureHealth a recupera, e clearObjectFractureProfile desarma o objeto.

Exemplo

-- vidro que cede depois de cerca de 100 de dano
setObjectFractureProfile(janela, {
    health = 100,
    damageMultiplier = 1,
    instantBreakThreshold = 60   -- um único golpe forte atravessa direto
})

Veja também

• createObjectFracture — Quebra um objeto em fragmentos que todos podem ver.
• restoreObjectFracture — Desfaz uma fratura, destruindo seus fragmentos e revelando o objeto de origem.
• getObjectFractureProfile — Devolve o perfil de fratura de um objeto.
• clearObjectFractureProfile — Remove o perfil de fratura de um objeto.
• getObjectFractureHealth — Devolve a vida de fratura restante de um objeto.
• setObjectFractureHealth — Define a vida de fratura restante de um objeto.
• resetObjectFractureHealth — Devolve a vida de fratura de um objeto ao valor do perfil.