Communitygithub.com

game-trailer

Créez une bande-annonce de jeu de 20 à 60 secondes à partir de gameplay réel — scriptez les plans, capturez-les depuis l'éditeur Unity à une fréquence d'images verrouillée (sans scintillement ni bégaiement), puis assemblez le tout avec ffmpeg : étalonnage, sous-titres dans la police du jeu, carton titre et mixage sonore à partir des voix, ambiances et jingles du jeu.

Qu'est-ce que game-trailer ?

Cette compétence permet de produire une bande-annonce de jeu vidéo professionnelle directement depuis des séquences de gameplay, en éliminant les artefacts visuels (scintillement, bégaiement) grâce au verrouillage de la fréquence d'images via un script Unity (TrailerRecorder.cs). L'utilisateur scripte d'abord un storyboard (tableau de plans, légendes, indices sonores), puis la capture s'effectue en mode éditeur avec Time.captureFramerate = 30, générant des images JPG parfaitement stables. L'assemblage final utilise un pipeline Python (make_trailer.py) et un fichier JSON de configuration pour l'étalonnage, les transitions, les sous-titres dans la police du jeu, le carton titre et le mixage audio. Le traitement audio est particulièrement soigné : il repère et renforce les voix (ducking automatique, présence vers 2,8 kHz) pour qu'elles soient audibles même sur des enceintes de laptop ou de téléphone, et exporte un mix maîtrisé entre -14 et -16 LUFS. La compétence prend en charge les variantes de sortie (MP4 16:9, GIF pour README, crop 9:16 pour shorts) et propose une option de correction audio sans ré-encodage vidéo complet. Elle est conçue pour Unity (C#), Python et ffmpeg, et s'active à la demande pour tout besoin de vidéo promotionnelle (boutiques, YouTube, réseaux sociaux, README).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Maimuzamilhu/claude-code-gamedev-pipeline/tree/HEAD/skills/game-trailer

Demander à votre IA préférée

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

Documentation

Bande-annonce de jeu à partir de gameplay réel

Une bande-annonce qui fonctionne : l'accroche ou la menace dans les 3 premières secondes, 4 à 6 plans courts, une légende par plan, un carton titre, un son qui frappe sur les coupes. 20-30 secondes suffisent.

1. Scénarisez-la (references/shot-list.md)

Écrivez un tableau avant l'enregistrement : numéro du plan, durée (2,5–5 s), ce que fait la caméra, ce qui bouge, la légende (2–5 mots, en majuscules) et l'indice sonore. Ordre : l'accroche, le verbe central, la pression, une escalade, puis le titre.

2. Capturez avec une horloge verrouillée

Enregistrer l'écran en temps réel fait scintiller et bégayer les lumières, particules et animations car la fréquence d'images de l'éditeur oscille. Verrouillez plutôt l'horloge du jeu : scripts/TrailerRecorder.cs définit Time.captureFramerate = 30, de sorte que chaque image avance le jeu exactement de 1/30 s quel que soit le temps de rendu, et écrit chaque image en JPG 1920×1080.

// Depuis l'éditeur (mode play), par plan :
TrailerRecorder.Record("Recordings/shot01", 4.2f, t => {
    // t va de 0 à 1 sur le plan : déplacez la caméra, le joueur, les ennemis ici
    cam.position = Vector3.Lerp(start, end, Mathf.SmoothStep(0, 1, t));
    cam.LookAt(target);
});

Conseils utiles :

  • Désactivez le script de la caméra de gameplay pour les gros plans et pilotez Camera.main vous-même ; une caméra orbitale vous contrecarre.
  • Geler l'IA que vous ne voulez pas voir bouger ; scripter celle que vous voulez (SetDestination, définir la rotation).
  • Utilisez le niveau de qualité le plus élevé pour la capture ; vous n'êtes pas limité par le temps réel.
  • 6 images d'échauffement avant l'image 0 pour que les poses se stabilisent (le recorder le fait).

3. Assemblez (scripts/make_trailer.py + trailer.json)

python scripts/make_trailer.py trailer.json

trailer.json liste les dossiers de plans et les légendes, le titre, les polices, et les indices audio (fichier, temps de début en secondes, volume, boucle). Le script étalonne chaque plan (contraste, saturation, vignette), fond les plans entre eux, dessine les légendes, construit le carton titre, mixe le son et écrit un MP4 (H.264 + AAC, lisible partout). Voir references/trailer.example.json.

4. Le son, c'est la moitié de la bande-annonce

Les voix doivent être entendues. L'erreur la plus courante dans les bandes-annonces : les lignes de voix sont noyées sous l'ambiance et disparaissent sur les haut-parleurs des téléphones et des ordinateurs portables (les voix filtrées comme radio ou robot perdent leurs graves et disparaissent en premier). Marquez chaque réplique parlée avec "voice": true dans trailer.json : le script égalise le volume de chaque ligne, ajoute de la présence autour de 2,8 kHz, et baisse tout le reste d'environ 10 dB pendant qu'une personne parle (compression sidechain), puis maîtrise le mix à environ -14 à -16 LUFS. Pour corriger le son d'une vidéo terminée sans la re-rendre, définissez "video" et "shot_seconds" et exécutez make_trailer.py trailer.json --audio-only. Vérifiez le résultat avec un spectrogramme (ffmpeg -i trailer.mp4 -lavfi showspectrumpic=s=1600x500 spec.png) : la parole apparaît sous forme de rayures lumineuses empilées entre 300 Hz et 3 kHz.

  • Fond : 1 à 2 boucles d'ambiance du jeu en permanence.
  • Accents : un jingle ou un impact sur la révélation et sur le titre.
  • Voix : 3 à 5 courtes répliques des personnages du jeu, dont au moins une humaine (voir ai-voice-lines).
  • Corps : battement de cœur ou respiration pour les jeux de tension, foule ou musique pour les autres.
  • Fondu entrant 0,8 s, fondu sortant 1,2 s, limiteur à -1 dB pour être fort sans écrêter.

5. Exportez les variantes

  • MP4 16:9 1920×1080 pour YouTube et les pages de boutique.
  • Un GIF de 5 secondes pour un README (ffmpeg ... fps=10,scale=640:-1 avec une palette).
  • Un crop 9:16 pour les shorts et reels si nécessaire.

Exemple (HOLD STILL) : 26,5 s, cinq plans (révélation de la tête du robot, un robot passant devant le joueur caché, marche parmi des robots éteints, une course qui fait se retourner un robot, un très gros plan « Je te vois »), légendes « LES MACHINES ONT GAGNÉ » / « ELLES CHASSENT TON ESPRIT » / « RESTE SILENCIEUX. RESTE CACHÉ. » / « COURS… ET ELLES T'ENTENDENT », puis le titre. Cinq lignes de voix le portent : la cassette du scientifique (« Ne cours pas quand elles arrivent. Reste immobile. »), la sono de l'usine, un enfant qui compte jusqu'à cent, et le robot « Je te vois » et « Reste immobile ». Le premier mix avait les voix enterrées 25-30 dB sous l'ambiance ; les indices vocaux + le ducking ont résolu le problème. Regardez-le dans le README de ce dépôt.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills associés