Reglas sin código

Una regla es una frase: Cuando pasa algo, entonces el juego hace algo. Las armas eligiendo de listas, en el panel Reglas (Alt+6). No escribes código: lo escribe el editor.

El panel tiene tres secciones: Partida, Reglas y Bot de prueba. La tercera está explicada en Bot de prueba.

La partida#

Arriba del panel está Partida, con lo que vale para todo el juego.

Anatomía de una regla#

1. Pulsa Nueva regla.
2. En Cuando, elige el disparador y llena sus datos.
3. En Entonces, elige la acción y llena los suyos.
4. Si quieres que pase más de una cosa, pulsa + Acción. Cada acción siguiente empieza con Y. La flecha sube una acción en el orden y la × la quita.

La regla queda escrita como una frase que puedes leer para comprobar que dice lo que querías. Un clic en la frase abre o cierra la regla.

Cuando el disparador o la acción piden una pieza o una zona, puedes elegir Todo lo que tenga la etiqueta, Una pieza (o Una zona) y, en las acciones, la pieza tocada. El botón Lo elegido toma lo que tengas seleccionado en la escena.

Los textos se escriben dos veces, en español y en inglés, porque cada jugador ve el juego en su idioma.

Disparadores#

Son diez.

Los ejemplos de «toca», «entra», «llega a», «cae al vacío» y «empieza la partida» son frases reales del editor. Los demás son ideas de uso.

Acciones#

Son veintitrés.

Las reglas que traen los prefabricados#

Varios prefabricados agregan su regla cuando los colocas, y el editor avisa: «Se agregó una regla para que funcione. Mírala en Reglas.» Son reglas como cualquier otra: puedes abrirlas, cambiarlas o borrarlas.

Las reglas de moneda, peligro, meta y trampolín hablan de una etiqueta: se agregan una sola vez y valen para todas las piezas que la lleven. La segunda moneda no agrega otra regla. Si haces una caja y le pones la etiqueta peligro, también devuelve al jugador al último punto de control.

Las de los personajes y los carteles son una por copia, porque cada una nombra a su personaje o a su cartel.

Personajes#

Un personaje es alguien más en la escena, aparte del jugador: un vecino, un guardia, un amigo que te sigue. Siempre nace en un punto de aparición y se nombra por su nombre corto.

Lo más rápido es colocar uno de los tres prefabricados del grupo Personajes. Cada uno pone sus puntos de aparición en la escena y su regla en el panel:

Para cambiar la ronda, mueve los puntos de aparición en el visor como cualquier pieza, o agrega más con el prefabricado Punto de aparición y márcalos en la acción personaje: patrullar entre puntos. Hacen falta al menos dos.

Cambiar la vista#

La acción cambiar la vista (cámara y control) pasa de una vista a otra en plena partida: tercera persona, primera persona, isométrica, cenital, lateral (2D) o plano (2D desde arriba). La opción la de la escena (volver) regresa a la vista original. Segundos de la transición dice cuánto tarda el cambio.

Cambia la cámara y también la forma de moverse. Si la regla la dispara un jugador, cambia solo la suya; si no, la de todos.

Para cambiar de vista al pasar por un lugar no hace falta una regla: una zona puede traer su propio cambio de vista. Está en Tipos de juego.

Cómo las reglas se vuelven código#

Las reglas no son un sistema aparte: el editor las traduce a código, el mismo que escribiría una persona. El enlace Ver el código que escriben estas reglas, al final de la lista, abre el script en el lugar exacto.

El código queda en scripts/principal.ts, entre dos marcas: // <reglas> y // </reglas>. Cada regla aparece con su frase como comentario. Este es el fragmento de las reglas 3 y 4 del juego del tutorial:

	// Regla 3: Cuando el jugador toca algo con la etiqueta "moneda": quitar la pieza tocada, sumar 1 punto y reproducir el sonido moneda.
	mundo.alTocar('#moneda', (pieza, jugador) => {
		pieza.eliminar();
		sumarPuntos(jugador, 1);
		sonido.tocar('moneda', { para: jugador });
	});

	// Regla 4: Cuando el jugador toca algo con la etiqueta "peligro": reproducir el sonido golpe y reaparecer en el último punto de control.
	mundo.alTocar('#peligro', (pieza, jugador) => {
		sonido.tocar('golpe', { para: jugador });
		jugador.reaparecer();
	});

Y la regla 5, «llega a 5 puntos», quedó dentro de la función que suma puntos:

/** Suma (o quita) puntos y actualiza lo que se ve. */
function sumarPuntos(jugador: Jugador, cantidad: number): void {
	const antes = jugador.puntos;
	jugador.puntos = Math.max(0, jugador.puntos + cantidad);
	mostrarPuntos(jugador);
	// Cuando el jugador llega a 5 puntos: mostrar "¡Tienes todas! Corre a la meta." y reproducir el sonido victoria.
	if (antes < 5 && jugador.puntos >= 5) {
		interfaz.mensaje(interfaz.t('r_regla_5_1'), { tipo: 'info', para: jugador });
		sonido.tocar('victoria', { para: jugador });
	}
}

No necesitas entender este código para hacer juegos. Pero si quieres aprender a programar, leer lo que escriben tus propias reglas es un buen punto de partida.

Juegos hechos con código#

La plantilla Monedas contra reloj (con código) y los ejemplos de Primera persona, Plataformas 2D, Vista cenital, Isométrico, Híbrido, Mundo abierto y Multijugador local tienen su lógica escrita a mano. En ellos el panel Reglas empieza vacío y muestra este aviso:

«Este juego está hecho con código escrito a mano (pestaña Código). Si agregas reglas, el editor las escribe en un bloque aparte dentro del mismo archivo, sin borrar lo que ya hay. Las dos cosas funcionan a la vez.»

Dos cosas cambian en estos juegos:

• Los prefabricados no agregan su regla sin preguntar. Colocar una Moneda pone la pieza con su etiqueta moneda, pero el editor no le suma lógica a un juego hecho con código por su cuenta. Lo que hace es mirar si tu código nombra lo que colocaste (su etiqueta, su pieza o su zona). Si no lo nombra, avisa: «Este juego está hecho con código y su código no usa «Moneda»: así no hace nada. Puedes agregarle su regla o programarlo a mano.» El botón Agregar su regla, dentro del aviso, crea la regla y abre el panel Reglas. Si tu código sí lo nombra, no hay aviso.
• La primera regla enciende las Reglas. Desde ese momento el editor escribe su bloque en el script, los ajustes de la Partida (reloj, puntaje final) pasan a valer y los prefabricados vuelven a traer su regla, como en cualquier otro proyecto.

El editor busca el nombre en el código, nada más: no sabe para qué lo usas. En el ejemplo isométrico, por ejemplo, colocar una Moneda no muestra el aviso, porque su script ya nombra moneda (es el sonido que toca). Ahí la regla de la moneda se crea a mano, con Nueva regla.

Al encender las Reglas, el editor tiene en cuenta el código que ya estaba:

• Las tablas de puntajes de tu código se conservan. La Partida necesita su propia tabla de mejores marcas. El editor deja como están las que nombra tu código y agrega la suya al final. Hasta la 0.2.0 las reemplazaba, y el ejemplo isométrico quedaba con un error GB323: eso ya no pasa.
• El aviso «Ninguna regla termina la partida» no sale si tu código la termina. El editor cuenta también el final que pone el código escrito a mano (una llamada a juego.terminar), además de las reglas con terminar partida y del reloj de cuenta regresiva.

Sigue con#

• Jugar dentro del editor: comprueba que tus reglas hacen lo que esperas.
• Bot de prueba: que un bot termine tu juego en todas las dificultades.
• Código: cuando las reglas no alcanzan.