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 reemplazancontrols.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, R3FuseFrame, orequestAnimationFramepara canvas 2D). NuncasetInterval/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(noClock—Clock.getDelta()devuelve ~0 en una segunda llamada en el mismo fotograma, un error clásico de congelación).
- three.js: usa
- 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 * +rateinvierte (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/Cylinderapuntan +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 esmesh.lookAt(mesh.position.clone().add(forward)). Para construir la base manualmente, establece la columna +Z aforwardy elige el eje x que mantenga una rotación propiamente diestra (det = +1):xAxis = normalize(cross(up, forward)), luegomakeBasis(xAxis, up, forward). Nota que esto escross(up, forward)— no elright = 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 quexAxis × up = forward; el marco sigue siendo diestro (sin espejo). No usesmakeBasis(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)), luegomakeBasis(xAxis, up, -forward)(o simplementecamera.lookAt(target)). - Mantén un
updel 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/moveRightdedicado 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/BatchedMeshpara 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 skillimagine-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#FF00FFimagine_text_to_image+ scripts de postprocesado de croma (el magenta es necesario para el procesador). Convierte PNGs/GIFs transparentes en Canvas/Phaser. Aplica igualmentegame-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éngame-tilesetspara comprobaciones de costuras 2×2. - Locomoción más densa opcional → ejecuta
video2dsprite(Grokimagine_image_to_video+ scripts de sandbox; base magenta). Prefieregenerate2dspritepara héroes de producción nítidos. Usagame-animation-framespara leyes de bucle/prueba de volteo; prefierevideo2dspritesobre la cosecha ad-hoc solo con ffmpeg en este sandbox.
7. Audio, guardado, sensación
- Audio: desbloquea
AudioContexten 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 campoversion+ 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 installpara ellas (y asegúrate de que estén enpackage.jsonpara 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
controlssuperada (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.jpgpersonalizado y"type": "x:game"ensrc/lib/og/site.json. X usaog:type="x:game"para presentar el unfurl como una tarjeta de juego; no usestwitter:cardo inventesx:typepara esto.browser-smoke/brand-checkadvierten cuando las apps de canvas omiten el camposite.json.