Communitygithub.com

game-trailer

Crea un tráiler de juego de 20-60 segundos a partir de gameplay real: guioniza las tomas, captúralas desde el editor de Unity con una frecuencia de cuadros bloqueada (sin parpadeos ni tartamudeos) y móntalas con ffmpeg, incluyendo corrección de color, subtítulos en la tipografía del juego, una portada y una mezcla de sonido basada en las voces, ambientes y golpes del propio juego.

¿Qué es game-trailer?

Esta habilidad permite a los usuarios generar tráileres, avances o vídeos promocionales de juegos directamente desde el editor de Unity, asegurando una captura de video sin parpadeos ni tartamudeos al bloquear la frecuencia de fotogramas del juego. El flujo de trabajo comienza con la creación de un guion detallado en `references/shot-list.md`, donde se especifican tomas cortas (2.5–5 segundos), descripciones de cámara, movimientos, subtítulos y pistas de sonido. Luego, el script `scripts/TrailerRecorder.cs` captura cada fotograma como imágenes JPG a 1920×1080, utilizando `Time.captureFramerate = 30` para garantizar una animación estable. Posteriormente, `scripts/make_trailer.py` y el archivo de configuración `trailer.json` ensamblan el video: aplican gradación de color, fundidos, subtítulos, portada y mezcla de audio. El sonido es un componente crítico: la habilidad incluye compresión sidechain para que las voces sean audibles incluso en altavoces de teléfono, ajustando el volumen de ambientes y efectos para evitar que las voces se pierdan. Soporta la generación de variantes para YouTube, redes sociales y GIFs animados para README. Es ideal para desarrolladores que quieran promocionar sus juegos sin experiencia previa en edición de video profesional.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Tráiler de juego a partir de gameplay real

Un tráiler que funciona: la amenaza o el gancho en los primeros 3 segundos, 4-6 tomas cortas, un subtítulo por toma, una portada, y un sonido que impacta en los cortes. 20-30 segundos son suficientes.

1. Guionízalo (references/shot-list.md)

Escribe una tabla antes de grabar: número de toma, duración (2.5-5 s), qué hace la cámara, qué se mueve, el subtítulo (2-5 palabras, en mayúsculas) y la pista de sonido. Orden: gancho, el verbo central, la presión, una escalada, y luego la portada.

2. Captura con un reloj bloqueado

Grabar la pantalla en tiempo real hace que las luces, partículas y animaciones parpadeen y tartamudeen porque la frecuencia de fotogramas del editor varía. En su lugar, bloquea el reloj del juego: scripts/TrailerRecorder.cs establece Time.captureFramerate = 30, por lo que cada fotograma avanza el juego exactamente 1/30 s sin importar cuánto tarde en renderizarse, y escribe cada fotograma como un JPG de 1920x1080.

// Desde el editor (modo de reproducción), por toma:
TrailerRecorder.Record("Recordings/shot01", 4.2f, t => {
    // t va de 0 a 1 a lo largo de la toma: mueve la cámara, el jugador, los enemigos aquí
    cam.position = Vector3.Lerp(inicio, fin, Mathf.SmoothStep(0, 1, t));
    cam.LookAt(objetivo);
});

Consejos que importan:

  • Apaga el script de la cámara de juego para primeros planos y controla Camera.main tú mismo; una cámara orbital te dificulta el trabajo.
  • Congela la IA que no quieras que se mueva; programa la que sí quieres (SetDestination, establece rotación).
  • Usa el nivel de calidad más alto para la captura; no estás limitado por el tiempo real.
  • 6 fotogramas de calentamiento antes del fotograma 0 para que las poses se asienten (el grabador lo hace).

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

python scripts/make_trailer.py trailer.json

trailer.json lista las carpetas de tomas y subtítulos, la portada, las tipografías y las pistas de audio (archivo, tiempo de inicio en segundos, volumen, bucle). El script gradúa cada toma (contraste, saturación, viñeta), funde entre tomas, dibuja subtítulos, construye la portada, mezcla el sonido y escribe un único MP4 (H.264 + AAC, se reproduce en todas partes). Consulta references/trailer.example.json.

4. El sonido es la mitad del tráiler

Las voces deben oírse. El error más común en los tráileres: las líneas de voz quedan bajo el ambiente y desaparecen en los altavoces de teléfonos y portátiles (las voces filtradas como de radio o robot pierden sus graves y desaparecen primero). Marca cada pista hablada con "voice": true en trailer.json: el script iguala el volumen de cada línea, añade presencia alrededor de 2.8 kHz, y atenúa todo lo demás unos 10 dB mientras alguien habla (compresión sidechain), y luego masteriza la mezcla a aproximadamente -14 a -16 LUFS. Para arreglar el sonido de un video terminado sin volver a renderizarlo, establece "video" y "shot_seconds" y ejecuta make_trailer.py trailer.json --audio-only. Verifica el resultado con un espectrograma (ffmpeg -i trailer.mp4 -lavfi showspectrumpic=s=1600x500 spec.png): el habla se muestra como rayas brillantes apiladas entre 300 Hz y 3 kHz.

  • Base: 1-2 bucles de ambiente del juego debajo de todo.
  • Golpes: un impacto o golpe en la revelación y en la portada.
  • Voz: 3-5 líneas cortas de los personajes del juego, al menos una humana (consulta ai-voice-lines).
  • Cuerpo: latidos o respiración para juegos de tensión, multitud o música para otros.
  • Fundido de entrada de 0.8 s, fundido de salida de 1.2 s, limitador a -1 dB para que sea fuerte pero sin recortar.

5. Exporta variantes

  • 16:9 1920x1080 MP4 para YouTube y páginas de tienda.
  • Un GIF de 5 segundos para un README (ffmpeg ... fps=10,scale=640:-1 con una paleta).
  • Un recorte 9:16 para shorts y reels si es necesario.

Ejemplo (QUÉDATE QUIETO): 26.5 s, cinco tomas (revelación de cabeza de robot, un robot caminando junto al jugador escondido, caminando entre robots apagados, una carrera que hace que un robot se gire, un primer plano extremo "Te veo"), subtítulos "LAS MÁQUINAS GANARON" / "CAZAN TU MENTE" / "SILENCIO. OCÚLTATE." / "CORRE... Y TE OIRÁN", luego la portada. Cinco líneas de voz lo llevan: la cinta del científico ("No corras cuando vengan. Quédate quieto."), el altavoz de la fábrica, un niño contando hasta cien, y el robot "Te veo" y "Quédate quieto". La primera mezcla tenía las voces enterradas 25-30 dB bajo el ambiente; las señales de voz + atenuación lo solucionaron. Míralo en el README de este repositorio.

Individual skills in this repo

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

Skills relacionados