NT25-Patcher-Tools

Este repositorio contiene un conjunto de herramientas para la traducción y modificación de recursos en Night Trap - 25th Anniversary Edition, centradas en la generación de subtítulos con estética retro VHS.

Instalación

Para que los scripts funcionen correctamente, deben estar ubicados en la carpeta raíz del juego (donde se encuentra el ejecutable y la carpeta NT25_Data).

Disclaimer

Este repositorio NO contiene archivos originales del juego, videos, música ni assets protegidos por copyright. Son únicamente scripts de automatización para uso personal y modding. El usuario debe poseer una copia legal del juego para utilizar estas herramientas.

---

Estructura del Proyecto

• Transcripciones/: Carpeta que contiene los archivos .srt corregidos para cada video.
• video_mapping.json & texture_mapping.json: Mapas que vinculan los archivos externos con sus PathIDs internos de Unity (se generan al extraer).
• venv/: Entorno virtual de Python con las dependencias necesarias (UnityPy, imageio-ffmpeg).

Preparación del Entorno

Antes de poder generar los subtítulos, es necesario extraer los recursos originales del juego:

1. Instalar dependencias: pip install -r requirements.txt (o usar el venv incluido).
2. Extraer Videos: Ejecutar extraer_videos_y_mapear.py.
   • Esto extraerá todos los videos originales de los archivos .assets de Unity y los colocará en ExtractedVideos/.
   • También generará el video_mapping.json necesario para el parcheo.
3. Extraer Texturas: Ejecutar extraer_texturas_y_mapear.py.
   • Extrae texturas originales a ExtractedTextures/ y genera texture_mapping.json.

Flujo de Trabajo Principal

1. Generación de Subtítulos (generar_subtitulos_vhs.py)

Este script toma los archivos .srt en Transcripciones/ y los "quema" en el video original usando FFmpeg.

• Estética VHS: Se aplica un filtrado multicapa con sombras de colores (Rojo/Azul) para simular la aberración cromática típica de las cintas VHS.
• Posicionamiento: Los subtítulos se ubican en la parte inferior con una tipografía y estilo que respeta la interfaz del juego.

2. Parcheo de Archivos Unity (actualizar_todo.py)

El motor principal de inyección.

• Utiliza UnityPy para localizar los PathIDs de los videos y texturas originales.
• Realiza una inyección quirúrgica de bytes en los archivos .assets y .resource de NT25_Data.
• Seguridad: Crea backups .bak automáticos de los archivos originales antes de modificarlos.

3. Empaquetado (copy_to_patch.py & comprimir_patch.py)

• copy_to_patch.py: Recolecta todos los archivos modificados de NT25_Data y los coloca en una carpeta patch/.
• comprimir_patch.py: Genera un archivo ZIP con el parche listo para ser instalado.

Requisitos

• FFmpeg debe estar instalado en el sistema (el script intentará usar el binario de imageio-ffmpeg por defecto).