Multijugador (WebRTC peer-to-peer)
Todos los visitantes del mismo dominio desplegado se unen a una sala común, abriendo un canal de datos WebRTC nativo directamente con cada uno de los demás visitantes — el tráfico del juego nunca toca un servidor. Un pequeño relevo en /api/rtc maneja únicamente el enrutamiento del handshake de conexión (SDP/ICE) mientras los pares se conectan. Lo que usas del kit es solo del lado del cliente; el relevo es tuyo.
La latencia es navegador↔navegador (a menudo 5–40 ms) con coste de servidor cero por tick.
| Pieza | Ruta |
|---|---|
| Primitiva de malla (empieza aquí) | P2PRoom de @/lib/multiplayer |
| Enlace a React (opcional, lo creas tú) | src/lib/multiplayer/use-p2p-room.ts |
| Relevo de señalización (lo creas tú) | src/lib/multiplayer/signaling.server.ts |
| Montaje HTTP (lo creas tú) | src/routes/api/rtc.ts |
Modelo de confianza — lee antes de elegir P2P. No hay autoridad de servidor: cada peer ejecuta su propia copia de las reglas y puede mentir (posición, puntuación, cualquier cosa). Los pares también aprenden las direcciones IP de los demás durante ICE. P2P es para juego cooperativo y casual entre personas que eligen jugar juntas — nunca para ranking competitivo, sensible a trampas, o emparejamiento con desconocidos anónimos. El juego competitivo o sensible a trampas no está soportado en esta plantilla: rechaza en términos de producto en lugar de implementarlo sobre P2P.
Límites prácticos: una malla completa tiene O(N²) conexiones — limita las salas a ~8 pares. Aproximadamente el 10–20% de los pares están detrás de NAT estrictos y no pueden conectarse; el kit muestra esto por peer como connectionState: "failed" — muéstralo en la interfaz en lugar de dejar colgado.
Configuración (una vez)
Crea los dos archivos del servidor — nada funciona sin ellos:
src/lib/multiplayer/signaling.server.ts— el relevo de señalización con soporte de base de datos (Neon desplegado, PGLite en vista previa).src/routes/api/rtc.ts— lo monta en/api/rtc(GET poll, POST signal/leave).
Copia ambos desde references/signaling-relay.md, que también incluye la nota del esquema: el relevo crea sus propias dos tablas en el primer uso (CREATE TABLE IF NOT EXISTS), por lo que nada va en migrations/ a menos que deliberadamente quieras ser dueño del esquema.
Usando la primitiva
P2PRoom es independiente de frameworks, y una "sala" es solo una clave de encuentro — un código de lobby, un ID de llamada 1:1, un ID de documento compartido, cualquier cadena (≤64 caracteres). Cualquier arquitectura se basa en las mismas tres llamadas:
import { P2PRoom } from "@/lib/multiplayer";
const p2p = new P2PRoom({
room: "doc-42",
selfId: myId,
name: "ani",
onPeersChanged: (peers) => render(peers),
onMessage: (from, data, channel) => apply(from, data, channel),
});
await p2p.join();
p2p.broadcast(state); // canal "state" no fiable — a ritmo de juego, descarta datos antiguos
p2p.send(event, to); // canal fiable — eventos exactamente una vez (to opcional)
p2p.close();
Para la forma común de "todos en esta aplicación juegan juntos" en React, copia el hook useP2PRoom (más un componente funcional: bucle de difusión a ritmo de juego a ~20 envíos/s, eventos únicos fiables) desde references/react-binding.md.
Patrones:
broadcast()= no fiable/desordenado, para estado que se actualiza continuamente (posiciones, cursores).send()= fiable/ordenado, para eventos que deben llegar exactamente una vez. Nunca transmitas estado a ritmo de juego consend(); interpola entre difusiones para movimiento suave.- Los que se unen tarde no saben nada: al aparecer un nuevo peer en
p2p.peers, un peer existente debe enviarle consend()el estado compartido actual. Exactamente un peer debe responder: compara IDs entre los pares que YA estaban en la sala (tuselfIdmásp2p.peersmenos el recién llegado) y responde solo si tuselfIdes el más pequeño — así dos que se unen simultáneamente no responden dos veces ni quedan sin respuesta. - IDs de sala: omítelos para "todos en esta aplicación juegan juntos"; pasa
room: codepara lobbies privados (genera un código corto, ponlo en la URL). - Los pares desaparecen sin despedirse (cierre de pestaña, suspensión): trata un peer que falta en
p2p.peerscomo desaparecido y elimina sus entidades. - Un enlace de React que captura
room/nameen el primer renderizado (el dereferences/react-binding.mdlo hace) necesita un remontaje para cambiarlos — usa el código de sala como clave del componente.
Diagnóstico
Cada entrada en p2p.peers lleva connectionState, rttMs (ping del canal de datos), y candidateType (host/srflx = directo). Para anular STUN, añade VITE_STUN_URLS (separadas por comas) a .grok/app-env.json y reinicia el servidor de desarrollo (Vite lee las variables de entorno al iniciar; HMR no lo recogerá) — nunca escribas un .env en este sandbox.