Servicio jugadores

Quiénes están en la sala, humanos y bots: su posición, sus habilidades, sus acciones, su vista y su estado.

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

Funciones y propiedades de jugadores#

jugadores.todos#

jugadores.todos(): Jugador[]

Jugadores presentes, humanos y bots.

De docs/EJEMPLOS.md, «interfaz: menú»:

for (const j of jugadores.todos()) j.congelado = true;       // un menú no pausa la partida

jugadores.humanos#

jugadores.humanos(): Jugador[]

Jugadores presentes que no son bots.

De games/copa-de-bloques/scripts/principal.ts:

hum = jugadores.humanos()[0] ?? jugadores.todos()[0];

jugadores.porId#

jugadores.porId(id: string): Jugador | null

El jugador con ese id, o null si no está.

jugadores.alEntrar#

jugadores.alEntrar(fn: (j: Jugador) => void): void

Un jugador entra a la sala. También se llama para los que ya estaban al registrar el evento.

De docs/EJEMPLOS.md, «interfaz: HUD, mensajes y cronómetro»:

jugadores.alEntrar((j) => {
  interfaz.hud('puntos', { icono: 'estrella', texto: interfaz.t('puntos', { n: 0 }), lugar: 'arriba-izquierda' }, j);
});

jugadores.alSalir#

jugadores.alSalir(fn: (j: Jugador) => void): void

Un jugador sale de la sala.

De games/isla-taller/scripts/principal.ts:

jugadores.alSalir((j) => {
  for (const p of pilas.get(j.id) ?? []) p.eliminar();
  pilas.delete(j.id);
});

jugadores.alAccion#

jugadores.alAccion(accion: 'saltar' | 'accion' | 'accion2', fn: (j: Jugador) => void): void

Un jugador aprieta una acción (una vez por pulsación).

De docs/EJEMPLOS.md, «jugadores: estado por jugador, acciones y caídas»:

jugadores.alAccion('accion', (j) => {            // una vez por pulsación
  j.impulsar([0, 14, 0]);
  sonido.tocar('poder', { para: j });
});

jugadores.alCaer#

jugadores.alCaer(fn: (j: Jugador) => void): void

Un jugador cayó bajo alturaCaida. La sala ya lo reapareció; aquí descuentas vidas, sumas una penalización, etc.

De docs/EJEMPLOS.md, «jugadores: estado por jugador, acciones y caídas»:

jugadores.alCaer((j) => {                        // la sala ya lo devolvió a su aparición
  const vidas = (j.datos.vidas as number) - 1;
  j.datos.vidas = vidas;
  interfaz.hud('vidas', { icono: 'corazon', texto: interfaz.t('vidas', { n: vidas }), estilo: vidas === 1 ? 'peligro' : 'normal' }, j);
  if (vidas <= 0) juego.terminar({ resultado: 'derrota', puntaje: j.puntos, de: j });
});

jugadores.alCambiarPantalla#

jugadores.alCambiarPantalla(fn: (j: Jugador) => void): void

Cambió el tamaño o la orientación de la pantalla de un jugador. También se llama una vez al conocerla.

De docs/EJEMPLOS.md, «interfaz: mensajes que no estorban, menú con opción deshabilitada, textos anidados»:

// Textos mas cortos en telefonos verticales.
jugadores.alCambiarPantalla((j) => interfaz.hud('ayuda', { texto: interfaz.t(j.pantalla.vertical ? 'ayudaCorta' : 'ayuda'), lugar: 'abajo-centro' }, j));

jugadores.alCambiarRanura#

jugadores.alCambiarRanura(fn: (j: Jugador, ranura: number) => void): void

El jugador eligió otra ranura de la barra rápida.

De games/valle-abierto/scripts/principal.ts:

jugadores.alCambiarRanura((j) => sonido.tocar('tic', { para: j, volumen: 0.4 }));

Jugador#

Un jugador de la sala: una persona o un bot.

jugador.teletransportar#

jugador.teletransportar(destino: Vec3 | string, rotacionY?: number): void

Lo lleva a un punto o a una aparición (por su id), y detiene su velocidad.

De docs/EJEMPLOS.md, «jugadores: mover, teletransportar y cambiar habilidades»:

mundo.alTocar('#portal', (_p, j) => j.teletransportar('sala-2'));       // id de una aparición

jugador.reaparecer#

jugador.reaparecer(): void

Lo devuelve a su aparición actual.

De docs/EJEMPLOS.md, «actores: personajes del script»:

actores.alTocar('#enemigo', (enemigo, j) => { j.reaparecer(); enemigo.posicion = [10, 0, 10]; });

jugador.impulsar#

jugador.impulsar(velocidad: Vec3): void

Suma velocidad al instante (rebotes, trampolines).

De docs/EJEMPLOS.md, «jugadores: mover, teletransportar y cambiar habilidades»:

mundo.alTocar('#trampolin', (_p, j) => j.impulsar([0, 20, 0]));

jugador.pulsa#

jugador.pulsa(accion: AccionEntrada): boolean

true mientras mantiene apretada la acción.

De docs/CONTRATO.md, sección 4.3:

jugador.pulsa('primaria')

jugador.apunta#

jugador.apunta(distancia?: number): Impacto | null

Lo primero que tiene delante, hasta distancia (por defecto 4): la pieza que mira. Sirve para «interactuar con lo que miro».

jugador.caminarA#

jugador.caminarA(destino: Vec3 | null): void

Manda al avatar caminando a un punto (rodea obstáculos). null lo detiene. Cualquier movimiento del jugador lo cancela.

jugador.apuntaBloque#

jugador.apuntaBloque(distancia?: number): BloqueApuntado | null

El bloque del terreno al que apunta el jugador, hasta distancia unidades de sus ojos (5 por defecto), o null. Trae la cara tocada y la celda vecina donde iría un bloque nuevo.

De games/valle-abierto/scripts/principal.ts:

const a = j.apuntaBloque(ALCANCE);

Notas de comportamiento#

Puntero y barra rápida (versión 1.1). Dos acciones más, que se declaran en controles.acciones como las otras:

Se usan igual que las demás: jugadores.alAccion('primaria', fn) (una vez por pulsación) y jugador.pulsa('primaria') (mientras se mantiene). Cuando un juego declara alguna de las dos:

• el ratón se captura al hacer clic también en tercera persona (Esc lo suelta; el clic que lo captura no cuenta como acción) y aparece la mira en el centro. Si el navegador no deja capturarlo, se mira arrastrando y los clics actúan igual;
• jugador.puntero es el rayo desde la cámara por la mira. En primera persona es lo mismo que jugador.mirada; en tercera persona nace en la cámara, detrás del avatar. Para los bots es la mirada;
• la barra rápida se dibuja con interfaz.barraRapida y se elige con la rueda del ratón, las teclas 1 a 9, la cruceta del mando (izquierda y derecha) o tocando una ranura. La elegida es jugador.ranura.

Sirven para cualquier juego (disparar, recoger, usar lo que se mira), no solo para los de cubos.

Detalles que conviene saber:

• rapidez admite de 0 a 40 y salto de 0 a 30; los valores fuera de rango se recortan.
• velocidad devuelve la velocidad real (caminar más empujes). Para saber qué quiere hacer el jugador usa entrada.
• impulsar en horizontal se frena solo (roce 0,82 por cuadro en el suelo, 0,985 en el aire): es un empujón, no una velocidad sostenida.
• teletransportar deja al jugador en el suelo de inmediato si hay piso bajo sus pies.
• pantalla vale 1280 x 720, no táctil, para los bots y en greengames probar. En teléfonos, un chip del HUD muestra cómodo unos 24 caracteres por línea (hace salto de línea hasta tres).

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.

jugadores: estado por jugador, acciones y caídas#

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

juego.alIniciar(() => {
  jugadores.alEntrar((j) => {
    j.datos = { vidas: 3 };
    interfaz.hud('vidas', { icono: 'corazon', texto: interfaz.t('vidas', { n: 3 }) }, j);
  });

  jugadores.alCaer((j) => {                        // la sala ya lo devolvió a su aparición
    const vidas = (j.datos.vidas as number) - 1;
    j.datos.vidas = vidas;
    interfaz.hud('vidas', { icono: 'corazon', texto: interfaz.t('vidas', { n: vidas }), estilo: vidas === 1 ? 'peligro' : 'normal' }, j);
    if (vidas <= 0) juego.terminar({ resultado: 'derrota', puntaje: j.puntos, de: j });
  });

  jugadores.alAccion('accion', (j) => {            // una vez por pulsación
    j.impulsar([0, 14, 0]);
    sonido.tocar('poder', { para: j });
  });
});

jugadores: mover, teletransportar y cambiar habilidades#

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

juego.alIniciar(() => {
  mundo.alTocar('#trampolin', (_p, j) => j.impulsar([0, 20, 0]));
  mundo.alTocar('#portal', (_p, j) => j.teletransportar('sala-2'));       // id de una aparición
  mundo.alTocar('#botas', (botas, j) => { botas.eliminar(); j.saltosExtra = 1; j.rapidez = 11; });
  mundo.alTocar('#hielo', (_p, j) => { j.congelado = true; });
});

Sigue con#

• Servicio interfaz
• 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.