Jeux 3D photoniques à partir de code

Procédure pour transformer une scène 3D générée par code en un jeu court et jouable, d'apparence photographique. Cible n'importe quel genre, pas seulement les jeux de tir.

Qu'est-ce que Jeux 3D photoniques à partir de code ?

Ce skill définit une procédure outil-indépendante pour produire un jeu 3D photoréaliste jouable à partir de code, en utilisant n'importe quel moteur (WebGL, WebGPU, Three.js, Unity, Unreal). Il s'inspire du jeu *Saltline* (un navigateur de 1,4 Mo sans ressources externes, créé avec Claude Fable 5.2) et conditionne cette discipline de production dans des portes exécutables, de sorte qu'un modèle à faible coût (comme DeepSeek V4.1 Flash) puisse atteindre le même standard. Le skill guide le développeur à travers une séquence de six tables et sept portes rigoureuses (rendu, recensement, éclairage, collision, test de jeu, produit, mobile, aspect visuel), garantissant qu'un cadre magnifique n'est jamais livré sans une coque de jeu finie (écran titre, paramètres, pause, sauvegarde, objectifs, variété de contenu). Il met l'accent sur le fait de remplir des tables plutôt que d'inventer une architecture, délègue tout jugement à des contrôles automatisés, et insiste sur une règle de 'un changement par cycle' pour éviter les régressions. Le résultat n'est pas le même jeu que Saltline, mais la même discipline, avec des preuves enregistrées dans les études de cas du dépôt.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NorwinYu/photoreal-game/tree/HEAD

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

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

Documentation

Que fait Jeux 3D photoniques à partir de code ?

Une procédure pour transformer une scène 3D générée par code en un jeu court et jouable qui se lit comme une photographie. La cible est un jeu, pas une image fixe, une démo technique ou une visite guidée : un joueur avec un verbe, un système qui répond, un moyen de gagner et un moyen de perdre.

Rien ici ne présuppose un genre. Le sujet décide du verbe — une cour de conteneurs suggère de transporter une charge avant la fin d'un quart de travail ; un atelier suggère de réparer une machine ; une cage d'escalier suggère de sortir sans être vu. Les jeux de tir sont une instanciation parmi d'autres, et la même procédure ne les produit que lorsque le sujet le demande.

La procédure est indépendante de l'outil. Elle suppose un agent capable de modifier des fichiers, d'exécuter des commandes et d'inspecter des images. Rien ci-dessous ne dépend d'un moteur, d'une version de bibliothèque ou d'un produit spécifique.

Origine et importance. Cette compétence existe pour répondre à une question posée par Saltline — un jeu de tir pour navigateur de 1 423 668 octets dans un seul fichier, sans ressources externes, créé avec Claude Fable 5.2. La partie intéressante n'était pas la taille ; c'était que le modèle a écrit le générateur. Ce skill regroupe cette discipline de production en portes exécutables, afin qu'un modèle à faible coût (tel que DeepSeek V4.1 Flash) puisse être tenu au même niveau. Le résultat n'est pas le même jeu ; c'est la même discipline — et la preuve est enregistrée dans les études de cas du dépôt.

Le bundle de vérification est facultatif mais recommandé : il rend les portes exécutables au lieu d'être seulement des aspirations. Il nécessite Node.js 22+, Python 3.10+ avec Pillow, et un binaire Chrome/Chromium (CHROME_PATH s'il n'est pas dans un emplacement standard). Le texte du skill lui-même n'a pas de dépendances.

Comment exécuter ceci avec un modèle à faible coût

Le skill est écrit pour qu'un modèle faible puisse l'exécuter : chaque jugement important est délégué à une vérification, et le travail du modèle consiste à remplir des tableaux et à appliquer le correctif le mieux classé. Suivez ces règles à la lettre.

  1. Ne concevez pas l'architecture. Partez d'un squelette qui a déjà : le harnais de rendu, le contrat de page (__READY, __STATS, __SCENE, __AUDIT, __COLLIDERS, __BOUNDS, __TESTMOVE, __TEST, __PRODUCT), la chaîne de post-traitement, une coque de jeu finie (titre, paramètres, pause, sauvegarde, tactile, marqueurs HUD) et une table d'éléments vide. Copiez-le, puis remplissez les tableaux. L'architecture inventée à chaque exécution est l'endroit où les modèles faibles échouent.
  2. Remplissez, n'inventez pas. Les produits de travail sont six tableaux : produit (coque + contenu), direction artistique, kit (dimensions + pièces + décalcomanies), surfaces (albedo/rugosité/normale), lumières (position + luminaire), et la boucle (verbe/système/retour/échec/test).
  3. D'abord le produit, ensuite l'aspect visuel. produit → recensement → lumières → collision → test de jeu → mobile → aspect. Un cadre qui est beau mais n'a pas de paramètres, pas de second rôle ennemi, pas de marqueurs d'objectif ou pas de chemin tactile n'est pas une manche terminée.
  4. Un changement par cycle, puis exécutez toutes les portes. Un cycle n'est valide que si aucune porte ne régresse. Un gain visuel qui casse le produit ou la boucle est annulé.
  5. Ne vous auto-évaluez jamais. Si une porte est en désaccord avec votre opinion, la porte gagne. Si une porte est erronée, corrigez la porte avec un contre-exemple — ne la contournez jamais.
  6. Arrêtez-vous au budget ou au plateau, selon ce qui se présente en premier, et signalez la pire caméra et la liste des portes en échec.

Un modèle qui suit ces six règles produit une sortie comparable à une fraction du coût ; un modèle qui ignore la règle 5 produit des régressions d'aspect plausible.

Contrat de livraison

Une exécution n'est complète que lorsque ces éléments existent et que toutes les portes sont vertes :

ArtefactVérification
un seul HTML autonome, aucune requête réseaucharger avec le réseau désactivé
contrat de page exposé (__READY, __STATS, __SCENE, __AUDIT, __COLLIDERS, __BOUNDS, __TESTMOVE, __TEST, __GAME, __PRODUCT)le harnais les lit
coque de jeu finiemenu, paramètres, pause, sauvegarde, tactile, hiérarchie HUD, fin/redémarrage
largeur de contenu≥2 rôles d'ennemis/éléments interactifs, ≥2 outils, ≥1 chaîne d'objectifs, ≥3 étapes
rapport de recensementcouverture = 100%, zéro échec
audit d'éclairagechaque lumière ancrée à un luminaire
rapport de collisionzéro pénétration, zéro hors-limite, parité des collisionneurs 100%
test de jeuboucle réalisable, chemin d'échec accessible, redémarrage fonctionne
rapport mobilemise en page 390×844, aucun débordement horizontal, commandes tactiles présentes
rapport d'encadrement sur 3 à 6 objets du sujetchaque métrique >= 0,8 de la référence
score d'imagerapporté, mais jamais utilisé pour passer outre une porte

Contrat de produit fini

Un cadre jouable n'est pas un jeu fini. Les portes de boucle protègent le comportement ; les portes produit protègent la coque, la largeur du contenu et la première impression. Déclarez ce qui suit dans la page pour que harness/product.mjs puisse le vérifier sans lire dans les pensées du modèle.

ArtefactMinimum
Écransmenu, jeu, pause, paramètres, perdu, gagné
Écran titrevisible au chargement ; HUD caché ; titre, prémisse, début, paramètres/commandes
Paramètressensibilité, volume, FOV, inversion Y, qualité (ou un ensemble équivalent)
Persistanceune clé survit au rechargement (meilleur score/progression/paramètres)
Entréeclavier + souris + tactile ; visée de secours lorsque le verrouillage du pointeur échoue
Objectifs≥1 chaîne avec ≥3 étapes et marqueurs/boussole dans le monde
Rôles≥2 rôles d'ennemis/obstacles/éléments interactifs, pas un seul recoloré
Outils≥2 : un verbe principal et un verbe secondaire (arme/outil/capacité)
HUDobjectif+progression, survie, arme/munitions, invite contextuelle, boussole/marqueurs, sous-titres
Audiomuet + ≥6 événements de changement d'état
Camérascaméras héros + plan serré fixes dans __PRODUCT.cameras
Performancebudgets déclarés pour les appels/triangles/lumières, mesurés après le démarrage
Mobile390×844 sans débordement horizontal ; commandes tactiles accessibles

Budget de contenu pour une tranche verticale

Remplissez ceci avant toute passe artistique. Une tranche verticale est une session de 3 à 8 minutes avec une chaîne d'objectifs complète, deux rôles, un système signature et une coque conçue. Elle est plus petite qu'une bande-annonce et plus grande qu'une démo technique.

EmplacementTranche verticalePetit jeu fini
Objectifs1 chaîne, 3 étapes1–3 chaînes, 5–8 étapes
Rôles d'ennemis/éléments interactifs23–5 + un climax
Armes/outils2 (principal + secondaire)3–5
Verbes joueurse déplacer, viser, tirer, recharger+ s'accroupir/sauter/interagir/capacité
Mondeun lieu, 3 couches de profondeur2–3 espaces connectés
Coquetitre, pause, paramètres, fin+ sauvegarde, qualité, tactile
Session3–8 min10–30 min

Le manifeste est une déclaration ; la porte vérifie le comportement du DOM et les comptes déclarés. Ne déclarez pas ce que la page ne fait pas.

window.__PRODUCT = {
  title: { name: 'Titre du jeu', start: '#start', hud: '#hud', hudHiddenOnTitle: true },
  screens: ['menu', 'playing', 'paused', 'settings', 'lost', 'won'],
  ui: { start: '#start', hud: '#hud', pause: '#pause', settings: '#settings', end: '#end', touch: '#touch' },
  settings: ['sensitivity', 'volume', 'fov', 'invertY', 'quality'],
  persistence: ['game.best'],
  input: { keyboard: true, mouse: true, touch: true },
  content: {
    objectives: [{ id: 'objective-1', title: 'Objectif', steps: 3 }],
    roles: ['role-a', 'role-b'],
    tools: ['tool-a', 'tool-b'],
    beats: ['intro', 'contact', 'mid', 'climax', 'win'],
  },
  hud: ['objective', 'compass', 'health', 'ammo', 'prompt', 'subtitles'],
  audio: { events: 10, mute: true },
  perf: { maxCalls: 700, maxTris: 400000, maxLights: 14 },
  cameras: [
    { name: 'hero', cam: [0.5, 1.7, 10, -2.6, 1.3, -10] },
    { name: 'close', cam: [-6.4, 1.4, 5.2, -9.9, 1.0, 2.2] },
  ],
  test: { start: 'start', pause: 'pause', resume: 'resume', settings: 'openSettings', save: 'save' },
};

Actions __TEST standard (actions supplémentaires autorisées) : start, pause, resume, openSettings, closeSettings, save, state. Elles doivent fonctionner sans verrouillage de pointeur et renvoyer un instantané JSON sûr. L'écran titre doit masquer le HUD ; le démarrage doit le révéler ; les écrans de paramètres, de pause et de fin doivent être inspectables via le DOM.

Quand l'utiliser

  • Une scène est géométriquement correcte mais semble plate, plastique ou « générée ».
  • Un rendu doit correspondre à une photographie de référence, un concept ou une direction artistique.
  • L'éclairage, les matériaux ou la composition doivent être améliorés de manière contrôlée.
  • Une longue génération doit rester cohérente sur de nombreuses itérations.

Quand ne pas l'utiliser

  • Sortie délibérément stylisée (ombrage plat, cel, schématique, ressemblant à une interface utilisateur). Celles-ci nécessitent une abstraction cohérente, pas une plausibilité physique. La procédure se transfère, mais remplacez le profil photoréaliste et la porte d'aspect par un profil cohérent avec le style ; une scène stylisée mesurée par rapport à un profil photographique perd par construction, pas par qualité.
  • Tâches de précision (CAO, dessins techniques) où la lisibilité prime sur le réalisme.
  • Scènes sans caméra : visualisation de données, graphes de nœuds, interfaces utilisateur.

Modèle du problème

Le réalisme perçu provient de cinq leviers. Appliquez-les dans cet ordre ; le retour sur effort diminue fortement à mesure que vous descendez dans la liste.

  1. Lumière — une source dominante unique avec une direction, une couleur et une élévation définies, plus un environnement pour les réflexions et le remplissage.
  2. Matériaux — variation de rugosité, de normales et de saleté, plutôt que la couleur seule.
  3. Composition et densité — objets à plusieurs échelles et profondeurs, avec un point focal clair et des indices d'échelle lisibles.
  4. Formation de l'image — anti-aliasing, mappage de tons, bloom, grain, vignette.
  5. Détail géométrique — le dernier recours, et seulement là où il survit à plusieurs pixels à l'écran.

Deux conséquences qui méritent d'être énoncées explicitement :

  • Les détails plus petits qu'environ deux pixels sont supprimés par l'anti-aliasing et ne contribuent pas à l'image. Ajouter un nombre de polygones à cette échelle est inutile.
  • Une scène peut avoir une exposition correcte et sembler encore vide. Le vide est un problème de densité, pas un problème de réglage.

Trois autres conséquences pour un jeu fini :

  • Un cadre est nécessaire mais pas suffisant. La couche produit — art de l'écran titre, paramètres, pause, sauvegarde, tactile, marqueurs d'objectif, radio/sous-titres, largeur de contenu — est jugée avant que le joueur ne remarque l'éclairage.
  • Les cinq leviers sont indépendants du sujet. Ils s'appliquent à un port de jour, un intérieur lumineux, un champ enneigé ou une arène stylisée. La nuit/pluie/brouillard sont un scénario, pas la valeur par défaut.
  • Le score d'image est une boussole pour un seul aspect de référence. Il ne peut pas distinguer un jeu fini d'une belle démo.

Flux de travail

Chaque étape a une sortie. Ne commencez pas l'étape suivante sans elle.

Étape 1 — Rendre le rendu observable (recommandé avant tout travail sur la scène)

Produisez un moyen reproductible de capturer une image et de l'inspecter.

Sortie : une commande qui renvoie une image et, idéalement, quelques chiffres.

Si votre environnement a déjà un outil de capture d'écran, utilisez-le. Sinon, construisez le plus petit qui fonctionne :

  • Lancez un navigateur sans tête contre un serveur statique local.
  • Attendez un signal de disponibilité de la page (voir le contrat ci-dessous), puis capturez.
  • Optionnellement, calculez des statistiques d'image : histogramme d'exposition, écrêtage, nombre de couleurs, densité de bords.

Contrat de page qui rend les captures déterministes :

window.__READY = true;                      // défini après quelques images rendues
window.__STATS = { calls, triangles };      // compteurs de rendu facultatifs
// paramètres de requête facultatifs
// ?shot=1            masquer l'interface utilisateur
// ?cam=x,y,z,tx,ty,tz caméra fixe
// ?seed=N            graine aléatoire fixe

Règles :

  • Caméra fixe, graine fixe, fenêtre fixe pour chaque comparaison.
  • Stockez chaque capture sous un nom versionné ; ne remplacez jamais la précédente.
  • Si aucune métrique n'est disponible, conservez les images et comparez-les côte à côte. La comparaison visuelle est suffisante ; les métriques ne font qu'accélérer l'attribution.

Étape 2 — Rédigez un brief de direction artistique

Sortie : un petit tableau. Chaque ligne doit être suffisamment concrète pour être implémentée.

DécisionContenu
Sujetce sur quoi porte l'image, à quelle échelle
Heure et météodétermine le brouillard, la force de réflexion, le contraste
Lumière clédirection, élévation, température de couleur, intensité
Ciel et ambiancecouleur du remplissage d'ombre
Famille de matériauxquelles surfaces existent, à quel point elles sont rugueuses, à quel point elles sont mouillées
Point focaloù l'œil doit se poser en premier
Contraintesce qui ne doit pas apparaître (par exemple, blanc pur, sol plat, ciel clair)

Conseils :

  • Choisissez une histoire de lumière dominante. Les sources supplémentaires sont le remplissage, le rebond ou les sources pratiques, et doivent être subordonnées.
  • Contraignez le sujet avant d'ajouter des détails. Les conditions qui réduisent la complexité visible — nuit, pluie, brouillard, poussière, contre-jour, décors industriels ou intérieurs — sont des choix légitimes et efficaces, pas des raccourcis.
  • Choisissez une élévation de lumière clé délibérément. La longueur de l'ombre évolue comme hauteur / tan(élévation) : une lumière clé basse produit de longues ombres qui peuvent placer tout le premier plan dans l'ombre, ce qui se lit comme « pas d'ombres ». Les élévations moyennes (environ 20 à 30°) donnent généralement à la fois de la forme et une zone éclairée pour contraster.
  • Choisissez le scénario d'éclairage avant le kit. Ne prenez pas par défaut la nuit, la pluie ou les intérieurs industriels parce qu'ils cachent les détails manquants. La nuit est une option ; une aube en contre-jour ou un intérieur lumineux est plus difficile et souvent plus convaincant.
ScénarioCléRemplissage / IBLAirMatériau signature
Nuit industrielleclé froide basse-moyenne, sources pratiquesenv de ciel, flaques chaudesexponentiel, couleur du cielsol mouillé, luminaires émissifs
Lumière du jour nuageuseclé de ciel large, 35–60°IBL fortperspective aérienne finebéton mat, flaques
Heure dorée / contre-jourclé chaude basse derrière le sujetremplissage de ciel froidbrume longue, bordasphalte mouillé, verre, métal
Midi clairclé haute, ombres duresremplissage ciel + rebondminimalsable, pierre, peinture
Intérieur avec sources pratiquesfenêtre + quelques sources chaudesenv de fenêtre/cielrayons de lumière, poussièrebois, tissu, métal
Souterrain / lumière artificiellesources pratiques + émissivesambiance faiblevolumétriquebéton humide, panneaux

Une scène en contre-jour n'est pas « plus facile » : elle expose les hautes lumières écrêtées, les dominantes de couleur et les silhouettes faibles. Corrigez l'exposition et l'adoucissement des hautes lumières en …

[tronqué pour la traduction]

Skills associés