Instancias en el escenario y jerarquías

Introducción: El molde conceptual y la entidad física en el mundo de juego

Uno de los tropiezos más comunes al iniciarse en el desarrollo con GameMaker —y en la programación orientada a videojuegos en general— radica en confundir la definición de una entidad con la entidad viva dentro de la escena. Con frecuencia se escuchan expresiones como «puse el objeto jugador en la coordenada X» o «el objeto moneda desapareció cuando lo toqué». Aunque en una conversación cotidiana se entiende la idea, en términos técnicos y de arquitectura de software, esas afirmaciones son inexactas y pueden originar errores graves de programación cuando se escriben scripts en GML (GameMaker Language). En las lecciones previas aprendiste a crear sprites e integrarlos en objetos, así como a programar comportamientos básicos en los eventos Create, Step y Destroy. Sin embargo, todo lo configurado dentro del Asset Browser representa únicamente un molde, una especificación teórica o un plano arquitectónico. El objeto, por sí mismo, no existe en el espacio de juego: no tiene una coordenada en pantalla, no consume ciclos de dibujo en el motor de renderizado ni colisiona con nada mientras permanezca guardado en el panel de recursos. Para que cobre vida, dicho molde debe materializarse dentro de un escenario (Room). Esa materialización concreta es lo que llamamos una instancia.

Distinción fundamental: Objeto vs. Instancia

Para interiorizar esta distinción de forma definitiva, podemos utilizar la analogía clásica de la pastelería o la arquitectura. Imagina un cortador de galletas de metal con silueta de estrella. El cortador define la forma, los bordes y las dimensiones ideales de la estrella, pero el cortador no es comestible ni ocupa espacio en una bandeja de horno. La masa horneada resultante de presionar el molde es la galleta real: puedes espolvorearla con azúcar, cubrirla con chocolate o comértela de un bocado sin destruir el cortador de metal. Si destruyes una galleta, el molde sigue intacto en tu cajón para hornear cientos más. En GameMaker, el recurso que creas en el Asset Browser bajo el prefijo `obj_` (por ejemplo, `obj_coin` u `obj_block`) es el cortador de galletas o el plano arquitectónico. Contiene el código fuente que dictará cómo deben comportarse las entidades creadas a partir de él, qué sprite mostrarán por defecto y a qué eventos responderán. Por otro lado, la instancia es cada una de las copias físicas e independientes que arrastras a la Room o que creas dinámicamente mediante código en tiempo de ejecución. Cada instancia ocupa un lugar específico en la memoria RAM del ordenador, posee una posición precisa (definida por sus variables internas `x` e `y`), y tiene asignado un identificador único numérico llamado `id`.

Esta separación tiene consecuencias críticas directas sobre la lógica en GML Code. Considera la siguiente situación: tienes cincuenta monedas repartidas en el nivel. Si ejecutas una instrucción que haga referencia al nombre del objeto global (`obj_coin`), podrías estar afectando a todas las monedas a la vez de forma imprevista o leyendo los datos de una de ellas de manera arbitraria. En cambio, si interactúas con la referencia a una instancia específica (su `id`), actuarás exclusivamente sobre esa moneda en particular (por ejemplo, hacer que esa única moneda explote en chispas al ser recolectada mientras las otras cuarenta y nueve continúan flotando en el escenario).

Colocación de instancias en la Room: Métodos y capas

El escenario de juego en GameMaker se denomina **Room**. Dentro de ella confluyen todos los elementos visuales y funcionales del nivel. Sin embargo, no es posible soltar elementos de manera caótica; GameMaker organiza el contenido del escenario mediante un sistema riguroso de capas (**Layers**), visible en el inspector lateral izquierdo del Room Editor. Para colocar una instancia en el escenario, la Room debe contar obligatoriamente con al menos una capa de tipo **Instance Layer** (Capas de Instancias). Por defecto, al crear una nueva Room, GameMaker genera automáticamente una capa llamada `Instances` y otra de fondo llamada `Background`. Si intentas arrastrar un objeto desde el Asset Browser hacia una capa de fondos (Background Layer) o una capa de mosaicos (Tile Layer), el editor mostrará un cursor de prohibición o bloqueará la acción, ya que esas capas no poseen la infraestructura interna para ejecutar código ni procesar eventos de ciclo de vida.

Para situar instancias con máxima precisión dentro del mundo de juego, existen varias técnicas en el Room Editor: 1. **Arrastrar y soltar clásico (Drag & Drop):** Haz clic sostenido sobre el objeto deseado dentro del Asset Browser (por ejemplo, `obj_block`) y arrástralo directamente sobre el lienzo de la Room, asegurándote de que la capa `Instances` esté seleccionada. Al soltar el botón del ratón, la instancia quedará anclada en esas coordenadas. 2. **Colocación rápida continua (Atajo Alt):** Si necesitas construir una hilera continua de suelo o una hilera de ladrillos para el videojuego de plataformas, arrastrar los objetos uno por uno resulta lento y tedioso. En GameMaker moderno, si seleccionas el objeto en el Asset Browser o en la paleta de la capa y mantienes presionada la tecla **Alt** (en Windows) u **Option** (en macOS) mientras haces clic o arrastras el cursor sobre el lienzo de la Room, estamparás instancias de forma continua como si utilizaras una brocha de pintura. 3. **Borrado rápido:** Manteniendo presionada la combinación **Alt + Clic derecho** (o seleccionando con el marco de selección y pulsando la tecla *Supr / Delete*), eliminarás inmediatamente las instancias situadas bajo el cursor sin alterar el resto de elementos del nivel.

💡 Comprobación de la rejilla (Grid): Para un juego de plataformas con estética retro, sitúa siempre la rejilla de la Room en dimensiones proporcionales a tus sprites (por ejemplo, 16x16 o 32x32 píxeles). Puedes alternar la visibilidad de la rejilla y el ajuste automático (Snap to Grid) mediante el menú superior del Room Editor. Esto evitará fisuras milimétricas entre plataformas que provocarían fallos en la detección de colisiones de tus personajes.

Propiedades individuales de las instancias en el Room Editor

Cuando una instancia ya forma parte del lienzo de la Room, deja de ser un clon estático y se convierte en una entidad parametrizable. Si haces doble clic sobre cualquier instancia colocada en el escenario, o si la seleccionas y abres la pestaña de inspección (**Inspector Panel**), accederás a sus propiedades locales e individuales. GameMaker expone un conjunto de variables internas que gobiernan el aspecto y la ubicación de esa instancia sin necesidad de alterar una sola línea de código en el objeto base. Estas variables son:

• **X e Y:** Coordenadas en píxeles dentro del plano cartesiano de la Room. En GameMaker, el origen `(0, 0)` se ubica en la esquina superior izquierda. Valores crecientes de `X` desplazan la entidad hacia la derecha; valores crecientes de `Y` la desplazan hacia abajo. • **Scale (image_xscale e image_yscale):** Multiplicadores de escala geométrica. Un valor de `1.0` representa el tamaño original del sprite en píxeles. Si estableces `image_xscale = 2.0`, la instancia duplicará su anchura. Si introduces un valor negativo, como `-1.0`, la instancia invertirá horizontalmente su orientación (efecto espejo), lo cual resulta muy útil para situar enemigos o elementos decorativos que miran hacia la izquierda desde el propio editor. • **Rotation (image_angle):** Grado de inclinación angular expresado en grados (0° a 360°), en sentido antihorario. Modificar esta propiedad en el editor rotará el sprite alrededor del origen establecido en el Sprite Editor. • **Colour Tint (image_blend):** Filtro de color de tinción aplicado sobre el sprite. Por defecto es blanco puro (`c_white` o `#FFFFFF`), lo que significa que el sprite se dibuja con sus colores originales. Si cambias el tinte de una instancia concreta de `obj_coin` a un tono rojo o púrpura, GameMaker multiplicará los canales cromáticos de esa instancia en particular, permitiéndote crear variantes visuales sin importar nuevos gráficos a la memoria. • **Alpha (image_alpha):** Nivel de opacidad que va desde `1.0` (completamente sólido y visible) hasta `0.0` (totalmente invisible y transparente).

Instance Creation Code y personalización avanzada

Modificar el aspecto físico mediante escalas o colores resulta conveniente, pero la verdadera potencia del diseño de niveles radica en modificar el **comportamiento lógico** de cada instancia individual. GameMaker ofrece dos métodos fundamentales para lograrlo: **Variable Definitions** y el **Instance Creation Code**. El **Instance Creation Code** es un bloque de script escrito en GML que se ejecuta de manera exclusiva para esa instancia en específico. Es fundamental comprender el orden cronológico en el que GameMaker inicializa una escena: cuando la Room arranca, primero se ejecuta el evento **Create** general del objeto; inmediatamente después, si esa instancia concreta tiene código en su *Creation Code*, dicho código se ejecuta, permitiendo sobreescribir las variables que se habían inicializado un instante antes en el evento Create.

Para abrir el Creation Code de una instancia, selecciónala en la Room, localiza el panel del Inspector y haz clic en el botón rotulado como **Creation Code**. Se abrirá una ventana de edición de código limpia asociada únicamente a esa entidad en la escena.

// -------------------------------------------------------------------------
// UBICACIÓN: Room Editor -> Clic en una instancia concreta de obj_moving_platform
// VENTANA: Instance Creation Code
// PROPÓSITO: Sobrescribir variables de patrullaje para esta plataforma específica
// -------------------------------------------------------------------------

// Por defecto, en el Create Event de obj_moving_platform definimos:
// move_speed = 2;
// travel_distance = 64;

// Aquí, para esta plataforma en particular situada en un abismo ancho:
move_speed = 3.5;
travel_distance = 256;
horizontal_direction = -1; // Comienza moviéndose hacia la izquierda

La ventaja de este mecanismo es evidente: no necesitas crear diez objetos distintos en el Asset Browser (`obj_plataforma_rapida`, `obj_plataforma_lenta`, `obj_plataforma_larga`). Creas un único objeto arquitectónico genérico (`obj_moving_platform`), y personalizas su comportamiento en el mapa mediante parámetros individuales en cada nivel.