Bot de prueba
Qué comprueba Probar con bot en el editor 0.4.0, cómo arma su ruta desde las reglas, qué sabe hacer y qué no, cómo marcarle pasos y cómo leer el panel cuando la prueba falla.
Corresponde aEditor 0.4.0 Para crear sin programar
En esta página
El bot de prueba es un jugador automático. Juega tu juego de principio a fin para comprobar una sola cosa: que se puede terminar. Si el bot llega al final en todas las dificultades, el juego se puede exportar.
Qué comprueba#
Probar con bot (Ctrl+F5) corre seis partidas completas: las tres dificultades, cada una con dos semillas del azar. Las juega sin pantalla y a toda velocidad, así que tarda poco.
Cada partida tiene que terminar con el resultado esperado, que normalmente es una victoria. Si las seis lo logran, la prueba queda aprobada.
Es la misma prueba que corre Exportar antes de escribir el archivo, y la misma que usan las herramientas de línea de comandos: ver El bot.
Cómo arma su ruta#
No tienes que decirle al bot qué hacer: lo deduce de tus reglas. Mira qué hace falta para ganar (la meta, lo que hay que juntar, los botones que abren puertas) y arma una ruta que pasa por ahí.
Eso lo controla una casilla de la sección Bot de prueba, al final del panel Reglas: Armar la ruta sola a partir de las reglas (la meta, lo que hay que juntar, los botones). Viene marcada.
En la plantilla En blanco, por ejemplo, la única regla que termina la partida es la de la meta, así que la ruta tiene un solo paso: ir a la zona meta.
En un proyecto de Bloques no hay reglas de las que deducir la ruta ni esa casilla. El panel lo dice: «Sin pasos tuyos, el bot usa el guion del proyecto de bloques (va a la zona «meta» si existe). Si marcas pasos, los sigue en orden y después espera el final de la partida.»
Qué sabe y qué no#
| Sabe | No sabe |
|---|---|
| Rodear muros que pongas en el camino. | Esquivar peligros: si el camino más corto cruza una zona de peligro, la pisa. |
| Rodear huecos caminando. | Planificar saltos de plataforma en plataforma. |
| Ir a una pieza, a una zona o a un punto. | Esperar el momento justo, salvo que se lo marques. |
El panel lo dice con estas palabras: «A los objetivos (la meta, lo que hay que juntar, los botones) va rodeando solo los muros y huecos que encuentre. No sabe saltar de plataforma en plataforma ni esquivar peligros: para eso márcale pasos.»
Pasos que marcas tú#
Cuando el bot no llega solo, le marcas por dónde pasar. Los pasos que agregas van antes del objetivo final, en el orden de la lista.
Están en Reglas, sección Bot de prueba, bajo Pasos que marcas tú (van antes del objetivo final). Sin ninguno, la lista dice «Sin pasos propios: el bot va directo a los objetivos.»
| Botón | Qué paso agrega |
|---|---|
| + Punto donde mira la cámara | Ir al lugar que tienes en el centro del visor. Sirve para marcar una esquina o un punto del suelo. |
| + Ir a lo elegido | Ir a la pieza o la zona que tienes elegida en la escena. |
| + Esperar y subir a la plataforma elegida | Esperar a que la plataforma elegida llegue cerca y subirse. Para plataformas móviles. |
| + Esperar 1 s | Quedarse quieto un segundo. |
+ Ir a lo elegido y + Esperar y subir a la plataforma elegida necesitan que haya algo elegido; si no, quedan apagados.
Cada paso de la lista tiene tres controles:
| Control | Qué hace |
|---|---|
| rodear | Marcado: busca un camino que rodee muros y huecos. Sin marcar: va derecho y salta (plataformas, escalones). |
| Flecha | Sube el paso en el orden. |
| × | Quita el paso. |
Un ejemplo: rodear un peligro#
En el juego del tutorial hay una zona de peligro entre la salida y la meta. La primera prueba falla: el bot va a la meta por el camino más corto, que cruza el peligro, y no llega.
- Elige en la escena una moneda que esté a un costado del peligro.
- En Reglas, sección Bot de prueba, pulsa + Ir a lo elegido. La lista muestra «ir a la pieza «moneda-2»».
- Repite con otra moneda, del otro lado, para completar el rodeo.
- Vuelve a Probar con bot.
Con esos dos pasos antes de la meta, las seis partidas terminan en victoria.
Leer el panel#
El resultado queda en el panel Bot de prueba, que se abre solo al terminar la prueba.
Prueba aprobada#
Arriba dice Prueba aprobada, cuántas partidas pasaron y cuánto pesa el .ggx que saldría. Los botones Repetir y Ver al bot jugar están siempre a mano.
Cada fila es una partida:
| Dato | Qué es |
|---|---|
| «Fácil · semilla 1» | La dificultad, con el nombre que ve el jugador, y la semilla del azar. |
| «victoria» | Cómo terminó: victoria, derrota o fin de la partida. |
| «puntaje 2» | El puntaje final. |
| «3.0 s» | Cuánto duró la partida, en tiempo del juego. |
| «pasos del bot 2/3» | Cuántos pasos de su ruta hizo el bot antes de que terminara la partida. |
| «código … ms» | Cuánto tarda en promedio el código del juego en cada paso. |
El camino dibujado#
Después de una prueba, la ruta del bot queda dibujada en la escena. Se muestra y se oculta con B, con el botón del camino sobre el visor o con la casilla Ver el camino del bot en la escena del panel Reglas. Sirve para ver qué atraviesa la ruta antes de probar.
La prueba falló#
Una partida que no pasa lleva la marca falló y, en rojo, el motivo. Los dos más comunes:
| Motivo | Qué significa |
|---|---|
| «El bot se atascó en el paso N de M (ir a la zona «meta»): no llegó al destino (faltan … unidades en horizontal y … en vertical). El bot quedó en […] a los … s.» | El bot no pudo llegar al lugar de ese paso en el tiempo que tenía. El mensaje dice qué paso era, cuánto le faltó y dónde quedó. |
| «La partida terminó en derrota y el guion esperaba victoria.» | La partida terminó, pero no como debía: por ejemplo, se acabó el reloj. |
El botón Ver dónde lleva la cámara al lugar donde quedó el bot. Casi siempre ahí está la causa: un muro sin paso, un hueco, un peligro que lo devuelve al inicio.
Si no entiendes por qué falla, pulsa Ver al bot jugar: la misma partida, a la vista.
La vista lateral y los saltos#
En un juego de Plataformas 2D el bot no planifica los saltos. Si la prueba falla en un juego de vista lateral, el panel muestra arriba una ayuda plegable: El bot no planifica saltos en la vista lateral: cómo marcárselos.
Su texto completo:
Este juego se juega de lado (vista lateral). El bot sabe rodear muros y huecos caminando, pero en 2D no planifica solo los saltos de plataforma en plataforma, y por eso puede quedarse atascado aunque el nivel sí se pueda terminar. Márcale los saltos a mano: en Reglas, sección «Bot de prueba», agrega un paso «Ir a lo elegido» por cada plataforma, en el orden del recorrido, y quítale la marca «rodear» a esos pasos para que vaya derecho y salte. Si la ruta está escrita en pruebas/bot.json, agrégale ahí un paso «ir» por plataforma. «Ver dónde» lleva la cámara al lugar donde se quedó.
En corto:
- Elige la primera plataforma del recorrido.
- Pulsa + Ir a lo elegido.
- Quítale la marca rodear a ese paso, para que vaya derecho y salte.
- Repite con cada plataforma, en orden.
El diálogo de exportar muestra la misma explicación si la prueba falla ahí.
Juegos con la ruta escrita a mano#
Los ejemplos hechos con código traen su propia ruta en el archivo pruebas/bot.json: tiene saltos, esperas y botones que no se pueden deducir de unas reglas que no existen.
En esos juegos la casilla Armar la ruta sola a partir de las reglas viene sin marcar y el panel dice «La ruta está escrita a mano en pruebas/bot.json (N pasos). El editor no la toca.» La prueba usa esa ruta tal cual.
Para cambiarla se edita el archivo con un editor de texto; su formato está en El bot. Si marcas la casilla, el editor pasa a armar la ruta desde las reglas y tus pasos.
Un juego que no tiene reglas, ni pasos, ni ruta escrita, se prueba con una ruta básica.
La prueba se repite sola#
Muy de vez en cuando una partida de prueba muere por un fallo interno de la física, sin relación con tu juego. Probar con bot y Exportar la repiten solas y no ves nada: como el juego es reproducible, el resultado es el mismo que habría dado.
Ese mismo fallo, en una partida en vivo con Jugar, sí puede cortarla: ver Jugar dentro del editor.
Sigue con#
- Ficha, exportar y compartir: con la prueba aprobada, exporta.
- Problemas frecuentes del editor: cuando el bot no termina.
- El bot: el formato de
pruebas/bot.json.