Esta página aún no está traducida: se muestra la versión en inglés.

Collision

Vincula un transform al mapa de obstáculos y declara qué pasa al haber contacto. El módulo Collision se ejecuta dentro de la simulación de la plataforma. Declaras cuerpos, capas y respuestas, y te suscribes a los contactos.

Cuándo usarlo

• Las entidades en movimiento tienen que resolver los contactos del lado del servidor (deslizarse, detenerse, rebotar) sin una rutina de desvío escrita a mano.
• El gameplay reacciona al contacto: los objetos recolectables se recogen al superponerse y los volúmenes de activación disparan la máquina de estados de una entidad.
• El módulo Locomotion y los proyectiles necesitan una resolución por barrido contra el conjunto de obstáculos del mapa.
• Las vistas previas de colocación o el apuntado necesitan consultas del tipo “¿cabe esto aquí?” y de superposición de volúmenes.
• No lo uses si nada se encuentra físicamente. Para un gameplay de solicitud y respuesta sobre registros basta con Data & Subscriptions.

Quién hace qué

En resumen

La forma, la capa y lo que pasa al haber contacto se declaran en el propio cuerpo — nada declara pares de capas desde otro lugar:

[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;
}

Un contacto es un evento, y los módulos se suscriben a él. No hay hook sobre un contacto: para cuando existe, el paso ya lo resolvió, así que no queda nada que rechazar. Si un estudio necesita otras reglas, sobrescribe las comprobaciones de admisibilidad y de trayectoria con su propia implementación — consulta Extensibility — y la respuesta sigue declarada.

El modelo

Qué declara un cuerpo.

La respuesta se declara por par — el tipo de transitabilidad de un obstáculo × un tipo de cuerpo — y sale de un conjunto cerrado:

Los coeficientes son valores declarados, no se calculan a partir de masas y materiales — este contrato no tiene ni lo uno ni lo otro.

Qué se cumple en toda comprobación.

Errores

• “Inadmisible” es una respuesta, no un error, e indica cuál de tres motivos aplica: fuera de los límites, ocupado por un obstáculo estático u ocupado por el cuerpo de otra entidad. El cliente reacciona distinto a cada uno: dar la vuelta, rodear o esperar.
• Las fallas de declaración aparecen en el deploy, nunca en el primer contacto: un cuerpo con una forma fuera del conjunto cerrado, un cuerpo en un aspecto sin transform y un par sin respuesta declarada se rechazan al desplegar.
• Si no se encuentra la entidad o la ubicación, la respuesta es not found, y repetir no sirve de nada.
• Si se supera la frecuencia de comprobaciones, la respuesta cae en la categoría de rate limit, con el plazo antes del cual no tiene sentido reintentar.

Límites

Los números llegarán con el capítulo de límites de la plataforma; lo que pasa en cada tope ya está definido.

• Cuerpos en una sala: declarar uno más se rechaza como conflicto; nunca se eliminan cuerpos existentes para hacer lugar.
• Contactos por paso: el excedente nunca se descarta en silencio. O se rechaza el paso, o el orden de corte está declarado.
• Tamaño de un cuerpo frente al paso de la cuadrícula del mapa: se rechaza en el deploy, porque un cuerpo más pequeño que el paso del campo de alturas se cae a través del terreno.
• Áreas en las que puede estar un cuerpo a la vez: el exceso se rechaza en el deploy.
• Frecuencia de comprobaciones por actor: un rate limit con plazo.
• Cuerpos en una respuesta a “¿quién está en esta área?”: se truncan según un orden declarado, y el indicador de truncamiento es obligatorio.