GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/pokeemerald-vita-3ds / docs

COMPILA_TU_VPK.md

6348 bytes · Original / download

Compila tu propia VPK

En desarrollo y en pruebas. Por favor, reporta los errores que encuentres (ver el final de esta guía).

Este repositorio no incluye los gráficos, sonidos ni datos binarios del juego, y no se distribuyen VPK compiladas. Tú haces tu propia VPK a partir de tu copia del juego:

  1. Necesitas un volcado de tu cartucho de Pokémon Esmeralda (.gba, cualquier idioma). El script solo lo lee para comprobar que es Pokémon Esmeralda; no copia nada de él, ni lo guarda ni lo sube a ningún sitio.
  2. Después descarga los archivos del juego de la decompilación pret/pokeemerald (a través de pokeemerald-multiplatform, la versión en la que se basa este port) y comprueba cada uno con tools/assets/manifest.txt.
  3. Compila la VPK, y tú la instalas en tu PS Vita.

No compartas la VPK ni los archivos descargados: contienen datos del juego de Nintendo.

Versión en inglés: BUILD_YOUR_OWN.md.

Qué necesitas

Todo lo demás (MSYS2, VitaSDK, Python, Git) lo instala el script.

1. Descarga el repositorio

Clónalo con Git:

git clone https://github.com/HctrRB/pokeemerald-vita-3ds.git C:\Emerald\pokeemerald-vita-3ds

o, sin Git, usa Code > Download ZIP en GitHub y descomprímelo.

Ponlo en una carpeta cuya ruta no tenga espacios ni tildes, por ejemplo C:\Emerald\pokeemerald-vita-3ds. Las herramientas de compilación no los soportan (el script lo comprueba y se para), así que C:\Users\Tu Nombre\Downloads\... no sirve. Evita las carpetas que sincroniza OneDrive (a menudo Documentos y Escritorio): la compilación escribe miles de archivos y la sincronización puede bloquearlos.

2. Compila

Haz doble clic en build_all.bat, en la carpeta del repositorio. Una ventana te pide tu .gba, y la consola se queda abierta al final con el resultado. (Si Windows avisa de que el archivo viene de internet, elige Más información > Ejecutar de todas formas.)

O, desde PowerShell en la carpeta del repositorio:

powershell.exe -ExecutionPolicy Bypass -File .\build_all.ps1 -Rom "C:\ruta\a\esmeralda.gba"

Sirve cualquier ruta de la ROM, con espacios incluidos; sin -Rom, la ventana te la pide.

El script:

  1. instala MSYS2 en C:\msys64 si no está, y los paquetes que necesita la compilación;
  2. instala VitaSDK en MSYS2 (/usr/local/vitasdk) y las librerías que usa el juego (vitaGL, SDL2) si no están;
  3. comprueba tu volcado y descarga los archivos del juego (unos 9.000);
  4. genera el atlas de la interfaz, compila las herramientas, convierte los archivos del juego y compila la VPK.

La primera vez descarga 1–2 GB y puede tardar 20–40 minutos; las siguientes, unos minutos. El resultado es EmeraldVita.vpk en la carpeta del repositorio. Los pasos ya hechos se saltan, así que puedes volver a ejecutarlo después de un fallo.

Actualizar: git pull (o vuelve a descargar el ZIP encima de la misma carpeta) y ejecuta build_all.bat otra vez. La ROM solo se pide la primera vez: si una versión nueva necesita otros archivos del juego, el script los descarga solo.

3. Instala

  1. Copia EmeraldVita.vpk a la Vita (por USB o FTP con VitaShell).
  2. En VitaShell, pulsa X sobre la VPK e instálala (en los ajustes de HENkaku tiene que estar activado Enable unsafe homebrew).
  3. El juego aparece como Emerald Vita. Las partidas y los ajustes se guardan en ux0:data/POKEVITA/.

Si quieres tu propio arte en el LiveArea, ponlo en vita/sce_sys_custom/ con los mismos nombres que en vita/sce_sys/ (PNG indexados de 8 bits); se usa en lugar de las imágenes neutras.

Errores frecuentes

Mensaje Solución
This folder's path has spaces or special characters Mueve la carpeta del repositorio a una ruta sencilla, como C:\Emerald\pokeemerald-vita-3ds.
Permission denied / Device or resource busy al compilar Suele ser OneDrive o un antivirus bloqueando archivos: saca la carpeta de OneDrive, o vuelve a ejecutar el script.
Could not download MSYS2 / MSYS2 did not install Instala MSYS2 a mano desde msys2.org en C:\msys64 y vuelve a ejecutar el script.
not a Pokémon Emerald dump El archivo no es una ROM de Pokémon Esmeralda o está dañado. Tiene que medir 16 MB.
VitaSDK did not install / ... is still missing after vdpm install Casi siempre es una descarga que falló: vuelve a ejecutar el script. Si no, mira BUILD.md.
vitaGL.h: No such file or directory Tu copia del script es anterior al arreglo que instala vitaGL: actualiza el repositorio (git pull o un ZIP nuevo) y vuelve a ejecutar build_all.ps1.
la ejecución de scripts está deshabilitada en este sistema Lánzalo exactamente como arriba (powershell.exe -ExecutionPolicy Bypass -File ...).

Compilar a mano

El script hace estos pasos; puedes hacerlos tú en la consola MSYS2 MINGW64, desde la carpeta del repositorio (cd /c/Emerald/pokeemerald-vita-3ds):

  1. Paquetes y VitaSDK, una vez (los comandos exactos y los problemas típicos están en BUILD.md).
  2. Los archivos del juego, una vez: sh ./fetch_assets.sh /c/ruta/a/esmeralda.gba
  3. Las herramientas y los archivos del juego convertidos: sh make -f make_tools.mk -j8 CC="gcc -static" CXX="g++ -static" make -f vita/assets.mk -j8
  4. La VPK: ./build_vita.sh → build-vita/pokeemerald.vpk.

Reportar errores

Este port está en desarrollo y en pruebas. Si algo falla, abre un issue en GitHub con la plantilla Bug report e incluye: