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.
- 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. - 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).
- 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. - 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é.
- 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.
- 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 :
| Artefact | Vérification |
|---|---|
| un seul HTML autonome, aucune requête réseau | charger 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 finie | menu, 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 recensement | couverture = 100%, zéro échec |
| audit d'éclairage | chaque lumière ancrée à un luminaire |
| rapport de collision | zéro pénétration, zéro hors-limite, parité des collisionneurs 100% |
| test de jeu | boucle réalisable, chemin d'échec accessible, redémarrage fonctionne |
| rapport mobile | mise en page 390×844, aucun débordement horizontal, commandes tactiles présentes |
| rapport d'encadrement sur 3 à 6 objets du sujet | chaque métrique >= 0,8 de la référence |
| score d'image | rapporté, 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.
| Artefact | Minimum |
|---|---|
| Écrans | menu, jeu, pause, paramètres, perdu, gagné |
| Écran titre | visible au chargement ; HUD caché ; titre, prémisse, début, paramètres/commandes |
| Paramètres | sensibilité, volume, FOV, inversion Y, qualité (ou un ensemble équivalent) |
| Persistance | une clé survit au rechargement (meilleur score/progression/paramètres) |
| Entrée | clavier + 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é) |
| HUD | objectif+progression, survie, arme/munitions, invite contextuelle, boussole/marqueurs, sous-titres |
| Audio | muet + ≥6 événements de changement d'état |
| Caméras | caméras héros + plan serré fixes dans __PRODUCT.cameras |
| Performance | budgets déclarés pour les appels/triangles/lumières, mesurés après le démarrage |
| Mobile | 390×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.
| Emplacement | Tranche verticale | Petit jeu fini |
|---|---|---|
| Objectifs | 1 chaîne, 3 étapes | 1–3 chaînes, 5–8 étapes |
| Rôles d'ennemis/éléments interactifs | 2 | 3–5 + un climax |
| Armes/outils | 2 (principal + secondaire) | 3–5 |
| Verbes joueur | se déplacer, viser, tirer, recharger | + s'accroupir/sauter/interagir/capacité |
| Monde | un lieu, 3 couches de profondeur | 2–3 espaces connectés |
| Coque | titre, pause, paramètres, fin | + sauvegarde, qualité, tactile |
| Session | 3–8 min | 10–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.
- 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.
- Matériaux — variation de rugosité, de normales et de saleté, plutôt que la couleur seule.
- Composition et densité — objets à plusieurs échelles et profondeurs, avec un point focal clair et des indices d'échelle lisibles.
- Formation de l'image — anti-aliasing, mappage de tons, bloom, grain, vignette.
- 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écision | Contenu |
|---|---|
| Sujet | ce sur quoi porte l'image, à quelle échelle |
| Heure et météo | détermine le brouillard, la force de réflexion, le contraste |
| Lumière clé | direction, élévation, température de couleur, intensité |
| Ciel et ambiance | couleur du remplissage d'ombre |
| Famille de matériaux | quelles surfaces existent, à quel point elles sont rugueuses, à quel point elles sont mouillées |
| Point focal | où l'œil doit se poser en premier |
| Contraintes | ce 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énario | Clé | Remplissage / IBL | Air | Matériau signature |
|---|---|---|---|---|
| Nuit industrielle | clé froide basse-moyenne, sources pratiques | env de ciel, flaques chaudes | exponentiel, couleur du ciel | sol mouillé, luminaires émissifs |
| Lumière du jour nuageuse | clé de ciel large, 35–60° | IBL fort | perspective aérienne fine | béton mat, flaques |
| Heure dorée / contre-jour | clé chaude basse derrière le sujet | remplissage de ciel froid | brume longue, bord | asphalte mouillé, verre, métal |
| Midi clair | clé haute, ombres dures | remplissage ciel + rebond | minimal | sable, pierre, peinture |
| Intérieur avec sources pratiques | fenêtre + quelques sources chaudes | env de fenêtre/ciel | rayons de lumière, poussière | bois, tissu, métal |
| Souterrain / lumière artificielle | sources pratiques + émissives | ambiance faible | volumétrique | bé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]