Esta página ainda não foi traduzida: mostrando a versão em inglês.

Collision

Vincule um transform ao mapa de obstáculos e declare o que acontece no contato. O módulo Collision roda dentro da simulação da plataforma. Você declara corpos, camadas e respostas e assina os eventos de contato.

Quando usar

• Entidades em movimento precisam resolver contatos no servidor (deslizar, parar, quicar) sem uma rotina de desvio escrita à mão.
• O gameplay reage ao toque: itens coletáveis são recolhidos na sobreposição, e volumes de trigger disparam a máquina de estados de uma entidade.
• O módulo Locomotion e os projéteis precisam de resolução por varredura (swept) contra o conjunto de obstáculos do mapa.
• A prévia de posicionamento ou a mira precisam perguntar “isso cabe aqui?” e consultar a sobreposição de volumes.
• Dispensável quando nada se encontra fisicamente. Para gameplay de requisição e resposta sobre registros, basta o Data & Subscriptions.

Quem faz o quê

Resumo

A forma, a camada e o que acontece no contato ficam no próprio corpo — nada declara pares de camadas à distância:

[Entity("tank")]
public class Tank
{
    [Sync] public Vector3 Position;

    [Body(Shape.Capsule, Radius = 0.6f, Layer = "vehicles")]
    [CollidesWith("walls", Response.Slide)]
    [CollidesWith("pickups", Response.Pass)]        // reported, motion passes through
    public Body Body;
}

@Entity('tank')
export class Tank {
  @Sync() position!: Vector3;

  @Body({ shape: 'capsule', radius: 0.6, layer: 'vehicles' })
  @CollidesWith('walls', Response.Slide)
  @CollidesWith('pickups', Response.Pass)        // reported, motion passes through
  body: Body;
}

@entity("tank")
class Tank:
    position: Vector3 = sync()

    body = collision.body(shape="capsule", radius=0.6, layer="vehicles",
                           collides_with=[
                               ("walls", Response.SLIDE),
                               ("pickups", Response.PASS),   # reported, motion passes through
                           ])

// the declaration rides inside the engine's own reflection macros, in the specifier position —
// UHT reads it from the header text, and the member is a reflected property at the same time
UCLASS(PSEntity = "tank")
class UTank : public UObject
{
    GENERATED_BODY()

    UPROPERTY(PSSync)
    FVector3f Position;

    // walls slide, pickups report the contact and let motion pass through —
    // multi-entry values are one quoted list (a specifier value is a single token)
    UPROPERTY(PSBody = (Shape = "Capsule", Radius = "0.6", Layer = "vehicles"),
              PSCollidesWith = "walls:Slide, pickups:Pass")
    FPSBody Body;
};
// declarations compile into the same pushed model — playserv push from the UE project or CI

[Entity("tank")]
public class Tank
{
    [Sync] public Vector3 Position;

    [Body(Shape.Capsule, Radius = 0.6f, Layer = "vehicles")]
    [CollidesWith("walls", Response.Slide)]
    [CollidesWith("pickups", Response.Pass)]        // reported, motion passes through
    public Body Body;
}

Um contato é um evento, e os módulos o assinam. Não existe hook no contato: quando ele passa a existir, o passo da simulação já o resolveu e não sobra nada para rejeitar. Se um estúdio precisa de regras diferentes, ele sobrescreve as verificações de admissibilidade e de trajetória com uma implementação própria — veja Extensibility — e a resposta continua declarada.

O modelo

O que um corpo declara.

A resposta é declarada por par — o tipo de passabilidade do obstáculo × o tipo de corpo — e vem de um conjunto fechado:

Os coeficientes são valores declarados, não calculados a partir de massas e materiais — este contrato não tem nem uma coisa nem outra.

O que vale para toda verificação.

Erros

• “Inadmissível” é uma resposta, não um erro, e diz qual dos três motivos se aplica: fora dos limites, ocupado por um obstáculo estático ou ocupado pelo corpo de outra entidade. O cliente reage a cada um de um jeito: dar meia-volta, contornar ou esperar.
• Falhas de declaração aparecem no deploy, nunca no primeiro contato: um corpo com forma fora do conjunto fechado, um corpo em um aspecto sem transform e um par sem resposta declarada são todos recusados no deploy.
• Entidade ou local inexistente responde not found, e não adianta repetir.
• Taxa de verificações excedida responde na categoria de rate limit, com o prazo antes do qual não adianta tentar de novo.

Limites

Os números chegam com o capítulo de limites da plataforma; o que acontece em cada teto já está definido.

• Corpos em uma sala: declarar mais um é recusado como conflito; corpos existentes nunca são removidos para abrir espaço.
• Contatos por passo: o excedente nunca é descartado em silêncio. Ou o passo é recusado, ou a ordem de corte é declarada.
• Tamanho do corpo em relação ao passo da grade do mapa: recusado no deploy, porque um corpo menor que o passo do campo de altura cai através do terreno.
• Áreas em que um corpo pode estar ao mesmo tempo: o excesso é recusado no deploy.
• Taxa de verificações por ator: rate limit com prazo.
• Corpos em uma resposta a “quem está nesta área?”: truncados por uma ordem declarada, e o indicador de truncamento é obrigatório.