Créer des jeux
Créez un jeu de navigateur jouable et correct – pas une capture d'écran statique. Un jeu est simplement une route React avec un <canvas> (ou <Canvas> pour R3F) et une interface DOM superposée. Stylisez la superposition (écran d'accueil, HUD, menus) avec la compétence design-ui ; cette compétence gère la boucle de jeu et le monde.
Contrôles / A/D inversé : ouvrez .grok/skills/controls/SKILL.md avant d'écrire du code WASD, de direction ou de vol. Les démos de véhicules/vol livrent souvent un A/D inversé si vous lisez uniquement ce fichier ou un seul guide de genre.
Note de périmètre – solo, bots ou coop P2P à petite échelle :
- Livrez solo ou solo + IA/bots par défaut.
- Coopération 2–8 joueurs / temps réel décontracté (curseurs partagés, jeux de groupe, action décontractée entre amis) est prise en charge – utilisez la compétence
multiplayer-p2p(maillage WebRTC, signalé via/api/rtc). Lisez d'abord son modèle de confiance. - P2P est le seul multijoueur pris en charge pour l'instant. Ne construisez pas à moitié des sockets qui ne peuvent pas se connecter.
Références (chargement à la demande) :
- Compétence
controls(../controls/) – obligatoire pour les déplacements/volant/vol : A/D visible par le joueur, anti-modèle du volant inversé, ailerons de vol, auto-test obligatoire +window.__controlsTest. Non facultatif pour les véhicules/avions. references/threejs-foundational.md– la référence approfondie 3D/boucle/perf. À lire pour la 3D.references/3d-libs.md– utilisation de three.js + @react-three/fiber + drei + rapier.- Compétence
threejs(../threejs/) – dump officiel complet de l'API Three.js + TSL (llms-full.txt). À charger pour les matériaux/shaders/WebGPU/loaders avancés ; pas pour les jeux 2D simples. references/babylon.md– Babylon.js, l'alternative de moteur 3D tout-en-un.references/phaser.md– Phaser 3, le moteur par défaut pour les jeux 2D.references/ecs-architecture.md– architecture de système de composants d'entités pour les jeux plus volumineux.references/genres/*.md– guides par genre (fps, platformer-2d, racing-kart, puzzle-match3-tetris, voxel-minecraft, endless-runner, topdown-twin-stick, tower-defense, board-card-chess). Les fichiers de genre ne remplacent pascontrols.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) – valeurs par défaut et vérification d'art 2D prêt pour le moteur lors de la génération de sprites, feuilles, tuiles ou UI (voir §6).
Choisissez la référence de genre/sujet spécifique pour la construction ; ce fichier est le noyau universel pour la boucle/monde. Signes d'entrée → controls. Art de jeu 2D → game-asset-core.
1. Boucle de jeu et timing (le problème de correction n°1)
- Pilotez la boucle avec la boucle RAF du moteur (
renderer.setAnimationLoop,useFramede R3F ourequestAnimationFramepour Canvas 2D). JamaissetInterval/setTimeout/Date.now()pour le timing du jeu. - Mettez à l'échelle TOUT déplacement/animation par le delta time (secondes) afin que la vitesse soit indépendante de la fréquence d'images (60 Hz vs 144 Hz). Calculez le delta une fois par image et réutilisez-le.
- three.js : utilisez
THREE.Timer(pasClock–Clock.getDelta()renvoie ~0 lors d'un second appel dans la même image, un bug de freeze classique).
- three.js : utilisez
- Limitez le delta (
min(delta, 0.1)) pour qu'un onglet en arrière-plan ne téléporte pas les objets. - Pas de temps fixe pour la physique/le gameplay : accumulez le delta et exécutez la simulation à un taux fixe (par exemple 1/60) tout en rendant au taux d'affichage – empêche le tunneling et la non-déterminisme.
2. Contrôles (déléguez à la compétence controls)
Ouvrez .grok/skills/controls/SKILL.md avant d'implémenter tout code WASD / volant / vol. Cette compétence est la source de vérité pour :
- A = gauche / D = droite visible par le joueur (caméra de poursuite, en avançant)
- Pourquoi
KeyA → steer−+yaw += steer * +rateinverse (le bug le plus courant) - Véhicule vs FPS (strafe ≠ volant), ailerons d'avion à voilure fixe, notes pour hélico/drone
- Auto-test obligatoire + sonde
window.__controlsTest
Ne traitez pas genres/racing-kart.md comme le seul endroit où vivent les signes de volant – les avions, jet-skis et mechs ne l'ouvrent jamais.
Rappel court (détails complets dans controls) :
// Lacet du corps du véhicule (caméra de poursuite) : A doit augmenter le lacet avec cette base
forward = (-sin(yaw), 0, -cos(yaw))
// KeyA → steer = +1 ; yaw += steer * turnRate * speedFactor * dt
// FAUX (livre inversé) : KeyA → steer = -1 ; yaw += steer * turnRate * dt
- Verrouillage du pointeur : regard à la souris uniquement – implémentez WASD vous-même ; superposition clic-pour-jouer ; fermez au verrouillage.
- Suivez les touches avec l'état maintenu + dt ; unifiez les périphériques via
references/input.md. - Terminez : exécutez la liste de vérification de la compétence
controls. Une simple capture d'écran est insuffisante pour les véhicules/vol.
3. Orientation 3D et objets du monde (les bugs "de côté/à l'envers")
- three.js est pour droitiers, +Y vers le haut : +X droite, +Y haut, +Z vers le spectateur. Les maillages font face à +Z ; les caméras regardent −Z (l'erreur classique "caméra à l'envers").
- Les primitives comme
Cone/Cylinderpointent +Y par défaut → tournez pour aligner une pointe vers l'avant (geo.rotateX(Math.PI/2)). - Orienter un maillage pour faire face à
forward(les maillages font face à +Z) : la manière correcte la plus simple estmesh.lookAt(mesh.position.clone().add(forward)). Pour construire la base à la main, définissez la colonne +Z surforwardet choisissez l'axe x qui maintient une rotation correcte pour droitiers (det = +1) :xAxis = normalize(cross(up, forward)), puismakeBasis(xAxis, up, forward). Notez qu'il s'agit decross(up, forward)– pas duright = cross(forward, up)de déplacement du §2. Cibler +Z (au lieu du −Z d'une caméra) inverse le signe de l'axe x de sorte quexAxis × up = forward; le repère reste pour droitiers (sans miroir). N'utilisez pasmakeBasis(xAxis, up, -forward)pour un maillage – cela cible -forward (la convention caméra) donc le maillage fait face à l'envers. - Orienter une caméra pour regarder le long de
forward(les caméras regardent −Z) : définissez la colonne +Z sur-forward–xAxis = normalize(cross(forward, up)), puismakeBasis(xAxis, up, -forward)(ou simplementcamera.lookAt(target)). - Gardez un
upde monde cohérent pour que les objets restent droits ; ne faites pivoter que les primitives plates pour les mettre debout. - Vérifiez l'orientation d'importation glTF ; déboguez avec
AxesHelper/ArrowHelper. Auto-test de redressement : les personnages se tiennent sur le plan de sol, pas couchés/enfoncés.
4. La caméra doit être en accord avec le mouvement
- Gardez un
moveForward/moveRightdédié pour le mouvement, calculé une fois et jamais modifié par le code de la caméra (l'aliasing d'un vecteur temporaire partagé fait que la caméra et le mouvement ne sont pas d'accord – un vrai bug reproductible). - Suivi à la troisième personne :
desired = playerPos + up*height + moveForward*(-followDist); interpolez la caméra vers elle (utilisez un lissage expo, mis à l'échelle du delta),lookAt(player). - Ordre de débogage isolez-la-couche : (1) les touches s'enregistrent → (2) les signes de mouvement sont corrects → (3) la caméra est d'accord. Corrigez dans cet ordre.
5. Performances
- Minimisez les appels de tirage (
renderer.info.render.calls, ciblez <100) : partagez les matériaux,InstancedMesh/BatchedMeshpour les objets répétés, atlas. - Libérez vous-même les ressources GPU (
geometry/material/texture.dispose()) lors des changements de niveau – three.js ne les nettoie pas. Mettez en pool les balles/ennemis/particules. - Pas d'allocations par image (réutilisez les vecteurs temporaires). Compressez les textures ; LOD pour la distance.
6. Assets (évitez le piège de la photo générée)
- Éléments 3D interactifs (modèles d'armes, personnages, accessoires, projectiles) → construisez à partir de géométrie 3D / glTF, pas d'une image générée. Un JPG photoréaliste plat d'une arme dans les mains utilisé comme modèle d'arme FPS a l'air faux, ne peut pas être animé et (le JPG n'a pas d'alpha) rend une boîte noire. Rattachez un vrai modèle 3D à la caméra en tant que couche de rendu superposée.
- Réservez la génération d'images aux assets 2D plats uniquement (textures, arrière-plans de ciel/menus, sprites 2D, art UI). N'utilisez jamais une photo générée comme maillage 3D, modèle d'arme ou substitut de personnage – construisez-les en géométrie 3D / glTF.
Définissez
crossOrigin="anonymous"sur les images dessinées sur canvas/textures. Voir la compétenceimagine-grok-build(2D uniquement – les outils d'image ne peuvent pas produire de vraie 3D). - Doctrine d'art de jeu prêt pour le moteur → ouvrez
game-asset-core(../game-asset-core/) pour les valeurs par défaut + vérification aveugle + discipline de nouvelle tentative, puis le spécialiste correspondant :game-animation-frames(lois de boucle/mouvement),game-tilesets,game-character-consistency,game-ui-icons. Ce sont des doctrines QC, pas le pipeline d'exportation. Ne livrez pas de placeholders en bâtons alors que du vrai art est attendu. - Sprites 2D de jeu / feuilles d'animation → exécutez
generate2dsprite(.grok/skills/generate2dsprite/SKILL.md) : feuilles magenta#FF00FFsolidesimagine_text_to_image+ scripts de post-traitement chroma (le magenta est requis pour le processeur). Intégrez des PNG/GIF transparents dans Canvas/Phaser. Appliquez toujoursgame-asset-core(+ les spécialistes animation/personnage le cas échéant). - Cartes 2D / niveaux / packs d'accessoires → ouvrez
generate2dmap(.grok/skills/generate2dmap/SKILL.md). Préférez une base uniquement fondamentale + des accessoires/collision séparés pour des cartes jouables. Par défaut navigateur :raw_canvas/ Phaser. Sols/murs carrelables → aussigame-tilesetspour les vérifications de coutures 2×2. - Locomotion plus dense optionnelle → exécutez
video2dsprite(Grokimagine_image_to_video+ scripts sandbox ; base magenta). Préférezgenerate2dspritepour des héros de production nets. Utilisezgame-animation-framespour les lois de boucle/test de retournement ; préférezvideo2dspriteà une récolte ad-hoc ffmpeg uniquement dans ce sandbox.
7. Audio, sauvegarde, "game feel"
- Audio : déverrouillez
AudioContextsur le premier geste utilisateur (tap-pour-démarrer) sinon iOS reste silencieux ; reprenez survisibilitychange. (references/audio.md) - Sauvegarde :
localStorage/IndexedDB avec un champversion+ migrations. - Jus : tremblement d'écran, arrêt-sur-image, tweens fluides, particules – peu coûteux, énorme amélioration de qualité perçue. Gardez la présentation séparée de la simulation.
8. Mobile
- Distinguez la taille du buffer canvas de la taille CSS ; respectez
devicePixelRatio. touch-action: none, letterbox-fit à une résolution de base, gérez l'orientation.- Contrôles tactiles (joystick virtuel + boutons d'action), cibles ≥44px.
Choix de la pile / moteur
- 3D → three.js, idéalement via @react-three/fiber + drei (s'intègre à l'app React ; drei fournit verrouillage du pointeur/contrôles/chargeurs) + @react-three/rapier pour la physique/contrôleurs de personnage. Voir
references/3d-libs.md. - 2D → Le Canvas 2D natif suffit pour snake/tetris/flappy/platformer ; utilisez Phaser uniquement lorsque le genre le nécessite.
- Ces dépendances de jeu ne sont pas préinstallées – installez-les avec
npm install(et assurez-vous qu'elles atterrissent danspackage.jsonpour que le build Vercel les ait).
Critères de finition (avant "terminé")
- Se charge sans erreurs console ; gameplay visible (pas un canvas vide).
- Auto-test de la compétence
controlsréussi (A = gauche / D = droite depuis la caméra de poursuite en avançant ; inversez un signe si inversé). Pas seulement une capture d'écran. - Auto-tests de redressement 3D et d'accord de caméra réussis (§3, §4).
- Fonctionne sur la fenêtre mobile avec des contrôles tactiles.
- Le build de production (
npm run build) rend le résultat construit, pas seulement le développement. - Carte de partage / X : ouvrez la compétence
og–public/og.jpgpersonnalisée et"type": "x:game"danssrc/lib/og/site.json. X utiliseog:type="x:game"pour présenter le déploiement sous forme de carte de jeu ; n'utilisez pastwitter:cardou n'inventez pasx:typepour cela.browser-smoke/brand-checkavertissent lorsque les applications canvas omettent le champsite.json.