La clase Game

La clase Game es el punto de entrada principal para crear y administrar una instancia de juego en Angry Pixel Engine.
Actúa como el coordinador central que gestiona:

Escenas.
Entidades.
Componentes.
Managers (renderizado, físicas, entrada, etc.).

Además, proporciona métodos para configurar el juego, agregar escenas y dependencias, y controlar el ciclo de ejecución (game loop).

Constructor

new Game(config: GameConfig)

El constructor recibe un objeto GameConfig que permite definir:

El nodo HTML donde se renderizará el juego (containerNode).
Dimensiones (width, height).
Opcional: ajustes de físicas, colores, métodos de colisiones, etc.

Ejemplo básico

const game = new Game({
    containerNode: document.getElementById("app"),
    width: 1920,
    height: 1080,
});

game.addScene(MainScene, "MainScene", true);
game.start();

Ejemplo avanzado

const game = new Game({
    containerNode: document.getElementById("app"),
    width: 1920,
    height: 1080,
    debugEnabled: false,
    canvasColor: "#000000",
    physicsFramerate: 180,
    collisions: {
        collisionMatrix: [
            ["layer1", "layer2"],
            ["layer1", "layer3"],
        ],
        collisionMethod: CollisionMethods.SAT,
        collisionBroadPhaseMethod: BroadPhaseMethods.SpartialGrid,
    },
});

game.addScene(MainScene, "MainScene", true);
game.start();

Detalle de GameConfig

El objeto GameConfig permite personalizar cómo se inicializa el juego.
A continuación, se describen todas las propiedades disponibles:

Propiedad	Tipo	Descripción
`containerNode`	HTMLElement	Nodo HTML donde se renderizará el juego. Obligatorio.
`width`	number	Ancho del juego en píxeles. Obligatorio.
`height`	number	Alto del juego en píxeles. Obligatorio.
`debug`	object (opcional)	Opciones de depuración. Permite mostrar colisionadores, posición del mouse y otros datos durante la ejecución.
`debug.colliders`	boolean	Mostrar colisionadores.
`debug.mousePosition`	boolean	Mostrar la posición del mouse.
`debug.collidersColor`	string	Color de los colisionadores. Predeterminado: `#00FF00` (verde).
`debug.textColor`	string	Color de los textos de depuración. Predeterminado: `#00FF00`.
`debug.textPosition`	string	Posición del texto de depuración: `"top-left"`, `"top-right"`, `"bottom-left"` o `"bottom-right"`.
`canvasColor`	string	Color de fondo del canvas. Predeterminado: `#000000` (negro).
`physicsFramerate`	number	Frecuencia de actualización de físicas. Valores permitidos: `60`, `120`, `180` o `240`. Predeterminado: `180`.
`headless`	boolean	Activa el modo “headless”. Desactiva entrada y renderizado (ideal para servidores).
`dependencies`	Array	Lista de dependencias externas que se inyectarán mediante dependency injection.
`collisions`	object (opcional)	Opciones de configuración de colisiones.
`collisions.collisionMethod`	CollisionMethods	Método de detección de colisiones: `SAT` o `ABB`. Predeterminado: `SAT`.
`collisions.collisionMatrix`	Array	Matriz que define qué capas pueden colisionar entre sí.
`collisions.collisionBroadPhaseMethod`	BroadPhaseMethods	Método de “broad phase”: `QuadTree` o `SpartialGrid`. Predeterminado: `SpartialGrid`.

Nota: Si no se especifican algunas opciones, el motor usará los valores predeterminados recomendados.

Métodos

`addScene(sceneType, name, openingScene = false)`

Agrega una nueva escena al juego.

sceneType: la clase de la escena.
name: nombre para identificar la escena.
openingScene: si es true, esta será la primera escena al iniciar el juego.

Ejemplo:

game.addScene(MainScene, "MainScene", true);

`addDependencyType(dependencyType, name?)`

Agrega una clase que será usada como dependencia.

dependencyType: clase de la dependencia.
name: nombre de la dependencia (opcional si la clase usa el decorador injectable).

Ejemplo:

game.addDependencyType(MyCustomService);

`addDependencyInstance(dependencyInstance, name)`

Agrega una instancia específica como dependencia.

dependencyInstance: instancia a usar.
name: nombre de la dependencia.

Ejemplo:

game.addDependencyInstance(myDatabaseInstance, "Database");

`start()`

Inicia el juego y comienza el ciclo de actualización (game loop).

game.start();

`stop()`

Detiene el ciclo de actualización del juego.

game.stop();

Propiedades

`running`

Devuelve true si el juego está actualmente en ejecución.

if (game.running) {
    console.log("El juego está corriendo");
}

Resumen

La clase Game es responsable de:

✅ Inicializar la configuración y dependencias.
✅ Gestionar escenas.
✅ Controlar el ciclo de vida del juego (inicio y detención).
✅ Proveer un punto central para personalizar el comportamiento del motor.

Nota: Internamente, Game utiliza dependency injection para inicializar y comunicar todos los sistemas de juego.