Communitygithub.com

evalix098/tiktoklive

Crea juegos de navegador e interactivos/canvas/3D en esta app TanStack Start + React. Úsalo para cualquier juego, simulación o experiencia WebGL/Canvas, 2D o 3D, para un solo jugador. Cubre el bucle del juego y tiempos, convenciones 3D de orientación/cámara, colisiones, rendimiento, assets, audio, guardado, sensación de juego y guías por género. Para las señales de entrada WASD/vehículo/vuelo y A/D invertido, abre la skill **`controls`**; no te bases solo en este archivo o en racing-kart. Se activa con 'game', 'minecraft', 'fps', 'platformer', 'racing', 'tetris', 'snake', 'shooter', '3d', 'three.js', 'canvas', 'voxel', 'physics'.

¿Qué es tiktoklive?

La skill **evalix098/tiktoklive** (renombrada como **Building Games**) es una guía completa y universal para construir juegos de navegador jugables y correctos, tanto en 2D como en 3D. Está diseñada para entornos TanStack Start + React y cubre todos los aspectos fundamentales del desarrollo de juegos: el bucle principal con temporización basada en delta time, sistemas de control (delegando en una skill de controles separada), orientación 3D, sistemas de cámara, rendimiento, gestión de assets, audio, guardado y sensación de juego (juice). La skill es compatible con plataformas como Claude Code y Cursor, y se activa con una amplia variedad de palabras clave relacionadas con géneros de juegos y tecnologías (three.js, canvas, voxel, etc.). Su propósito es ser el núcleo universal para el bucle del juego y el mundo, mientras que las referencias por género y otras skills especializadas (como controles, diseño de UI, o assets) proporcionan detalles específicos. La skill también incluye criterios de finalización estrictos para garantizar que el juego funcione correctamente, sin errores de consola, con controles verificados y con soporte móvil.

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

Preguntar en tu IA favorita

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

Documentación

Creación de Juegos

Construye un juego de navegador jugable y correcto — no una captura de pantalla estática. Un juego es simplemente una ruta de React con un <canvas> (o <Canvas> para R3F) más una interfaz de superposición DOM. Estiliza la superposición (pantalla de inicio, HUD, menús) con la skill design-ui; esta skill posee el bucle de juego y el mundo.

Controles / A/D invertido: abre .grok/skills/controls/SKILL.md antes de escribir WASD, dirección o entrada de vuelo. Las demostraciones de vehículos/vuelo a menudo tienen A/D invertido si solo lees este archivo o una guía de un solo género.

Nota de alcance — un solo jugador, bots o cooperativo P2P pequeño:

  • Entrega un solo jugador o un solo jugador + IA/bots por defecto.
  • Cooperativo / tiempo real casual de 2 a 8 jugadores (cursores compartidos, juegos de fiesta, acción casual entre amigos) es compatible — usa la skill multiplayer-p2p (malla WebRTC, señalizada en /api/rtc). Lee primero su modelo de confianza.
  • P2P es el único multijugador compatible ahora mismo. No construyas a medias sockets que no puedan conectarse.

Referencias (cargar bajo demanda):

  • Skill controls (../controls/) — requerida para movimiento/dirección/vuelo: A/D visible para el jugador, antipatrón de dirección invertida, alerones de vuelo, autocomprobación obligatoria + window.__controlsTest. No es opcional para vehículos/aviones.
  • references/threejs-foundational.md — la referencia profunda de 3D/bucle/rendimiento. Léela para 3D.
  • references/3d-libs.md — uso de three.js + @react-three/fiber + drei + rapier.
  • Skill threejs (../threejs/) — volcado oficial completo de la API de Three.js + TSL (llms-full.txt). Cárgala para materiales/shaders/WebGPU/loaders avanzados; no para juegos simples de canvas 2D.
  • references/babylon.md — Babylon.js, la alternativa de motor 3D con baterías incluidas.
  • references/phaser.md — Phaser 3, el motor por defecto para juegos 2D.
  • references/ecs-architecture.md — estructura entidad-componente-sistema para juegos grandes.
  • references/genres/*.md — guías por género (fps, plataforma-2d, carreras-kart, puzzle-match3-tetris, voxel-minecraft, endless-runner, topdown-twin-stick, tower-defense, board-card-chess). Los archivos de género no reemplazan controls.
  • references/game-feel-juice.md, input.md, audio.md, collision-physics.md, save-persistence.md, procedural-generation.md, ai-pathfinding.md.
  • game-asset-core (+ game-animation-frames / game-tilesets / game-character-consistency / game-ui-icons) — valores predeterminados de arte 2D listos para el motor y verificación al generar sprites, hojas, tiles o interfaz de usuario (ver §6).

Elige la referencia de género/tema específico para la construcción; este archivo es el núcleo universal para el bucle/mundo. Señales de entrada → controls. Arte de juego 2D → game-asset-core.


1. Bucle del juego y temporización (el problema de corrección #1)

  • Conduce el bucle con el bucle RAF del motor (renderer.setAnimationLoop, R3F useFrame, o requestAnimationFrame para canvas 2D). Nunca setInterval/ setTimeout/Date.now() para la temporización del juego.
  • Escala TODO el movimiento/animación por delta time (segundos) para que la velocidad sea independiente de la tasa de fotogramas (60Hz vs 144Hz). Calcula delta una vez por fotograma y reutilízalo.
    • three.js: usa THREE.Timer (no Clock — Clock.getDelta() devuelve ~0 en una segunda llamada en el mismo fotograma, un error clásico de congelación).
  • Limita delta (min(delta, 0.1)) para que una pestaña en segundo plano no teletransporte las cosas.
  • Paso de tiempo fijo para física/juego: acumula delta y simula pasos a una tasa fija (ej. 1/60) mientras renderizas a la tasa de visualización — evita túneles y no determinismo.

2. Controles (delegar en la skill controls)

Abre .grok/skills/controls/SKILL.md antes de implementar cualquier código WASD / dirección / vuelo. Esa skill es la fuente de verdad para:

  • A = izquierda / D = derecha visible para el jugador (cámara en persecución, mientras avanzas)
  • Por qué KeyA → steer− + yaw += steer * +rate invierte (el error más común)
  • Vehículo vs FPS (strafe ≠ steer), alerones de ala fija, notas de heli/drone
  • Autocomprobación obligatoria + sonda window.__controlsTest

No trates genres/racing-kart.md como el único lugar donde viven las señales de steer — los aviones, motos acuáticas y mechs nunca lo abren.

Recordatorio breve (detalle completo en controls):

// Cuerpo de guiñada del vehículo (cámara en persecución): A debe aumentar la guiñada con esta base
forward = (-sin(yaw), 0, -cos(yaw))
// KeyA → steer = +1;  yaw += steer * turnRate * speedFactor * dt
// INCORRECTO (entrega invertido): KeyA → steer = -1; yaw += steer * turnRate * dt
  • Bloqueo de puntero: solo mirar con el ratón — implementa WASD tú mismo; superposición de clic para jugar; descartar al bloquear.
  • Rastrea teclas con estado presionado + dt; unifica dispositivos mediante references/input.md.
  • Finaliza: ejecuta la lista de verificación de la skill controls. Solo una captura de pantalla es insuficiente para vehículos/vuelo.

3. Orientación 3D y objetos del mundo (los errores de "ladeado/hacia atrás")

  • three.js es diestro, +Y hacia arriba: +X derecha, +Y arriba, +Z hacia el espectador. Las mallas miran +Z; las cámaras miran −Z (el clásico error "cámara hacia atrás").
  • Primitivas como Cone/Cylinder apuntan +Y por defecto → rotar para alinear una punta hacia adelante (geo.rotateX(Math.PI/2)).
  • Orientar una malla para que mire hacia forward (las mallas miran +Z): la forma correcta más simple es mesh.lookAt(mesh.position.clone().add(forward)). Para construir la base manualmente, establece la columna +Z a forward y elige el eje x que mantenga una rotación propiamente diestra (det = +1): xAxis = normalize(cross(up, forward)), luego makeBasis(xAxis, up, forward). Nota que esto es cross(up, forward) — no el right = cross(forward, up) de movimiento de §2. Apuntar a +Z (en lugar del −Z de una cámara) invierte el signo del eje x para que xAxis × up = forward; el marco sigue siendo diestro (sin espejo). No uses makeBasis(xAxis, up, -forward) para una malla — eso apunta a −forward (la convención de cámara) por lo que la malla mira hacia atrás.
  • Orientar una cámara para que mire a lo largo de forward (las cámaras miran −Z): establece la columna +Z a -forward — xAxis = normalize(cross(forward, up)), luego makeBasis(xAxis, up, -forward) (o simplemente camera.lookAt(target)).
  • Mantén un up del mundo consistente para que los objetos se mantengan erguidos; solo rota primitivas planas para que se levanten.
  • Verifica la orientación de importación glTF; depura con AxesHelper/ArrowHelper. Autocomprobación erguida: los personajes se paran en el suelo, no tumbados/hundidos.

4. La cámara debe coincidir con el movimiento

  • Mantén un moveForward/moveRight dedicado para el movimiento, calculado una vez y nunca mutado por el código de la cámara (alias de un vector temporal compartido hace que la cámara y el movimiento no coincidan — un error reproducible real).
  • Seguimiento en tercera persona: desired = playerPos + up*height + moveForward*(-followDist); interpola la cámara hacia él (usa suavizado basado en exp, escalado por delta), lookAt(player).
  • Orden de depuración aislar-la-capa: (1) teclas registradas → (2) señales de movimiento correctas → (3) cámara coincide. Corrige en ese orden.

5. Rendimiento

  • Minimiza las llamadas de dibujo (renderer.info.render.calls, objetivo <100): comparte materiales, InstancedMesh/BatchedMesh para objetos repetidos, atlas.
  • Desecha los recursos de GPU tú mismo (geometry/material/texture.dispose()) al cambiar de nivel — three.js no los recolecta como basura. Agrupa balas/enemigos/partículas.
  • Sin asignaciones por fotograma (reutiliza vectores temporales). Comprime texturas; LOD para distancia.

6. Assets (evita la trampa de la foto generada)

  • Elementos 3D interactivos (vistas de armas, personajes, accesorios, proyectiles) → construye a partir de geometría 3D / glTF, no de una imagen generada. Un JPG fotorrealista plano de un arma en manos usado como vista de arma FPS se ve mal, no se puede animar y (JPG no tiene alfa) se renderiza como un cuadro negro. Coloca una vista de arma 3D real como hijo de la cámara como una capa de renderizado superpuesta.
  • Reserva la generación de imágenes solo para assets planos 2D (texturas, fondos de cielo/menú, sprites 2D, arte de UI). Nunca uses una foto generada como malla 3D, vista de arma o sustituto de personaje — constrúyelos con geometría 3D / glTF. Establece crossOrigin="anonymous" en imágenes dibujadas en canvas/texturas. Consulta la skill imagine-grok-build (solo 2D — las herramientas de imagen no pueden producir 3D real).
  • Doctrina de arte de juego listo para el motor → abre game-asset-core (../game-asset-core/) para valores predeterminados + verificación ciega + disciplina de reintento, luego el especialista correspondiente: game-animation-frames (leyes de bucle / movimiento), game-tilesets, game-character-consistency, game-ui-icons. Estos son control de calidad/doctrina, no el pipeline de exportación. No envíes marcadores de posición de figuras de palitos cuando se espera arte real.
  • Sprites de juegos 2D / hojas de animación → ejecuta generate2dsprite (.grok/skills/generate2dsprite/SKILL.md): hojas magenta sólidas #FF00FF imagine_text_to_image + scripts de postprocesado de croma (el magenta es necesario para el procesador). Convierte PNGs/GIFs transparentes en Canvas/Phaser. Aplica igualmente game-asset-core (+ especialistas de animación/personajes cuando sea relevante).
  • Mapas 2D / niveles / paquetes de accesorios → abre generate2dmap (.grok/skills/generate2dmap/SKILL.md). Prefiere una base solo de cimientos + accesorios/colisión separados para mapas jugables. Valor predeterminado del navegador: raw_canvas / Phaser. Suelo/paredes embaldosables → también game-tilesets para comprobaciones de costuras 2×2.
  • Locomoción más densa opcional → ejecuta video2dsprite (Grok imagine_image_to_video + scripts de sandbox; base magenta). Prefiere generate2dsprite para héroes de producción nítidos. Usa game-animation-frames para leyes de bucle/prueba de volteo; prefiere video2dsprite sobre la cosecha ad-hoc solo con ffmpeg en este sandbox.

7. Audio, guardado, sensación

  • Audio: desbloquea AudioContext en el primer gesto del usuario (tocar para comenzar) o iOS estará en silencio; reanuda al cambiar la visibilidad (visibilitychange). (references/audio.md)
  • Guardado: localStorage/IndexedDB con un campo version + migraciones.
  • Jugo: sacudida de pantalla, pausa por impacto, interpolaciones suavizadas, partículas — baratos, gran mejora de calidad percibida. Mantén la presentación separada de la simulación.

8. Móvil

  • Distingue el tamaño del búfer del canvas del tamaño CSS; respeta devicePixelRatio.
  • touch-action: none, ajuste con letterbox a una resolución base, maneja la orientación.
  • Controles táctiles (joystick virtual + botones de acción), objetivos ≥44px.

Elección de pila / motor

  • 3D → three.js, idealmente mediante @react-three/fiber + drei (encaja en la app React; drei proporciona bloqueo de puntero/controles/cargadores) + @react-three/rapier para física/controladores de personajes. Ver references/3d-libs.md.
  • 2D → Canvas 2D nativo es suficiente para snake/tetris/flappy/platformer; recurre a Phaser solo cuando el género lo necesite.
  • Estas dependencias de juego no están preinstaladas — ejecuta npm install para ellas (y asegúrate de que estén en package.json para que la compilación de Vercel las tenga).

Criterios de finalización (antes de "listo")

  • Carga sin errores de consola; gameplay visible (no un canvas en blanco).
  • Autocomprobación de la skill controls superada (A = izquierda / D = derecha desde la cámara en persecución mientras avanzas; invierte un signo si está invertido). No solo una captura de pantalla.
  • Autocomprobaciones de 3D erguido y cámara coincidente superadas (§3, §4).
  • Funciona en viewport móvil con controles táctiles.
  • La compilación de producción (npm run build) renderiza la salida compilada, no solo el desarrollo.
  • Compartir / tarjeta X: abre la skill og — public/og.jpg personalizado y "type": "x:game" en src/lib/og/site.json. X usa og:type="x:game" para presentar el unfurl como una tarjeta de juego; no uses twitter:card o inventes x:type para esto. browser-smoke/brand-check advierten cuando las apps de canvas omiten el campo site.json.

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

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

Peer-to-peer realtime multiplayer over WebRTC data channels: every user of the deployed app connects directly to every other user (full mesh), the server only brokers the handshake at /api/rtc. Lowest possible latency, zero per-message server cost. Use for 2-8 player co-op/casual realtime: shared cursors, drawing, party games, casual action. Triggers: p2p, peer to peer, webrtc, low latency multiplayer, direct connection.

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