Servicio juego

La partida: en qué dificultad y escena está, cuándo empieza, qué pasa en cada cuadro y cómo termina.

Los tipos que aparecen en las firmas (Vec3, Texto, el selector) están en la referencia de la API.

Funciones y propiedades de juego#

juego.alIniciar#

juego.alIniciar(fn: () => void): void

Se llama una vez, con la escena cargada y los jugadores iniciales ya dentro. Registra aquí el resto de los eventos.

De docs/EJEMPLOS.md, «juego: iniciar, cada cuadro, terminar»:

juego.alIniciar(() => {
  juego.registro('Partida en', juego.dificultad, 'con semilla', juego.semilla);
});

juego.cadaCuadro#

juego.cadaCuadro(fn: (dt: number) => void): void

Se llama en cada cuadro de simulación. dt siempre vale 1/60.

De docs/EJEMPLOS.md, «mundo: mover piezas»:

// A mano, cuadro a cuadro: una pieza en órbita. Se asigna un vector nuevo.
juego.cadaCuadro(() => {
  const a = reloj.ahora * 2;
  mundo.pieza('satelite').posicion = [Math.cos(a) * 5, 3, Math.sin(a) * 5];
});

juego.terminar#

juego.terminar(fin: { resultado: 'victoria' | 'derrota' | 'fin'; puntaje?: number; tabla?: string; de?: Jugador; detalle?: Texto }): void

Termina la partida. Después de esto la sala se detiene: no corren más cuadros ni temporizadores.

De docs/EJEMPLOS.md, «juego: cambiar de escena»:

mundo.alEntrar('tesoro', (_zona, j) => juego.terminar({ resultado: 'victoria', puntaje: 1, de: j }));

juego.cambiarEscena#

juego.cambiarEscena(id: string): void

Descarga la escena actual y carga otra. Los jugadores reaparecen en la primera aparición. Vuelve a llamar a los alCambiarEscena.

De docs/EJEMPLOS.md, «juego: cambiar de escena»:

// Escena "principal" con una zona "puerta"; escena "sotano" con una zona "tesoro".
mundo.alEntrar('puerta', () => juego.cambiarEscena('sotano'));

juego.alCambiarEscena#

juego.alCambiarEscena(fn: (id: string) => void): void

Se llama después de cada juego.cambiarEscena, con el id de la escena nueva.

De docs/EJEMPLOS.md, «juego: cambiar de escena»:

juego.alCambiarEscena((id) => juego.registro('Ahora en', id));

juego.registro#

juego.registro(...datos: unknown[]): void   // `greengames probar` lo muestra

Escribe en la consola del reproductor (solo para depurar; el jugador no lo ve).

De docs/EJEMPLOS.md, «juego: iniciar, cada cuadro, terminar»:

juego.registro('Partida en', juego.dificultad, 'con semilla', juego.semilla);

juego.senalar#

juego.senalar(nombre: string, valor?: unknown): void

Deja una señal con nombre para el guion del bot (condiciones { "senal": "nombre" }). No hace nada más: el jugador no la ve. Sirve para que la prueba sepa en qué momento está el juego ('ronda', 'puerta-abierta'). valor debe ser JSON; por defecto true.

De docs/EJEMPLOS.md, «Guion de bot con señales, ciclos y ruta»:

juego.senalar('puerta-abierta');      // cuando se abre

Notas de comportamiento#

terminar con tabla registra el puntaje en esa tabla para el jugador de (por defecto, el primer humano). Después de terminar la sala se detiene. cambiarEscena descarga la escena, carga la otra en el cuadro siguiente, lleva a los jugadores a su primera aparición y llama a alCambiarEscena.

Qué sobrevive a cambiarEscena:

Una derrota no entra a la tabla: terminar({ resultado: 'derrota', tabla }) no registra ni anuncia récord. Para registrar igual (un juego de supervivencia que siempre termina perdiendo), usa resultado: 'fin' o llama antes a puntajes.registrar.

Ejemplos completos#

Scripts completos de docs/EJEMPLOS.md. Cada uno supone una escena con lo que nombra, y las claves de texto (interfaz.t('...')) deben existir en textos de juego.json.

juego: iniciar, cada cuadro, terminar#

import { juego, jugadores } from '@greengames/sdk';

juego.alIniciar(() => {
  juego.registro('Partida en', juego.dificultad, 'con semilla', juego.semilla);
});

// Gana quien llegue a z = 50. dt siempre vale 1/60.
juego.cadaCuadro(() => {
  for (const j of jugadores.todos()) {
    if (j.posicion[2] >= 50) juego.terminar({ resultado: 'victoria', puntaje: 100, de: j });
  }
});

juego: cambiar de escena#

import { juego, mundo } from '@greengames/sdk';

juego.alIniciar(() => {
  // Escena "principal" con una zona "puerta"; escena "sotano" con una zona "tesoro".
  mundo.alEntrar('puerta', () => juego.cambiarEscena('sotano'));
  mundo.alEntrar('tesoro', (_zona, j) => juego.terminar({ resultado: 'victoria', puntaje: 1, de: j }));
});
juego.alCambiarEscena((id) => juego.registro('Ahora en', id));

Sigue con#

• Servicio mundo
• Referencia de la API: los once servicios y los tipos comunes.
• Scripts: las reglas de un script y cómo corre dentro de la sala.