Communitygithub.com

evalix098/tiktoklive

Multijoueur en temps réel pair-à-pair via canaux de données WebRTC : chaque utilisateur de l'application déployée se connecte directement à tous les autres (maillage complet), le serveur ne sert que de relais de poignée de main à /api/rtc. Latence la plus faible possible, coût serveur zéro par message. Idéal pour 2 à 8 joueurs en coopératif/décontracté : curseurs partagés, dessin, jeux de soirée, action légère. Déclencheurs : p2p, pair à pair, webrtc, multijoueur à faible latence, connexion directe.

Qu'est-ce que tiktoklive ?

Cette compétence d'agent IA implémente un multijoueur peer-to-peer en temps réel basé sur WebRTC, où chaque visiteur d'un même domaine déployé rejoint une salle par défaut et ouvre un canal de données WebRTC directement vers tous les autres visiteurs. Le trafic de jeu ne touche jamais le serveur ; un simple relais à `/api/rtc` gère uniquement l'échange de poignée de main SDP/ICE pendant la connexion des pairs. Elle est destinée aux jeux coopératifs et décontractés (2 à 8 joueurs) comme les curseurs partagés, le dessin, les jeux de soirée, et non aux classements compétitifs ou à la rencontre avec des inconnus (les pairs peuvent tricher, et les adresses IP sont exposées). La compétence fournit la primitive `P2PRoom`, un hook React optionnel, et un relais de signalisation basé sur une base de données (Neon ou PGLite), avec un modèle de confiance explicite et des limites pratiques (maillage complet O(N²), ~10-20% de connexions échouant derrière des NAT stricts).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Multijoueur (WebRTC pair-à-pair)

Tous les visiteurs sur le même domaine déployé rejoignent une salle par défaut, ouvrant un canal de données WebRTC natif directement vers chaque autre visiteur — le trafic de jeu lui-même ne touche jamais le serveur. Un minuscule relais à /api/rtc gère uniquement le routage de la poignée de main de connexion (SDP/ICE) pendant que les pairs se connectent. Ce que vous utilisez de la trousse est uniquement côté client ; le relais est le vôtre.

La latence est navigateur↔navigateur (souvent 5-40 ms) avec un coût serveur nul par tick.

PièceChemin
Primitive de maillage (commencez ici)P2PRoom de @/lib/multiplayer
Liaison React (optionnelle, vous créez)src/lib/multiplayer/use-p2p-room.ts
Relais de signalisation (vous créez)src/lib/multiplayer/signaling.server.ts
Montage HTTP (vous créez)src/routes/api/rtc.ts

Modèle de confiance — lisez avant de choisir P2P. Il n'y a pas d'autorité serveur : chaque pair exécute sa propre copie des règles et peut mentir (position, score, quoi que ce soit). Les pairs apprennent également les adresses IP des autres pendant ICE. Le P2P est uniquement pour les jeux coopératifs et décontractés entre personnes qui choisissent de jouer ensemble — jamais pour les classements compétitifs, les jeux sensibles à la triche, ou les rencontres entre inconnus anonymes. Les jeux compétitifs ou sensibles à la triche ne sont pas pris en charge dans ce modèle : repoussez en termes de produit plutôt que de les expédier en P2P.

Limites pratiques : un maillage complet est de O(N²) connexions — limitez les salles à ~8 pairs. Environ 10-20 % des paires de pairs se trouvent derrière des NAT stricts et ne peuvent pas se connecter ; la trousse expose cela par pair comme connectionState: "failed" — affichez-le dans l'interface utilisateur plutôt que de bloquer.

Configuration (une fois)

Créez les deux fichiers serveur — rien ne fonctionne sans eux :

  1. src/lib/multiplayer/signaling.server.ts — le relais de signalisation basé sur une base de données (Neon déployé, PGLite en prévisualisation).
  2. src/routes/api/rtc.ts — le monte à /api/rtc (GET poll, POST signal/leave).

Copiez les deux à partir de references/signaling-relay.md, qui contient également la note de schéma : le relais crée ses propres deux tables lors de la première utilisation (CREATE TABLE IF NOT EXISTS), donc rien ne va dans migrations/ à moins que vous ne souhaitiez délibérément posséder le schéma.

Utilisation de la primitive

P2PRoom est indépendant du framework, et une « salle » est simplement une clé de rendez-vous — un code de lobby, un identifiant d'appel 1:1, un identifiant de document partagé, n'importe quelle chaîne (≤64 caractères). N'importe quelle architecture repose sur les trois mêmes appels :

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),
});
avoid p2p.join();
p2p.broadcast(state); // canal "state" non fiable — rythme de jeu, les périmés sont abandonnés
p2p.send(event, to); // canal fiable — événements exactement une fois (to optionnel)
p2p.close();

Pour la forme courante « tous sur cette application jouent ensemble » dans React, copiez le hook useP2PRoom (plus un composant concret : boucle de diffusion au rythme du jeu à ~20 envois/s, événements ponctuels fiables) depuis references/react-binding.md.

Modèles :

  1. broadcast() = non fiable/non ordonné, pour un état continuellement rafraîchi (positions, curseurs). send() = fiable/ordonné, pour les événements qui doivent arriver exactement une fois. Ne diffusez jamais l'état du jeu sur send() ; interpolez entre les diffusions pour un mouvement fluide.
  2. Les arrivants tardifs ne savent rien : lorsqu'un nouveau pair apparaît dans p2p.peers, un pair existant doit lui send() l'état partagé actuel. Exactement un pair doit répondre : comparez les identifiants parmi les pairs qui étaient DÉJÀ dans la salle (votre selfId plus p2p.peers moins le nouveau venu) et répondez uniquement si votre selfId est le plus petit — ainsi deux arrivants simultanés ne répondent ni doublement ni ne restent sans réponse.
  3. Identifiants de salle : omettez pour « tous sur cette application jouent ensemble » ; passez room: code pour les salons privés (générez un code court, mettez-le dans l'URL).
  4. Les pairs disparaissent sans au revoir (fermeture d'onglet, veille) : traitez un pair absent de p2p.peers comme parti et supprimez ses entités.
  5. Une liaison React qui capture room/name lors du premier rendu (celle de references/react-binding.md le fait) nécessite un remontage pour les modifier — associez le composant au code de la salle.

Diagnostic

Chaque entrée dans p2p.peers porte connectionState, rttMs (ping du canal de données), et candidateType (host/srflx = direct). Pour remplacer STUN, ajoutez VITE_STUN_URLS (séparé par des virgules) à .grok/app-env.json et redémarrez le serveur de développement (Vite lit l'environnement au démarrage ; HMR ne le détectera pas) — n'écrivez jamais un .env dans ce bac à sable.

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 associés