Generate2dmap
Environnement App-builder / Grok
| Élément | Valeur |
|---|---|
| Répertoire / scripts de la compétence | .grok/skills/generate2dmap/, exécuté avec python3 .grok/skills/generate2dmap/scripts/<script>.py … |
| Outils d'image | imagine_text_to_image / imagine_image_to_image (basés sur le chemin ; voir imagine) ; inspecter le résultat avec read_file sur le chemin PNG (pas Codex view_image) |
| Chemin des images générées | imagine_text_to_image → file_path du sandbox → copier dans assets/map/ ; Pillow est préinstallé |
engine_target par défaut | raw_canvas ou Phaser pour ce sandbox navigateur TanStack — n'utiliser Godot/Unity/Tiled que lorsque l'utilisateur demande explicitement ces exports |
| Compétences liées | generate2dsprite (sprites de personnages/effets ; les packs de props utilisent toujours le script d'extraction de cette compétence), building-games, imagine |
Décider d'abord du pipeline
Construire le plus petit ensemble de cartes jouable qui satisfait au jeu : choisir un map_mode de niveau produit, puis les axes de plus bas niveau (visual_model, runtime_object_model, collision_model, engine_target).
tile_mode— cartes de tuiles / grilles modifiables : routes à la Pokémon, villages RPG vue du dessus, tilemaps de plateformer, ou tout projet utilisant déjà des tilemaps Tiled/LDtk/Godot/Unity/Phaser.scene_mode— base de fondation plus props séparés : tower defense, arènes de type survivors, cartes de présentation cosy vue du dessus.side_scroll_mode— stages side-scroller à parallaxe : style Mega Man, plateformers d'action, salles Metroidvania, runners, brawlers.grid_mode— grilles à règles complexes : RPG tactiques, factory/automation, jeux de plateau/cartes, grilles de construction.room_chunk_mode— salles / modules modulaires : donjons roguelike, réseaux Metroidvania, assemblage procédural.baked_scene_mode— scènes explicitement plates et non jouables uniquement : écrans titre/menu, arrière-plans de combat, scènes de visual novel, concept art.
Utiliser les paramètres spécifiés par l'utilisateur quand ils sont présents ; sinon, déduire le pipeline jouable le plus léger à partir du jeu existant, de la caméra, des besoins de collision, de l'échelle de la carte et des besoins d'édition. En cas de désaccord entre le mode et les axes, c'est le contrat jouable/modifiable du mode qui prévaut. Le routage par genre, les valeurs par défaut des axes par mode, les préréglages et l'heuristique d'escalade se trouvent dans references/map-strategies.md — le lire chaque fois que le choix n'est pas évident.
Une carte jouable n'est jamais une seule image cuite. Pour toute demande impliquant une carte, niveau, stage, salle, prototype ou scène moteur jouable, le livrable doit exposer la géométrie du gameplay et les objets sous forme de calques séparés, props, données de tuiles/objets, collisions, zones ou nœuds de scène natifs du moteur. Une image cuite peut être un arrière-plan, une référence ou un artefact d'aperçu — jamais la carte d'exécution — sauf si l'utilisateur a explicitement demandé un simple arrière-plan plat.
Scènes et cartes uniquement. Ne pas générer ici de sprites de personnages, ennemis, boss, PNJ, joueur, projectiles ou animations ; ceux-ci relèvent de $generate2dsprite. Les cartes portent des crochets de scène (marqueurs d'apparition, zones de patrouille/rencontre, entrées d'arène, portes, sorties, déclencheurs de caméra) en tant que métadonnées, pas en tant qu'art dessiné.
L'art provient de la génération d'image, et vous écrivez les prompts
imagine_text_to_imageest la source d'art par défaut pour les cartes de base, les plaques de parallaxe, les références, les feuilles de props et l'art des tilesets. Leart_stylepar défaut estclean_hd(peint à la main HD, formes nettes et lisibles, faible bruit de texture, pas de pixels grossiers) ; n'utiliserpixel_inspiredouretro_pixelque sur demande.- Écrire vous-même chaque prompt créatif. Les scripts peuvent assembler, découper, incruster (chroma-key), recadrer, valider, composer des aperçus et émettre du JSON ou des fichiers moteur — ne jamais écrire de prompts créatifs ni dessiner l'art final. L'art procédural/de substitution uniquement lorsque l'utilisateur demande explicitement des espaces réservés, des fixtures, des cartes de débogage ou des échafaudages. Avec une cible de moteur à tuiles, générer d'abord l'art du tileset, puis script seulement les calques, les collisions, les zones et le câblage de la scène.
- Enregistrer chaque prompt à côté de son asset sous la forme
<asset>.prompt.txt(ou un champ explicite dans le manifeste) chaque fois que l'exécution crée de nouveaux assets visuels. - Un transfert de référence est un chemin de fichier, pas une phrase. Pour construire à partir d'une image antérieure, passer son
file_pathdu sandbox àimagine_image_to_image(et faireread_filedessus pour la voir), puis nommer les caractéristiques concrètes à préserver : cadrage de la caméra, horizon, formes des routes/eaux, limites du terrain, entrées/sorties, points de repère. Un nom de fichier, « basé sur la carte », ou le simple fait que l'image soit visible dans la conversation n'est pas un transfert — arrêtez-vous et passez le chemin.
Garder les objets runtime hors du calque de base
La première image de base/fond/fondation générée ne peut contenir que de l'art de fondation stable et non interactif — matériau du sol, chemins, routes, eau, falaises, motifs de sol, marquages de voie et pads de construction ; pour les vues de côté : ciel, décors lointains/moyens, silhouettes, atmosphère ; pour les tilemaps : l'art du tileset en tant que calques modifiables. Elle ne doit pas contenir de grands props, bâtiments, arbres, rochers, caisses, panneaux, portes, portails, objets à ramasser, coffres, points de contrôle, dangers, pièges, tourelles, échelles, occultants de premier plan, destructibles, acteurs, ennemis, PNJ, UI, étiquettes, ni rien nécessitant collision, interaction, réutilisation, tri Y, animation ou son propre ordre de rendu — régénérer une base de fondation uniquement, ou rétrograder une telle image en artefact de référence.
Les maquettes de référence sont des points de contrôle, pas des livrables
Les références habillées (vue du dessus) et les références de stage (vue de côté) planifient le placement dans le monde : objets naturels du monde du jeu ou géométrie subtile de blocage, au maximum 9 candidats objets visibles distincts (les répétitions comptent une fois, puis réapparaissent dans les métadonnées de placement), aucun graphisme d'annotation (cercles, flèches, contours, étiquettes, texte, légendes, lignes de mesure), et aucune métadonnée non visuelle — les points d'apparition, déclencheurs, indices de patrouille, limites de caméra sont écrits plus tard comme crochets de scène.
Après en avoir généré une, ne pas s'arrêter là. Continuer avec references/object-production-gate.md : refaire read_file sur les deux images, construire la liste d'objets, générer les objets séparés finaux, écrire les métadonnées de placement / collision / crochet de scène, composer l'aperçu QA. Une sortie de référence uniquement est une exécution incomplète, sauf si l'utilisateur a explicitement demandé une image conceptuelle.
Profondeur pour le pipeline choisi — ouvrir ceux-ci avant de produire les assets
- Cartes raster calques →
references/layered-map-contract.md(types de calques, motifs de prompt pour la base et les props, métadonnées des props, ordre de rendu, collision, checklist QA). side_scroll_mode→references/side-scroll-stages.md: la décisionstage_canvas, les calques de parallaxe nommés uniquement décoratifs, et la référence de stage dans le monde obligatoire avant tout travail de plateforme/objet.- Toute génération de props ou d'objets de scène → classer d'abord chaque objet, puis suivre
references/prop-pack-contract.md: seuls les props compacts peuvent partager un pack de props carré ; les plateformes, sols, ponts, portes, bâtiments et tout élément aligné pour la collision vont un par un, en bande de plateforme, en pack large personnalisé ou en calques de tuiles/objets. - Paramètres, workflow étape par étape, et commandes
extract_prop_pack.py/compose_layered_preview.py→references/pipeline.md. - Listes de livrables par pipeline et checklist de validation →
references/deliverables.md; les exécuter les deux avant de déclarer une carte terminée.