Communitygithub.com

game-trailer

Erstelle einen 20-60-sekündigen Game-Trailer aus echtem Gameplay – erstelle das Drehbuch, nimm die Szenen im Unity-Editor mit festgelegter Bildrate auf (kein Flackern oder Ruckeln) und setze sie mit ffmpeg zusammen: Farbkorrektur, Untertitel in der Schriftart des Spiels, ein Titelbild und eine Tonmischung aus den eigenen Stimmen, der Umgebungsatmosphäre und den Soundeffekten des Spiels. Verwende dies immer, wenn der Benutzer einen Trailer, Teaser, Gameplay-Video, Werbeclip, „Nimm mein Spiel auf“, „Das Video flackert/ruckelt“ oder ein Video für eine Store-Seite, YouTube, soziale Medien oder eine README wünscht.

Was ist game-trailer?

Diese Fähigkeit (Skill) für KI-Agenten erstellt professionelle Game-Trailer direkt aus dem Unity-Editor. Sie vermeidet das typische Flackern und Ruckeln von Editor-Aufnahmen, indem sie die Spieluhr über `Time.captureFramerate` sperrt und jedes Einzelbild als verlustfreies JPG rendert. Der Workflow ist dreistufig: (1) ein Drehbuch mit Schuss-Tabelle in `references/shot-list.md`, (2) die Aufnahme jeder Einstellung mit dem C#-Skript `TrailerRecorder.cs`, das Kamerafahrten, Animationen und Posen-Frames steuert, und (3) die finale Montage und Nachbearbeitung über ein Python-Skript (`make_trailer.py`), das aus einer JSON-Konfiguration Farbkorrektur, Überblendungen, Untertitel, Titelcard und eine vollständige Tonmischung erzeugt. Ein besonderer Fokus liegt auf der Tonqualität: Das Skript duckt (Sidechain-Kompression) alle anderen Audiospuren um etwa 10 dB, wenn Sprachaufnahmen abgespielt werden, hebt die Präsenz um 2,8 kHz an und mastered auf etwa -14 bis -16 LUFS – ein häufiger Fehler bei Trailern wird damit verhindert. Der Skill unterstützt die Ausgabe in verschiedenen Formaten: 16:9-Full-HD-MP4 für YouTube und Stores, ein GIF für READMEs und ein 9:16-Crop für Kurzvideos. Entwickler können das Skript auch nutzen, um nachträglich nur die Audiospur eines fertigen Videos zu korrigieren, ohne den gesamten Trailer neu rendern zu müssen. Die Fähigkeit ist speziell für Unity und Python-Entwicklungsumgebungen mit ffmpeg ausgelegt.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Game-Trailer aus echtem Gameplay

Ein Trailer, der funktioniert: Die Bedrohung oder der Haken in den ersten 3 Sekunden, 4-6 kurze Einstellungen, eine Bildunterschrift pro Einstellung, eine Titelcard und Sound, der auf die Schnitte trifft. 20-30 Sekunden sind genug.

1. Drehbuch (references/shot-list.md)

Schreibe vor der Aufnahme eine Tabelle: Einstellungsnummer, Länge (2,5-5 s), was die Kamera tut, was sich bewegt, die Bildunterschrift (2-5 Wörter, GROSSBUCHSTABEN) und das Sound-Cue. Reihenfolge: Haken, das Kernverb, der Druck, eine Eskalation, dann der Titel.

2. Aufnahme mit gesperrter Uhr

Die Aufnahme des Bildschirms in Echtzeit führt dazu, dass Lichter, Partikel und Animationen flackern und ruckeln, weil die Bildrate des Editors schwankt. Sperre stattdessen die Spieluhr: scripts/TrailerRecorder.cs setzt Time.captureFramerate = 30, sodass jeder Frame das Spiel exakt um 1/30 s vorrückt, egal wie lange das Rendern dauert, und schreibt jeden Frame als 1920x1080 JPG.

// Aus dem Editor (Play-Modus), pro Einstellung:
TrailerRecorder.Record("Recordings/shot01", 4.2f, t => {
    // t läuft 0..1 über die Einstellung: Kamera, Spieler, Gegner hier bewegen
    cam.position = Vector3.Lerp(start, end, Mathf.SmoothStep(0, 1, t));
    cam.LookAt(target);
});

Tricks, die wichtig sind:

  • Schalte das Gameplay-Kamera-Skript aus für Nahaufnahmen und steuere Camera.main selbst; eine Orbit-Kamera kämpft gegen dich.
  • Friere KI ein, die du nicht bewegen willst; skripte die, die du bewegst (SetDestination, Rotation setzen).
  • Verwende die höchste Qualitätsstufe für die Aufnahme; du bist nicht durch Echtzeit begrenzt.
  • 6 Aufwärm-Frames vor Frame 0, damit sich Posen setzen (der Recorder macht das).

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

python scripts/make_trailer.py trailer.json

trailer.json listet die Einstellungsordner und Bildunterschriften, den Titel, die Schriftarten und die Audio-Cues (Datei, Startzeit in Sekunden, Lautstärke, Schleife). Das Skript korrigiert jede Einstellung (Kontrast, Sättigung, Vignette), blendet zwischen Einstellungen über, zeichnet Bildunterschriften, erstellt die Titelcard, mischt den Ton und schreibt eine MP4 (H.264 + AAC, läuft überall). Siehe references/trailer.example.json.

4. Ton ist die Hälfte des Trailers

Stimmen müssen gehört werden. Der häufigste Trailer-Fehler: Sprachzeilen liegen unter der Umgebungsatmosphäre und verschwinden auf Handy- und Laptop-Lautsprechern (gefilterte Stimmen wie Radio oder Roboter verlieren ihren Bass und verschwinden zuerst). Markiere jedes gesprochene Cue mit "voice": true in trailer.json: Das Skript passt die Lautstärke jeder Zeile an, fügt Präsenz um 2,8 kHz hinzu und duckt alles andere um etwa 10 dB, während jemand spricht (Sidechain-Kompression), und mastered dann den Mix auf etwa -14 bis -16 LUFS. Um den Ton eines fertigen Videos zu korrigieren, ohne es neu zu rendern, setze "video" und "shot_seconds" und führe make_trailer.py trailer.json --audio-only aus. Überprüfe das Ergebnis mit einem Spektrogramm (ffmpeg -i trailer.mp4 -lavfi showspectrumpic=s=1600x500 spec.png): Sprache zeigt sich als helle gestapelte Streifen zwischen 300 Hz und 3 kHz.

  • Grundbett: 1-2 Umgebungsatmosphären-Schleifen aus dem Spiel unter allem.
  • Einschläge: ein Stinger oder Impact auf die Enthüllung und auf den Titel.
  • Stimme: 3-5 kurze Zeilen aus den Charakteren des Spiels, mindestens eine menschliche (siehe ai-voice-lines).
  • Körper: Herzschlag oder Atmen für Spannungsspiele, Menschenmenge oder Musik für andere.
  • Einblendung 0,8 s, Ausblendung 1,2 s, Limiter bei -1 dB, damit es laut ist, aber nicht verzerrt.

5. Exportvarianten

  • 16:9 1920x1080 MP4 für YouTube und Store-Seiten.
  • Ein 5-Sekunden-GIF für eine README (ffmpeg ... fps=10,scale=640:-1 mit einer Palette).
  • Ein 9:16-Crop für Shorts und Reels falls nötig.

Beispiel (HALT STILL): 26,5 s, fünf Einstellungen (Roboter-Kopf-Enthüllung, ein Roboter geht am versteckten Spieler vorbei, geht unter ausgeschalteten Robotern, ein Lauf, der einen Roboter umdrehen lässt, eine extreme Nahaufnahme „Ich sehe dich“), Bildunterschriften „DIE MASCHINEN HABEN GEWONNEN“ / „SIE JAGEN NACH DEINEM VERSTAND“ / „SEI STILL. BLEIB VERSTECKT.“ / „RENN ... UND SIE HÖREN DICH“, dann der Titel. Fünf Sprachzeilen tragen es: das Tonband des Wissenschaftlers („Renn nicht, wenn sie kommen. Halt still.“), die Fabrikdurchsage, ein Kind, das bis hundert zählt, und die Sätze des Roboters „Ich sehe dich“ und „Halt still“. Die erste Mischung hatte die Stimmen 25-30 dB unter der Umgebungsatmosphäre vergraben; Sprach-Cues + Ducking haben es behoben. Sieh es dir in der README dieses Repos an.

Individual skills in this repo

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

Verwandte Skills