Communitygithub.com

Playgama/gamedev-skills

Créez une promo, une bande-annonce, un devlog ou une vidéo « comment j’ai fait » pour un jeu web, dans le style du jeu lui-même, avec le logo Playgama AI en introduction. Utilisez cette compétence dès qu’un développeur souhaite une vidéo pour YouTube, Shorts, TikTok, Reels, une page d’accueil ou une fiche Playgama.

Qu'est-ce que gamedev-skills ?

Cet ensemble d’outils et de scripts, Playgama/gamedev-skills, permet de produire des vidéos professionnelles pour les jeux web publiés via Playgama. Il filme le gameplay image par image, extrait la palette de couleurs du jeu, génère des voix off via plusieurs services, et assemble le tout dans un modèle HyperFrames respectant l’identité visuelle du jeu (couleurs, polices, panneaux, sons). Le résultat inclut le logo Playgama AI en introduction et un bug en incrustation, mais tout le reste – du contenu à la narration – est tiré du jeu réel et des prompts de l’agent IA qui l’a créé. Cette compétence évite les images génériques et les voix non vérifiées, en suivant un processus par étapes avec deux points d’approbation clés (scénario et visuels avant enregistrement). Elle prend en charge plusieurs formats (Shorts, trailers, « how I made it », tutoriels) et fonctionne sur macOS, Linux et Windows.

Compatible avec~Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Playgama/gamedev-skills/tree/HEAD/skills/playgama-game-video

Demander à votre IA préférée

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

Documentation

Créer une vidéo pour un jeu

Voici comment nous réalisons des vidéos pour les jeux Playgama. La vidéo ressemble au jeu, pas à Playgama : ses couleurs, polices, panneaux et sons. Playgama ajoute son logo (un sting de 3 secondes au début et un petit bug dans le coin) et le lien. Le reste du travail se fait à trois endroits : l’histoire est vraie et spécifique, le gameplay est filmé proprement, et la première seconde gagne la suivante.

Les fichiers fournis :

FichierDescription
assets/playgama-ai-logo.svg, .pngLe logo officiel Playgama AI (591×133) : une pilule violette avec le wordmark Playgama, et une boîte grise collée avec « AI » découpé. Le PNG est 4x, transparent.
assets/template/Un modèle vidéo HyperFrames de démarrage, 1920x1080 : le sting, trois emplacements de gameplay, un titre, une carte de fin, des pistes musique et voix. Un bloc theme en haut contient l’apparence du jeu.
assets/sting-preview.mp4L’animation d’intro comme elle doit apparaître, avec un espace réservé où la vidéo du jeu commence.
assets/sting.htmlL’animation d’intro seule, en CSS pur (7 Ko, aucune bibliothèque) : à déposer dans n’importe quelle page ou outil vidéo.
assets/playgama-ai-sting.htmlLa même animation en page de révision avec contrôles de lecture, vitesse et défilement, et la timeline et les couleurs détaillées. Ouvrez-la dans un navigateur et glissez une capture d’écran du jeu pour voir le logo superposé au jeu, ou donnez-la à un designer.
scripts/film.mjs, scripts/vclock.jsFilmez n’importe quel jeu web image par image en un MP4 fluide à n’importe quelle taille.
scripts/doctor.mjs, scripts/new-video.mjsVérifiez la machine et dites quoi installer ; créez le dossier de la vidéo (modèle, GSAP, Puppeteer).
scripts/palette.mjsLes couleurs utilisées par un jeu, échantillonnées à partir de ses captures d’écran, pour quand son code n’a pas de thème.
scripts/voice.mjsLa voix off : prend en charge ElevenLabs, OpenAI, Gemini ou Cartesia (ou une voix provisoire gratuite). Une page pour choisir à l’oreille, et la piste vocale avec la musique en dessous.
references/story-and-script.mdFormats, fiches de rythme avec exemples de lignes réelles, règles pour le contenu à l’écran.
references/game-look.mdPrendre l’apparence du jeu : où la trouver, couleurs, typographie, panneaux, mouvement, son, le thème du modèle.
references/filming.mdComment filmer les prises : préparation, configuration et scripts par image, choix des moments, la première image.
references/voice-and-music.mdVoix off (synthèse vocale ou la vôtre), prononcer « Playgama », vérifier les prises, niveaux de musique.
references/edit-and-render.mdAssemblage dans HyperFrames : le modèle, les cartes, les coupes verticales, vérifications, rendu, révision.

Ce dont vous avez besoin

Cela fonctionne de la même manière sur macOS, Linux et Windows.

  1. node scripts/doctor.mjs vérifie la machine et indique ce qu’il faut installer.
  2. node scripts/new-video.mjs <dossier> crée le dossier de la vidéo : le modèle, gsap.min.js et Puppeteer pour le tournage. Exécutez toutes les commandes suivantes depuis ce dossier.
  • Pour filmer : Node 22+ (HyperFrames en a besoin), ffmpeg et ffprobe dans le PATH, et Puppeteer. film.mjs le trouve dans le dossier où il s’exécute, ou à côté du script. Le jeu doit être accessible via une URL : un serveur de développement ou un serveur statique sur le build.
  • Pour assembler et rendre : HyperFrames (npx [email protected] ; son premier lancement télécharge environ 370 Mo de paquets et un navigateur sans tête).
  • Pour la voix, si ce n’est pas la vôtre : une clé pour ElevenLabs, ou pour un autre service avec lequel scripts/voice.mjs fonctionne, définie une fois (references/voice-and-music.md), et Whisper ou un autre outil de reconnaissance vocale pour vérifier les prises.
  • Pour la musique : une piste instrumentale que vous avez le droit d’utiliser.

Le flux de travail

Travaillez dans cet ordre. Chaque étape alimente la suivante, et les deux points d’approbation font gagner des heures.

  1. Convenir de la vidéo. Définissez le format, la durée et l’objectif avant toute autre chose (tableau ci-dessous). Demandez à quoi sert la vidéo : joueurs, page de boutique, autres développeurs, ou le défi ou le catalogue Playgama.
  2. Recueillir l’histoire vraie. Rassemblez les vrais prompts, timestamps, commits, bugs, chiffres et captures d’écran (references/story-and-script.md). Si le jeu a été construit avec un agent IA, son historique de chat est la source la plus riche : lisez-le et notez les heures et les citations exactes.
  3. Prendre l’apparence du jeu (references/game-look.md) : ses couleurs, polices, panneaux, logo, musique et sons d’interface, d’abord à partir de ses propres fichiers. Inscrivez-les dans le bloc thème du modèle.
  4. Écrire le script, puis s’arrêter pour approbation. Écrivez les lignes vocales et ce qui est à l’écran, une ligne chacune. Le développeur approuve le texte et l’apparence avant qu’une voix ne soit créée : reformuler une voix enregistrée signifie l’enregistrer à nouveau.
  5. Filmer le gameplay et prendre les captures d’écran avec scripts/film.mjs à la taille de livraison (voir « Images du jeu » ci-dessous, et references/filming.md). Prévoyez une prise par temps fort du script, de quelques secondes chacune, mise en scène avec les propres contrôles du jeu ou des hooks de débogage.
  6. Réaliser les images fixes dans l’apparence du jeu. Utilisez du vrai code avec de vrais numéros de ligne, le vrai prompt et les étapes de l’agent, les pages web et les couvertures.
  7. Enregistrer la voix et choisir la musique (references/voice-and-music.md, scripts/voice.mjs). Une personne écoute les prises vocales, car la synthèse vocale échoue d’une manière qu’aucune transcription ne détecte.
  8. Assembler et rendre avec le modèle (references/edit-and-render.md). Lancez les vérifications, effectuez le rendu, extrayez une image toutes les quelques secondes et examinez chacune avant de déclarer le travail terminé.
  9. Préparer le package : une miniature (1280×720, la meilleure image du jeu, au maximum 4 gros mots dans sa propre police), un titre et une description avec le lien vers le jeu.

Choisir d’abord le format

VidéoFormatDuréeOuverture
Short / Reels / TikTok9:16, 1080×192015–35 sGameplay dès la première image ; le logo uniquement en petit bug dans le coin
Bande-annonce / promo16:9, 1920×108030–90 sLe sting (3 s), puis le meilleur gameplay
« Comment j’ai fait »16:93–6 minGameplay avec l’accroche, puis le sting ou un titre
Tutoriel (« publier avec Playgama MCP »)16:91–3 min par partieLe sting, puis le résultat d’abord et les étapes ensuite

Un Short se décide en une seconde, lorsque le spectateur reste ou balaie. Les Shorts qui s’ouvrent sur un gameplay plein écran lisibles d’un coup d’œil retiennent beaucoup plus de spectateurs que ceux qui s’ouvrent sur quelque chose à lire (une longue carte de commentaires, des menus de jeu, une boîte de chat). Un Short ne s’ouvre donc jamais sur le sting ou sur du texte.

L’apparence du jeu

La vidéo ressemble au jeu : quiconque y a joué devrait le reconnaître à n’importe quelle image. Prenez l’apparence du jeu lui-même, pas de Playgama (references/game-look.md) :

  • Couleurs issues de son interface et de son code : un fond, un panneau, un texte, un bouton et un surlignage. Quand le code n’a pas de thème, échantillonnez ses menus et son HUD avec scripts/palette.mjs.
  • Typographie : chaque police correspond à celle du jeu, y compris la police de code.
    • Les titres utilisent sa police de titre ou de logo, les étiquettes et les prompts sa police d’interface ou de texte.
    • Le code et les appels d’outils utilisent une police à chasse fixe dans l’esprit du jeu : une police pixel pour un jeu pixel art, une police machine à écrire pour un jeu sombre ou rétro.
    • La DM Mono du modèle ne fait que tenir la place.
  • Panneaux et boutons : cartes en forme de ses panneaux, bouton de la carte de fin comme son bouton principal, ses propres icônes et logo.
  • Mouvement et son : bougez comme son interface (rebondissant, calme ou par pas de pixel). Utilisez d’abord sa propre musique et ses sons d’interface.
  • Cartes sur images, pas sur diapositives noires. Placez un prompt ou une étape sur une image assombrie du jeu, et un titre bas sur le gameplay avec le fond assombri dans la couleur de fond du jeu. Préférez les vraies images côte à côte aux cartes avec seulement des noms dessus.

Les couleurs, polices et forme de panneau vont dans un bloc thème en haut du style du modèle.

Images du jeu

Le kit ne fournit aucune séquence de jeu. Chaque image du jeu est filmée à partir du propre jeu du développeur, par vous, avec scripts/film.mjs (references/filming.md). Cela couvre la vidéo, la miniature, l’image derrière une carte et les pages de révision.

  • Clips : une prise par temps fort, par exemple node scripts/film.mjs --url http://localhost:5173 --out clips/gameplay-1.mp4 --seconds 6.
  • Captures d’écran : la même commande avec --still <secondes> écrit un seul PNG de cet instant à la place. Prenez-en un chaque fois qu’une étape a besoin d’une image du jeu :
    • ses menus et HUD, pour en lire l’apparence (scripts/palette.mjs) ;
    • l’image derrière une carte de prompt ou un titre ;
    • la miniature et la carte de fin ;
    • le sting sur le jeu, pour vérifier que le bug dans le coin ne cache pas son HUD. Déposez la capture d’écran sur assets/playgama-ai-sting.html, ou placez le premier clip dans le modèle et exécutez npx [email protected] snapshot . --at 3.5 --describe false.
  • Coupes verticales sont filmées en 1080×1920, avec la caméra du jeu recadrée en conséquence.
  • Si le jeu ne peut pas être exécuté ici (build natif, mur de connexion, jeu en ligne uniquement), demandez au développeur des enregistrements d’écran et des captures d’écran à la taille de livraison, sans curseur ni notification à l’écran. Ne comblez jamais un vide avec des images d’un autre jeu, d’une page de boutique ou des exemples de ce kit.

Ce que Playgama ajoute

Son logo et le lien, rien d’autre. Le violet et la plaque sombre de Playgama appartiennent au logo et au sting, pas à la vidéo.

  • Le logo est assets/playgama-ai-logo.svg, le fichier officiel : une pilule violette #9747ff avec le wordmark blanc, et une boîte grise #d2d2d2 avec « AI » découpé dedans.
    • Utilisez-le tel quel : ne le recolorez pas, ne l’étirez pas, n’ajoutez pas d’effets, ne modifiez pas ses espacements et ne le redessinez pas.
    • Le « AI » est un trou, donc il montre ce qui se trouve derrière le logo.
    • Laissez un espace libre d’au moins la moitié de la hauteur de la pilule.
    • En tant que bug dans le coin, il fait environ 200 px de large sur une image 1920. Si le HUD du jeu se trouve dans ce coin, déplacez le bug dans un autre coin plutôt que de couvrir le HUD (references/edit-and-render.md).
  • Le lien vers Playgama mène à la propre page du jeu : sur la carte de fin et dans la description.

Le sting d’introduction

L’identifiant Playgama, comme le logo d’un éditeur avant une bande-annonce : environ 3 secondes, prêt à l’emploi dans assets/template/index.html. Il conserve ses propres couleurs et son timing dans chaque vidéo ; tout ce qui suit appartient au jeu. assets/sting-preview.mp4 montre le passage à un espace réservé. Pour le voir sur le jeu du développeur, prenez une capture d’écran ou un clip du jeu (voir « Images du jeu »).

  • Construction : sur fond onyx avec une lueur violette douce, la pilule violette grandit depuis son centre (0,05 s, sur 0,55 s). Le wordmark blanc playgama apparaît de gauche à droite (0,42 s). La boîte grise apparaît collée à la pilule (0,92 s), et « A » et « I » sont découpés (1,12 s, 1,27 s). Une bande de lumière traverse la pilule (1,55 s).
  • Transition : tout le logo vole vers le coin supérieur droit à 19 % de taille, à 39 px du haut et de la droite d’une image 1920×1080 (2,75 s, sur 0,62 s). Il y reste comme bug pendant que le gameplay apparaît en fondu en dessous (3,0 s).
  • Les parties sont tirées des propres formes du fichier officiel à 240 px de haut, de sorte que le sting se termine exactement sur le logo.
  • Changement : conservez son timing. Pour placer un cold open d’abord (une histoire), commencez le sting plus tard : définissez S dans le modèle (references/edit-and-render.md). Pour une coupe 9:16, supprimez la construction et placez le bug dans le coin dès la première image.

Règles issues des erreurs

  • Seul du matériel réel à l’écran.
    • Montrez de vrais prompts, de vrais chiffres, de vrais timestamps et du vrai code.
    • Si un chiffre doit être illustratif, indiquez-le à l’écran (« DONNÉES EXEMPLES ») pendant toute sa durée d’affichage.
    • N’inventez jamais une citation, un commentaire, un nombre de joueurs ou un avis. Les spectateurs qui vérifient un chiffre inventé cessent de faire confiance au reste.
  • Les prompts à l’écran sont les mots du développeur.
    • Traduisez-les dans la langue de la vidéo, mais ne les reformulez pas.
    • Coupez un long prompt avec « […] » plutôt que de le paraphraser.
    • Les étapes de l’agent sont les vrais appels d’outils dans leur ordre réel, par exemple create_application → start_archive_upload → get_archive_status (RÉUSSI) → publish_sandbox (un lien public).
  • Votre propre art uniquement. Ne montrez aucun personnage, logo ou art d’un autre jeu, même si votre jeu lui « ressemble » : nommez le genre à la place (« un jeu d’évasion horrifique »), pas un autre jeu.
  • **Playgama se dit « play-GAH-ma ». ** Les voix anglaises disent « play-GAY-ma » sauf si vous les orientez (references/voice-and-music.md).
  • Vérifiez chaque prise vocale par rapport à son texte (une transcription), et faites écouter par une personne. La synthèse vocale a répété une phrase, ajouté une phrase que personne n’a écrite, lu ses propres instructions à voix haute et avalé une dernière syllabe, le tout dans une prise qui semblait bonne seule.
  • La première image du jeu se lit en moins d’une seconde, pas un menu ou un écran de chargement.
    • Un Short s’ouvre dessus. Une bande-annonce ou une histoire l’atteint juste après le sting ou le cold open.
    • Filmez le meilleur moment, pas le début d’un niveau.
    • Texte dans les deux premières secondes du gameplay : au maximum quatre gros mots.
  • Les fichiers restent sur la machine. Le snapshot de HyperFrames envoie des images vers Gemini pour une description chaque fois qu’une clé Gemini ou Google est définie, et il lit un .env dans le dossier de la vidéo. Passez --describe false à chaque snapshot, et conservez les clés vocales dans le fichier de clés partagé de voice.mjs, pas dans le dossier de la vidéo.

Quand vous avez terminé

Le développeur reçoit :

  • le MP4 maître, et un aperçu plus petit s’il est volumineux ;
  • la miniature ;
  • un fichier texte avec le titre, la description (le lien du jeu, des chapitres pour les longues vidéos, #playgama) et un commentaire à épingler.

Dites-lui où se trouve chaque fichier et ce qui lui revient encore de décider : l’heure de publication, une prise vocale qu’il n’a pas entendue, et tout ce que vous n’avez pas pu vérifier.

Skills associés