Communitygithub.com

evalix098/tiktoklive

Multijugador peer-to-peer en tiempo real sobre canales de datos WebRTC: cada usuario de la aplicación desplegada se conecta directamente con todos los demás (malla completa); el servidor solo gestiona el handshake en /api/rtc. La menor latencia posible, coste de servidor cero por mensaje. Úsalo para juegos cooperativos/casuales de 2 a 8 jugadores en tiempo real: cursores compartidos, dibujo, juegos de fiesta, acción casual. Disparadores: p2p, peer to peer, webrtc, multijugador baja latencia, conexión directa.

¿Qué es tiktoklive?

Esta habilidad proporciona una solución multijugador peer-to-peer (P2P) sobre WebRTC, donde todos los visitantes del mismo dominio desplegado se unen a una sala común y se conectan directamente entre sí mediante canales de datos nativos. El tráfico del juego nunca toca un servidor, excepto un pequeño relevo en `/api/rtc` que maneja únicamente el handshake de conexión (SDP/ICE). Esto ofrece una latencia extremadamente baja (5–40 ms entre navegadores) y un coste de servidor cero por mensaje. La habilidad incluye una primitiva `P2PRoom` (framework-agnóstico), un hook opcional para React (`useP2PRoom`), y archivos de señalización necesarios. Es ideal para juegos cooperativos y casuales de 2 a 8 jugadores, pero no debe usarse para juegos competitivos o sensibles a trampas, ya que no hay autoridad central y los pares pueden mentir. Se recomienda mostrar `connectionState: failed` en la interfaz para pares que no puedan conectarse debido a NAT restrictivos.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/evalix098/tiktoklive/tree/HEAD/.grok/skills/multiplayer-p2p

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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.

PiezaRuta
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:

  1. src/lib/multiplayer/signaling.server.ts — el relevo de señalización con soporte de base de datos (Neon desplegado, PGLite en vista previa).
  2. 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:

  1. 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 con send(); interpola entre difusiones para movimiento suave.
  2. Los que se unen tarde no saben nada: al aparecer un nuevo peer en p2p.peers, un peer existente debe enviarle con send() el estado compartido actual. Exactamente un peer debe responder: compara IDs entre los pares que YA estaban en la sala (tu selfId más p2p.peers menos el recién llegado) y responde solo si tu selfId es el más pequeño — así dos que se unen simultáneamente no responden dos veces ni quedan sin respuesta.
  3. IDs de sala: omítelos para "todos en esta aplicación juegan juntos"; pasa room: code para lobbies privados (genera un código corto, ponlo en la URL).
  4. Los pares desaparecen sin despedirse (cierre de pestaña, suspensión): trata un peer que falta en p2p.peers como desaparecido y elimina sus entidades.
  5. Un enlace de React que captura room/name en el primer renderizado (el de references/react-binding.md lo 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.

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

evalix098/tiktoklive

Add user accounts and sign-in to this TanStack Start app. Use when the app needs authentication, sign-in, user accounts, protected routes, or per-user data. Triggers on "auth", "login", "log in", "sign in", "sign up", "account", "users", "authentication", "protected", "who is logged in", "current user", "per-user".

evalix098/tiktoklive

Build browser games and interactive/canvas/3D experiences in this TanStack Start + React app. Use for any game, simulation, or WebGL/Canvas experience — 2D or 3D, single-player. Covers the game loop & timing, 3D orientation/camera conventions, collision, performance, assets, audio, save, game feel, and per-genre playbooks. For WASD / vehicle / flight **input signs and inverted A/D**, open the **`controls`** skill — do not rely on this file or racing-kart alone. Triggers on "game", "minecraft", "fps", "platformer", "racing", "tetris", "snake", "shooter", "3d", "three.js", "canvas", "voxel", "physics".

evalix098/tiktoklive

Player-facing input signs for browser games: WASD, vehicles, flight, FPS mouse-look, and the #1 failure mode (inverted A/D). Mandatory control self-tests and a tiny test interface so you can verify A turns left before shipping. Load for ANY game with movement, steering, flying, driving, tanks, boats, mechs, drones, planes, karts, third-person follow cams — not only racing. Triggers on "controls", "WASD", "inverted", "steer", "flight", "airplane", "kart", "vehicle", "yaw", "roll", "pitch", "mouse look", "A/D".

evalix098/tiktoklive

Design and build polished, non-generic UI for this TanStack Start + React + Tailwind v4 + shadcn/Radix app. Use whenever you create or restyle any interface surface — pages, landing pages, dashboards, forms, modals, nav, and game overlays (start screens, HUD, menus). Covers design tokens, layout, typography, color, spacing, motion, and the anti-"AI-slop" rules that keep output from looking generic. Triggers on "design", "UI", "make it look good", "polish", "landing page", "theme", "style", "redesign", "ugly", "clean up".

evalix098/tiktoklive

Deep guide for game ANIMATION assets: motion cycles, action keyframes, effect sequences, and animation sprite sheets — built around a video-first pipeline. In this app-builder sandbox, execute via the video2dsprite / generate2dsprite skills (magenta + scripts), not ad-hoc ffmpeg. Use whenever generating anything that moves: walk/run cycles, attacks, idles, FX, flags, fire, animation sheets. Complements game-asset-core.

evalix098/tiktoklive

Core discipline for ANY game-asset generation with Imagine tools: the engine-ready defaults users don't state, spec checklists, style anchoring, read-back verification, honest defect flagging. Use whenever generating any game art (sprites, sheets, animations, tiles, UI, FX) — then ALSO load the matching specialist skill: game-animation-frames for anything that moves, game-tilesets for tiles/terrain, game-character-consistency for recurring characters, game-ui-icons for UI and icons.

evalix098/tiktoklive

Deep guide for CHARACTER IDENTITY across images: turnarounds (front/side/ back), state and damage variants, palette swaps, equipment changes, and same-character-in-context sets. Use whenever generating character turnarounds, character sheets, variants of an existing sprite, or any same-subject multi-image set. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game TILE assets: seamless tileable textures, terrain transition tilesets, autotiles, and ground/platform tiles. Use whenever generating tileable textures, tilesets, terrain transitions, or seamless patterns. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game UI assets: buttons with interaction states, panels, bars, wordmark logos, and icon sets. Use whenever generating game UI elements, HUD assets, inventory icons, icon sets, buttons, or title logos. Complements game-asset-core.

evalix098/tiktoklive

Generate production-oriented 2D game maps with `imagine_text_to_image`: RPG/top-down maps, side-scroller parallax stages, tilemaps, layered raster maps, prop packs, collision zones, and walkable areas. Use when building browser games that need real map art (not pure code-drawn tiles), layered props, or map collision metadata. Triggers on "map", "level", "stage", "tilemap", "overworld", "dungeon", "side scroller background", "prop pack", "2D map".

evalix098/tiktoklive

Generate and postprocess 2D game sprites and animation sheets: pixel-art characters, NPCs, creatures, spells, projectiles, impacts, props, summons, and transparent PNG/GIF exports. Use when building browser games that need real sprite sheets (not code-drawn placeholders), matching a map art style, or producing magenta-background sheets for chroma-key cleanup. Triggers on "sprite", "sprite sheet", "animation sheet", "pixel art character", "walk cycle", "attack animation", "projectile sprite", "2D game asset".

evalix098/tiktoklive

How to use the Imagine tools in Grok Build: imagine_text_to_image, imagine_image_to_image, imagine_reference_to_image, imagine_text_to_video, imagine_image_to_video, imagine_reference_to_video, and render_file for chat previews. When to build a visual with code instead of generating it, prompt-craft, reference-first handling of real people, factual grounding, and asset-consistency. Load this whenever generating or editing an image or video is on the table. Tool-usage-driven, not triggered by a user merely mentioning images.

evalix098/tiktoklive

Use Neon Postgres (the database) in this TanStack Start app. Use when the app needs to store or query data, persist state, or keep per-user data. Triggers on "database", "Postgres", "Neon", "save data", "store data", "persist", "tables", "SQL", "query", "migrations".

evalix098/tiktoklive

Share-link previews and app identity for apps on *.grok.me: the injector-owned og:image card, the SVG favicon, and PWA icons for installable apps. Use when scaffolding, renaming, or restyling the app — and for share / unfurl / OG / Twitter card questions. A custom 1200×630 card from the app's own art is the default — games of every kind (DOM board/word games included), whimsical apps, creative tools, and brand-forward pages; only plain utilities keep the placeholder. Always run the brand-asset pass as a `task` subagent and never wait for it. Triggers on "share", "rename", "app name", "OG", "Open Graph", "twitter card", "unfurl", "og:image", "og:type", "x:game:image", "x-banner", "link preview", "social card", "thumbnail", "preview image", "favicon", "app icon", "PWA", "manifest", "installable", "home screen", "SEO", "meta description".

evalix098/tiktoklive

Official Three.js API and TSL (Three.js Shading Language) reference for LLM code generation. Load when writing or debugging three.js / WebGL / WebGPU / custom materials / shaders / GLTF / advanced three APIs beyond basic game loop/controls. Prefer building-games for game correctness (loop, WASD, camera, orientation); use this skill for full API/TSL depth. Triggers on "three.js", "threejs", "WebGPU", "TSL", "NodeMaterial", "shader", "GLTF", "MeshStandard", "OrbitControls", "WebGLRenderer".

evalix098/tiktoklive

Grok Build only. Turn a 2D character still into denser animation sprites via imagine_text_to_image base → imagine_image_to_video (6s/10s run-in-place) → ffmpeg frames → magenta chroma-key → dense sampled strips/grids/GIFs. Use when the user wants video-to-sprite, smoother run/walk cycles, or denser intermediate poses. Prefer generate2dsprite for crisp production pixel sheets. Triggers on "video to sprite", "imagine_image_to_video sprite", "dense walk cycle", "smooth run animation from video".

evalix098/tiktoklive

Call the xAI API (Grok) from this app's server code using the injected XAI_API_KEY: chat/LLM features, image and video generation (Imagine), and voice (text-to-speech). Use when the app needs any "AI" / "assistant" / "chatbot" / "Grok" functionality, runtime image/video generation, or speech. Triggers on "AI", "LLM", "chatbot", "assistant", "Grok", "xAI", "generate text", "summarize", "generate image", "AI video", "voice", "text to speech", "TTS", "OpenAI" (use xAI instead).

Skills relacionados