Communitygithub.com

evalix098/tiktoklive

Crie jogos de navegador, experiências interativas/canvas/3D neste app TanStack Start + React. Use para qualquer jogo, simulação ou experiência WebGL/Canvas — 2D ou 3D, single-player. Abrange o loop do jogo e temporização, orientação 3D/câmera, colisão, desempenho, assets, áudio, salvamento, game feel e playbooks por gênero. Para sinais de entrada WASD/veículo/voo e A/D invertidos, abra a skill **`controls`** — não confie apenas neste arquivo ou racing-kart. Aciona com "jogo", "minecraft", "fps", "plataforma", "corrida", "tetris", "snake", "tiro", "3d", "three.js", "canvas", "voxel", "física".

O que é tiktoklive?

Esta skill é o guia definitivo para construir jogos 2D e 3D completos e corretos para navegador, usando React com TanStack Start e Three.js (ou Phaser para 2D). Ela resolve problemas críticos como loop de jogo com delta time (frame-rate independente), orientação 3D (evitando bugs clássicos de câmera e objetos virados), e trata corretamente a entrada WASD/veículo/voo — alertando que é obrigatório consultar a skill `controls` para evitar inversões de A/D e outros erros comuns. A skill também define o escopo de projeto: single-player por padrão, com suporte a 2–8 jogadores via skill `multiplayer-p2p` (WebRTC mesh), e fornece um sistema completo de referências para desempenho (minimizar draw calls, disposição de recursos GPU), assets 2D (via skills `game-asset-core` e `generate2dsprite` para sprites processados com magenta), áudio (desbloqueio de AudioContext no primeiro toque), salvamento (localStorage com migrações) e game feel (shake, hit-stop, partículas). Ela cobre também requisitos de mobile, build de produção e configuração de compartilhamento em X (cartão de jogo via skill `og`).

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construindo Jogos

Construa um jogo de navegador jogável e correto — não uma captura de tela estática. Um jogo é apenas uma rota React com um <canvas> (ou <Canvas> para R3F) mais uma interface DOM sobreposta. Estilize a sobreposição (tela inicial, HUD, menus) com a skill design-ui; esta skill é responsável pelo loop de jogo e pelo mundo.

Controles / A/D invertido: abra .grok/skills/controls/SKILL.md antes de escrever código de WASD, direção ou voo. Demonstrações de veículos/voo geralmente vêm com A/D trocado se você ler apenas este arquivo ou um playbook de um único gênero.

Nota de escopo — single-player, bots ou co-op P2P pequeno:

  • Entregue single-player ou single-player + IA/bots por padrão.
  • Cooperativo casual em tempo real para 2–8 jogadores (cursores compartilhados, jogos de festa, ação casual entre amigos) é suportado — use a skill multiplayer-p2p (malha WebRTC, sinalizada em /api/rtc). Leia o modelo de confiança dela primeiro.
  • P2P é o único multiplayer suportado no momento. Não construa pela metade sockets que não conseguem conectar.

Referências (carregue sob demanda):

  • Skill controls (../controls/) — obrigatória para movimento/direção/voo: A/D visível ao jogador, anti-padrão de direção invertida, ailerons de voo, auto-teste obrigatório
    • window.__controlsTest. Não opcional para veículos/aviões.
  • references/threejs-foundational.md — a referência aprofundada de 3D/loop/perf. Leia para 3D.
  • references/3d-libs.md — uso de three.js + @react-three/fiber + drei + rapier.
  • Skill threejs (../threejs/) — dump oficial completo da API Three.js + TSL (llms-full.txt). Carregue para materiais/shaders/WebGPU/loaders avançados; não para jogos 2D simples em canvas.
  • references/babylon.md — Babylon.js, a alternativa de engine 3D com baterias inclusas.
  • references/phaser.md — Phaser 3, a engine padrão para jogos 2D.
  • references/ecs-architecture.md — estrutura entidade-componente-sistema para jogos maiores.
  • references/genres/*.md — playbooks por gênero (fps, plataforma-2d, corrida-kart, puzzle-match3-tetris, voxel-minecraft, endless-runner, topdown-twin-stick, tower-defense, board-card-chess). Arquivos de gênero não substituem 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) — padrões de arte 2D prontos para engine e verificação ao gerar sprites, folhas, tiles ou UI (veja §6).

Escolha a referência específica de gênero/tópico para a construção; este arquivo é o núcleo universal para loop/mundo. Sinais de entrada → controls. Arte 2D → game-asset-core.


1. Loop de jogo e temporização (o problema #1 de correção)

  • Conduza o loop com o loop RAF da engine (renderer.setAnimationLoop, useFrame do R3F, ou requestAnimationFrame para canvas 2D). Nunca use setInterval/ setTimeout/Date.now() para temporização de jogo.
  • Escalone TODO movimento/animação pelo delta time (em segundos) para que a velocidade seja independente da taxa de quadros (60Hz vs 144Hz). Calcule o delta uma vez por quadro e reutilize-o.
    • three.js: use THREE.Timer (não Clock — Clock.getDelta() retorna ~0 em uma segunda chamada no mesmo quadro, um bug clássico de congelamento).
  • Limite o delta (min(delta, 0.1)) para que uma aba em segundo plano não teleporte as coisas.
  • Passo de tempo fixo para física/jogabilidade: acumule delta e simule em etapas a uma taxa fixa (ex.: 1/60) enquanto renderiza na taxa de exibição — evita tunelamento e não-determinismo.

2. Controles (delegue à skill controls)

Abra .grok/skills/controls/SKILL.md antes de implementar qualquer código WASD / direção / Voo. Essa skill é a fonte da verdade para:

  • A = esquerda / D = direita visível ao jogador (câmera chase, enquanto move para frente)
  • Por que KeyA → steer− + yaw += steer * +rate inverte (bug mais comum)
  • Veículo vs FPS (strafe ≠ steer), ailerons de asa fixa, notas de helicóptero/drone
  • Auto-teste obrigatório + sonda window.__controlsTest

Não trate genres/racing-kart.md como o único lugar onde os sinais de steer vivem — aviões, jetskis e mechs nunca o abrem.

Lembrete rápido (detalhes completos em controls):

// Rotação do corpo do veículo (câmera chase): A deve aumentar o yaw com esta base
forward = (-sin(yaw), 0, -cos(yaw))
// KeyA → steer = +1;  yaw += steer * turnRate * speedFactor * dt
// ERRADO (envia invertido): KeyA → steer = -1; yaw += steer * turnRate * dt
  • Pointer lock: apenas mouse-look — implemente WASD você mesmo; sobreposição clique-para-jogar; dispense ao travar.
  • Rastreie teclas com estado pressionado + dt; unifique dispositivos via references/input.md.
  • Finalize: execute a lista de verificação da skill controls. Apenas captura de tela é insuficiente para veículos/voo.

3. Orientação 3D e objetos do mundo (os bugs "de lado/para trás")

  • three.js é destro, +Y para cima: +X direita, +Y cima, +Z em direção ao espectador. Malhas encaram +Z; câmeras olham −Z (a pegadinha clássica de "câmera para trás").
  • Primitivas como Cone/Cylinder apontam +Y por padrão → gire para alinhar uma ponta com a frente (geo.rotateX(Math.PI/2)).
  • Orientando uma malha para encarar forward (malhas encaram +Z): a forma correta mais simples é mesh.lookAt(mesh.position.clone().add(forward)). Para construir a base manualmente, defina a coluna +Z como forward e escolha o eixo x que mantenha uma rotação propriamente destra (det = +1): xAxis = normalize(cross(up, forward)), então makeBasis(xAxis, up, forward). Note que isto é cross(up, forward) — não o right = cross(forward, up) do movimento da §2. Mirar +Z (em vez do −Z de uma câmera) inverte o sinal do eixo x de modo que xAxis × up = forward; o quadro permanece destro (sem espelhamento). Não use makeBasis(xAxis, up, -forward) para uma malha — isso mira −forward (a convenção da câmera) então a malha encara para trás.
  • Orientando uma câmera para olhar ao longo de forward (câmeras olham −Z): defina a coluna +Z como -forward — xAxis = normalize(cross(forward, up)), então makeBasis(xAxis, up, -forward) (ou apenas camera.lookAt(target)).
  • Mantenha um up consistente do mundo para que os objetos fiquem na vertical; apenas gire primitivas planas para ficarem em pé.
  • Verifique a orientação de importação glTF; depure com AxesHelper/ArrowHelper. Auto-teste vertical: personagens ficam no chão, não deitados/afundados.

4. Câmera deve concordar com o movimento

  • Mantenha moveForward/moveRight dedicados para movimento, calculados uma vez e nunca mutados pelo código da câmera (aliasing de um vetor temporário compartilhado faz a câmera e o movimento discordarem — um bug real reproduzível).
  • Seguir em terceira pessoa: desired = playerPos + up*height + moveForward*(-followDist); interpole a câmera em direção a ele (use suavização exponencial, escalonada por delta), lookAt(player).
  • Ordem de depuração isolando a camada: (1) teclas registram → (2) sinais de movimento corretos → (3) câmera concorda. Corrija nessa ordem.

5. Desempenho

  • Minimize chamadas de draw (renderer.info.render.calls, alvo <100): compartilhe materiais, InstancedMesh/BatchedMesh para objetos repetidos, atlas.
  • Descarte recursos GPU você mesmo (geometry/material/texture.dispose()) ao mudar de nível — three.js não faz GC neles. Pool balas/inimigos/partículas.
  • Sem alocações por quadro (reutilize vetores temporários). Comprima texturas; LOD para distância.

6. Assets (evite a armadilha da foto gerada)

  • Elementos 3D interativos (viewmodels de armas, personagens, adereços, projéteis) → construa a partir de geometria 3D / glTF, não de uma imagem gerada. Um JPG foto-realista plano de uma arma nas mãos usado como viewmodel de FPS parece errado, não pode animar e (JPG não tem alpha) renderiza como uma caixa preta. Pairote um viewmodel 3D real à câmera como uma camada de renderização sobreposta.
  • Reserve geração de imagem para assets 2D planos apenas (texturas, fundos de céu/menu, sprites 2D, arte de UI). Nunca use uma foto gerada como malha 3D, viewmodel ou substituto de personagem — construa-os em geometria 3D / glTF. Defina crossOrigin="anonymous" em imagens desenhadas em canvas/texturas. Veja a skill imagine-grok-build (apenas 2D — ferramentas de imagem não podem produzir 3D real).
  • Doutrina de arte de jogo pronta para engine → abra game-asset-core (../game-asset-core/) para padrões + verificação cega + disciplina de repetição, então o especialista correspondente: game-animation-frames (leis de loop/movimento), game-tilesets, game-character-consistency, game-ui-icons. Estas são QC/doutrina, não o pipeline de exportação. Não entregue placeholders de palito quando arte real é esperada.
  • Sprites 2D / folhas de animação de jogo → execute generate2dsprite (.grok/skills/generate2dsprite/SKILL.md): folhas magenta sólidas #FF00FF imagine_text_to_image + scripts de pós-processamento chroma (magenta é obrigatório para o processador). Gere PNGs/GIFs transparentes no Canvas/Phaser. Ainda aplique game-asset-core (+ especialistas de animação/personagem quando relevante).
  • Mapas 2D / níveis / pacotes de adereços → abra generate2dmap (.grok/skills/generate2dmap/SKILL.md). Prefira base apenas com fundação + adereços separados/colisão para mapas jogáveis. Padrão do navegador: raw_canvas / Phaser. Chão/paredes com tile → também game-tilesets para verificações de emenda 2×2.
  • Locomoção mais densa opcional → execute video2dsprite (Grok imagine_image_to_video + scripts de sandbox; base magenta). Prefira generate2dsprite para heróis nítidos de produção. Use game-animation-frames para leis de loop/teste de flip; prefira video2dsprite em vez de colheita ad-hoc apenas com ffmpeg neste sandbox.

7. Áudio, salvamento, feel

  • Áudio: desbloqueie AudioContext no primeiro gesto do usuário (toque para iniciar) senão o iOS fica mudo; retome em visibilitychange. (references/audio.md)
  • Salvamento: localStorage/IndexedDB com um campo version + migrações.
  • Juice: shake de tela, hit-stop, tweens suavizados, partículas — barato, enorme aumento de qualidade percebida. Mantenha apresentação separada da simulação.

8. Mobile

  • Diferencie o tamanho do buffer do canvas do tamanho CSS; respeite devicePixelRatio.
  • touch-action: none, ajuste letterbox para uma resolução base, lide com orientação.
  • Controles de toque (joystick virtual + botões de ação), alvos ≥44px.

Stack / escolha da engine

  • 3D → three.js, idealmente via @react-three/fiber + drei (encaixa no app React; drei fornece pointer-lock/controls/loaders) + @react-three/rapier para física/controladores de personagem. Veja references/3d-libs.md.
  • 2D → Canvas 2D nativo é suficiente para snake/tetris/flappy/platformer; recorra ao Phaser apenas quando o gênero precisar.
  • Essas dependências de jogo não estão pré-instaladas — instale-as com npm install (e certifique-se de que estejam em package.json para que o build do Vercel as tenha).

Critérios de conclusão (antes de "pronto")

  • Carrega sem erros no console; jogabilidade visível (não um canvas em branco).
  • Auto-teste da skill controls passou (A = esquerda / D = direita da câmera chase enquanto move para frente; inverta um sinal se estiver invertido). Não apenas captura de tela.
  • Auto-testes de vertical 3D e concordância da câmera passam (§3, §4).
  • Funciona em viewport mobile com controles de toque.
  • Build de produção (npm run build) renderiza a saída construída, não apenas dev.
  • Compartilhar / cartão X: abra a skill og — public/og.jpg personalizado e "type": "x:game" em src/lib/og/site.json. X usa og:type="x:game" para apresentar o unfurl como um cartão de jogo; não use twitter:card nem invente x:type para isso. browser-smoke / brand-check avisam quando apps canvas omitem o 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).

Habilidades Relacionadas