Física

El motor incluye un sistema de física 2D con detección de colisiones. Se ejecuta en la fase de física del bucle de juego. La física se construye a partir de tres piezas:

• Los colisionadores definen la forma de colisión de una entidad y la capa a la que pertenece.
• El RigidBody hace que una entidad se mueva bajo velocidad, aceleración y gravedad.
• El CollisionRepository permite a los sistemas consultar qué colisionadores están colisionando actualmente.

RigidBody

El componente RigidBody habilita el movimiento físico de una entidad. Hay tres tipos de cuerpo:

Un RigidBody funciona junto con un colisionador en la misma entidad. Para hacer que una entidad se mueva y colisione, agrega tanto un colisionador como un RigidBody:

import { Transform, RigidBody, RigidBodyType, BoxCollider } from "angry-pixel";

this.entityManager.createEntity([
    new Transform(),
    new BoxCollider({ width: 16, height: 16, layer: "Player" }),
    new RigidBody({ type: RigidBodyType.Dynamic, gravity: 1000 }),
]);

Colisionadores

Un colisionador define una forma de colisión. El motor proporciona cinco componentes de colisionador:

Todos los colisionadores comparten estas opciones:

Cada forma agrega sus propias opciones; por ejemplo, BoxCollider tiene width, height y rotation; BallCollider tiene radius. Consulta Componentes integrados para las opciones completas de cada colisionador.

Se puede agregar un colisionador sin un RigidBody cuando una entidad solo necesita detección de colisiones, como un muro estático:

import { Transform, BoxCollider } from "angry-pixel";

this.entityManager.createEntity([
    new Transform(),
    new BoxCollider({ width: 64, height: 16, layer: "Wall" }),
]);

Cuando physics es true, el colisionador participa en la resolución física con los cuerpos rígidos. Cuando es false, solo se usa para la detección de colisiones, útil para disparadores y sensores que informan de solapamientos sin empujar a otros cuerpos.

Capas de colisión

Cada colisionador pertenece a una capa. Qué capas pueden colisionar se configura con la matriz de colisiones en la configuración del juego. Consulta La clase Game.

collisions: {
    collisionMatrix: [
        ["Player", "Enemy"],
        ["Player", "Wall"],
    ],
}

Con esta matriz, los jugadores colisionan con los enemigos y los muros, pero los enemigos y los muros no colisionan entre sí.

Un colisionador también puede excluirse de capas concretas con ignoreCollisionsWithLayers.

Consultar colisiones

El CollisionRepository informa de las colisiones detectadas en el frame actual. En los sistemas que extienden GameSystem está disponible como this.collisionRepository. Consulta Componentes y sistemas personalizados.

import { GameSystem, BoxCollider } from "angry-pixel";
import { Player } from "../component/Player";

export class PlayerCollisionSystem extends GameSystem {
    onUpdate() {
        this.entityManager.search(Player, (player, entity) => {
            const collider = this.entityManager.getComponent(entity, BoxCollider);
            const collisions = this.collisionRepository.findCollisionsForColliderAndLayer(collider, "Enemy");

            for (const collision of collisions) {
                // reaccionar al golpear a un enemigo
            }
        });
    }
}

Cada Collision contiene: