Communitygithub.com

game-trailer

Crie um trailer de jogo de 20 a 60 segundos a partir de gameplay real — roteirize as cenas, capture-as do editor Unity com taxa de quadros travada (sem piscadas ou travamentos) e monte com ffmpeg — color grading, legendas na fonte do jogo, cartão de título e mixagem de som baseada nas vozes, ambiência e jingles do próprio jogo.

O que é game-trailer?

Esta skill permite criar trailers de jogos profissionais diretamente do gameplay real, ideal para desenvolvedores que precisam de vídeos promocionais para lojas (Steam, Itch.io), YouTube, redes sociais ou READMEs. Ela suporta a plataforma Unity + ferramentas de linha de comando (ffmpeg, Python) e é acionada sempre que o usuário pedir um trailer, teaser, clipe de gameplay, gravação de jogo, ou relatar problemas como "o vídeo pisca/trava". O fluxo de trabalho é dividido em cinco etapas: (1) Roteirização — uma tabela com sequência de cenas curtas (2,5–5 s cada), câmera, ação e legenda; (2) Captura com clock travado — um script C# (`TrailerRecorder.cs`) define `Time.captureFramerate = 30` para eliminar piscadas e travamentos, gravando cada frame como JPEG 1920x1080; (3) Montagem — um script Python (`make_trailer.py`) lê um JSON de configuração e aplica color grading, fades, legendas, cartão de título e mixagem de áudio; (4) Som — destaca vozes com ducking automático e equalização para evitar que se percam em alto-falantes de celular ou notebook; (5) Exportação de variantes — MP4 16:9, GIF para README e corte 9:16 para Shorts/Reels. A skill resolve problemas comuns como áudio enterrado sob ambiência e vídeo com oscilações de quadros.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Trailer de jogo a partir de gameplay real

Um trailer que funciona: a ameaça ou o gancho nos primeiros 3 segundos, 4 a 6 cenas curtas, uma legenda por cena, um cartão de título, som que bate nos cortes. 20 a 30 segundos é o suficiente.

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

Escreva uma tabela antes de gravar: número da cena, duração (2,5–5 s), o que a câmera faz, o que se move, a legenda (2 a 5 palavras, em caixa alta) e a dica de som. Ordem: gancho, o verbo central, a pressão, uma escalada, depois o título.

2. Capture com clock travado

Gravar a tela em tempo real faz com que luzes, partículas e animação pisquem e travem porque a taxa de quadros do editor oscila. Trave o clock do jogo: scripts/TrailerRecorder.cs define Time.captureFramerate = 30, então cada frame avança o jogo exatamente 1/30 s, independentemente de quanto tempo leva para renderizar, e escreve cada frame como um JPG 1920x1080.

// Do editor (modo play), por cena:
TrailerRecorder.Record("Recordings/shot01", 4.2f, t => {
    // t vai de 0 a 1 ao longo da cena: mova a câmera, o jogador, os inimigos aqui
    cam.position = Vector3.Lerp(inicio, fim, Mathf.SmoothStep(0, 1, t));
    cam.LookAt(alvo);
});

Dicas importantes:

  • Desligue o script de câmera do gameplay para closes e controle a Camera.main você mesmo; uma câmera orbital atrapalha.
  • Congele a IA que você não quer que se mova; programe a que você quer (SetDestination, defina rotação).
  • Use o nível de qualidade mais alto para captura; você não está limitado pelo tempo real.
  • 6 quadros de aquecimento antes do quadro 0 para que as poses se estabilizem (o gravador faz isso).

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

python scripts/make_trailer.py trailer.json

trailer.json lista as pastas das cenas e legendas, o título, as fontes e as dicas de áudio (arquivo, tempo inicial em segundos, volume, loop). O script gradua cada cena (contraste, saturação, vinheta), faz transições entre cenas, desenha legendas, constrói o cartão de título, mixa o som e escreve um MP4 (H.264 + AAC, toca em qualquer lugar). Veja references/trailer.example.json.

4. Som é metade do trailer

As vozes devem ser ouvidas. O erro mais comum em trailers: falas ficam soterradas sob a ambiência e desaparecem em alto-falantes de celular e notebook (vozes filtradas como rádio ou robô perdem os graves e somem primeiro). Marque cada dica de fala com "voice": true no trailer.json: o script ajusta o volume de cada linha, adiciona presença em torno de 2,8 kHz e abaixa tudo mais em cerca de 10 dB enquanto alguém fala (compressão sidechain), depois masteriza a mixagem para cerca de -14 a -16 LUFS. Para corrigir o som de um vídeo já finalizado sem re-renderizá-lo, defina "video" e "shot_seconds" e execute make_trailer.py trailer.json --audio-only. Verifique o resultado com um espectrograma (ffmpeg -i trailer.mp4 -lavfi showspectrumpic=s=1600x500 spec.png): a fala aparece como faixas empilhadas e brilhantes entre 300 Hz e 3 kHz.

  • Base: 1 a 2 loops de ambiência do jogo por baixo de tudo.
  • Impactos: um jingle ou impacto na revelação e no título.
  • Voz: 3 a 5 falas curtas dos personagens do jogo, pelo menos uma humana (veja ai-voice-lines).
  • Corpo: batimento cardíaco ou respiração para jogos de suspense, multidão ou música para outros.
  • Fade in de 0,8 s, fade out de 1,2 s, limitador a -1 dB para que fique alto, mas sem clipar.

5. Exporte variantes

  • MP4 16:9 1920x1080 para YouTube e páginas de loja.
  • GIF de 5 segundos para um README (ffmpeg ... fps=10,scale=640:-1 com paleta).
  • Corte 9:16 para Shorts e Reels, se necessário.

Exemplo (HOLD STILL): 26,5 s, cinco cenas (revelação da cabeça do robô, um robô passando pelo jogador escondido, caminhando entre robôs desligados, uma corrida que faz um robô se virar, um close extremo "Estou vendo você"), legendas "AS MÁQUINAS VENCERAM" / "ELAS CAÇAM SUA MENTE" / "FIQUE EM SILÊNCIO. FIQUE OCULTO." / "CORRA... E ELAS OUVIRÃO", depois o título. Cinco falas conduzem: a fita do cientista ("Não corra quando elas vierem. Fique parado."), o auto-falante da fábrica, uma criança contando até cem, e o robô dizendo "Estou vendo você" e "Fique parado". A primeira mixagem tinha as vozes enterradas 25 a 30 dB abaixo da ambiência; dicas de voz + ducking resolveram. Assista ao vídeo no README deste repositório.

Individual skills in this repo

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

Habilidades Relacionadas