Multiplayer (WebRTC ponto a ponto)
Todos os visitantes no mesmo domínio implantado entram em uma sala padrão, abrindo um canal de dados nativo WebRTC diretamente para cada outro visitante — o tráfego do jogo nunca toca um servidor. Um pequeno relé em /api/rtc lida apenas com o roteamento do handshake de conexão (SDP/ICE) enquanto os pares se conectam. O que você usa do kit é apenas do lado do cliente; o relé é seu.
A latência é navegador↔navegador (geralmente 5–40ms) com custo zero de servidor por tick.
| Peça | Caminho |
|---|---|
| Primitiva de malha (comece aqui) | P2PRoom de @/lib/multiplayer |
| Vinculação React (opcional, você cria) | src/lib/multiplayer/use-p2p-room.ts |
| Relé de sinalização (você cria) | src/lib/multiplayer/signaling.server.ts |
| Montagem HTTP (você cria) | src/routes/api/rtc.ts |
Modelo de confiança — leia antes de escolher P2P. Não há autoridade de servidor: cada peer executa sua própria cópia das regras e pode mentir (posição, pontuação, qualquer coisa). Os peers também aprendem os endereços IP uns dos outros durante o ICE. P2P é para jogo cooperativo e casual entre pessoas que escolhem jogar juntas — nunca para ranqueamento competitivo, sensível a trapaças ou matchmaking com estranhos anônimos. Jogo competitivo ou sensível a trapaças não é suportado neste template: recuse em termos de produto em vez de enviar via P2P.
Limites práticos: uma malha completa tem conexões O(N²) — limite as salas a ~8 peers. Aproximadamente 10–20% dos pares de peers ficam atrás de NATs restritivos e não conseguem se conectar; o kit expõe isso por peer como connectionState: "failed" — mostre na interface em vez de travar.
Configuração (uma vez)
Crie os dois arquivos de servidor — nada funciona sem eles:
src/lib/multiplayer/signaling.server.ts— o relé de sinalização com suporte a banco de dados (Neon implantado, PGLite em preview).src/routes/api/rtc.ts— monta em/api/rtc(GET poll, POST signal/leave).
Copie ambos de references/signaling-relay.md, que também traz a nota do esquema: o relé cria suas próprias duas tabelas no primeiro uso (CREATE TABLE IF NOT EXISTS), então nada vai em migrations/ a menos que você deliberadamente queira assumir o esquema.
Usando a primitiva
P2PRoom é livre de framework, e uma "sala" é apenas uma chave de encontro — um código de lobby, um id de chamada 1:1, um id de documento compartilhado, qualquer string (≤64 caracteres). Qualquer arquitetura se baseia nas mesmas três chamadas:
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" não confiável — taxa de jogo, descarta obsoletos
p2p.send(event, to); // canal confiável — eventos exatamente uma vez (to opcional)
p2p.close();
Para o formato comum "todos neste aplicativo jogam juntos" em React, copie o hook useP2PRoom (mais um componente trabalhado: loop de transmissão em taxa de jogo a ~20 envios/s, eventos únicos confiáveis) de references/react-binding.md.
Padrões:
broadcast()= não confiável/não ordenado, para estado atualizado continuamente (posições, cursores).send()= confiável/ordenado, para eventos que devem chegar exatamente uma vez. Nunca transmita estado em taxa de jogo viasend(); interpole entre transmissões para movimento suave.- Novatos não sabem nada: quando um novo peer aparece em
p2p.peers, um peer existente devesend()a ele o estado compartilhado atual. Exatamente um peer deve responder: compare ids entre os peers que JÁ estavam na sala (seuselfIdmaisp2p.peersmenos o recém-chegado) e responda apenas se seuselfIdfor o menor — assim, dois que entram simultaneamente nem respondem em dobro nem ficam sem resposta. - Ids de sala: omita para "todos neste aplicativo jogam juntos"; passe
room: codepara lobbies privados (gere um código curto, coloque na URL). - Peers desaparecem sem aviso (fechar aba, dormir): trate um peer ausente de
p2p.peerscomo desaparecido e remova suas entidades. - Uma vinculação React que captura
room/namena primeira renderização (como a emreferences/react-binding.md) precisa de uma remontagem para mudá-los — identifique o componente pelo código da sala.
Diagnóstico
Cada entrada em p2p.peers carrega connectionState, rttMs (ping do canal de dados) e candidateType (host/srflx = direto). Para substituir STUN, adicione VITE_STUN_URLS (separados por vírgula) em .grok/app-env.json e reinicie o servidor de desenvolvimento (Vite lê env na inicialização; HMR não vai pegar) — nunca escreva um .env neste sandbox.