Objetos

Objetos são os modelos livres que você espalha pelo mundo: rampas, caixas, portões, móveis. Eles existem no servidor e são replicados para todos os jogadores, inclusive para quem entrar depois.

As funções que recebem coordenadas aceitam tanto números soltos quanto um Vector3 no lugar deles — createObject(1337, Vector3(x, y, z)) e moveObject(obj, 2000, Vector3(x, y, z)) funcionam normalmente. setObjectScale também aceita um Vector3 no lugar dos três fatores.

Um objeto também pode ser entregue ao motor de física — veja a física dinâmica abaixo.

Os objetos criados por um resource são destruídos junto com ele.

Estas 20 funções existem no servidor e no cliente. Você pode usá-las em scripts declarados em server_files, client_files ou shared_files.

createObject Cria um objeto no mundo.

moveObject Move e gira um objeto suavemente ao longo de um intervalo de tempo.

Curvas de suavização

No servidor o nome não diferencia maiúsculas de minúsculas; no cliente ele precisa ser escrito exatamente como na tabela ("InOutQuad", não "inoutquad").

Linear	InQuad	OutQuad
InOutQuad	OutInQuad	InElastic
OutElastic	InOutElastic	OutInElastic
InBack	OutBack	InOutBack
OutInBack	InBounce	OutBounce
InOutBounce	OutInBounce	SineCurve
CosineCurve

Os argumentos periodo e amplitude só têm efeito nas curvas Elastic; excesso só afeta as curvas Back.

Exemplo

-- portão que sobe em 3 segundos
local portao = createObject(980, 1544.0, -1353.0, 328.0)

addCommandHandler("abrir", function()
    moveObject(portao, 3000, 1544.0, -1353.0, 334.0)
end)

-- plataforma que gira meia volta enquanto atravessa a sala
moveObject(plataforma, 5000, 2050.0, 1400.0, 10.0, 0, 0, 180, "InOutQuad")

stopObject Interrompe o movimento de um objeto no meio do caminho.

isObjectMoving Verifica se um objeto está no meio de um movimento.

breakObject Quebra um objeto, tocando a animação de destruição.

respawnObject Recria o objeto no estado em que foi criado, na posição e rotação originais.

toggleObjectRespawn Liga ou desliga o respawn automático de um objeto depois que ele é quebrado.

isObjectRespawnable Verifica se um objeto reaparece sozinho depois de quebrado.

getObjectScale Devolve a escala de um objeto, eixo por eixo.

setObjectScale Redimensiona um objeto.

isObjectBreakable Verifica se um objeto pode ser quebrado.

setObjectBreakable Define se um objeto pode ou não ser quebrado.

isElementDynamicPhysics Verifica se um objeto está em física dinâmica.

setElementDynamicPhysics Liga ou desliga a física dinâmica de um objeto.

isObjectGravityEnabled Verifica se a gravidade de um objeto está ligada.

setObjectGravity Desliga a gravidade de um objeto ou liga de novo.

Física dinâmica

Um objeto comum fica onde você o pôs. setElementDynamicPhysics o entrega ao motor de física: ele cai, é empurrado e rola na máquina de todos os jogadores, com a máquina do jogador mais próximo do objeto conduzindo a simulação. Enquanto o estado estiver ligado, moveObject recusa o objeto — dê velocidade a ele com setElementVelocity, ou chute-o com impulseDynamicProp. Quando ele para, o servidor dispara o onDynamicObjectRest. Até max_dynamic_physics_objects deles (128 por padrão) podem ser simulados ao mesmo tempo.

Um prop dinâmico é a mesma ideia desde o nascimento: createDynamicProp cria um objeto do servidor já caindo, feito para substituir um pedaço do mapa estático, e convertDynamicProp é a versão do cliente.

Propriedades

Massa, massa de rotação, resistência do ar, elasticidade, empuxo e centro de massa são os valores de simulação do motor para um objeto. Uma mudança feita no servidor chega a todos os jogadores; uma feita num cliente fica naquela máquina.

Nome	Descrição
"mass"	Massa do objeto. Não aceita valor negativo.
"turn_mass"	Massa de rotação: o quanto ele resiste a girar. Não aceita valor negativo.
"air_resistance"	Resistência do ar.
"elasticity"	O quanto ele quica ao bater.
"buoyancy"	Empuxo: o quanto ele flutua na água.
"center_of_mass"	Centro de massa, em três coordenadas relativas ao objeto.
"all"	Só na leitura: devolve todas as anteriores de uma vez, numa tabela.

Os nomes das propriedades não diferenciam maiúsculas de minúsculas.

getObjectMass Devolve a massa de um objeto.

setObjectMass Define a massa de um objeto.

getObjectProperty Lê uma propriedade física de um objeto.

setObjectProperty Altera uma propriedade física de um objeto.