[HO] NJEMU - Emulador de CPS1 CPS2 NeoGeo MVS / AES y NeoGeo CD para PS2

Este es el hilo oficial del emulador NJEMU para PS2, así que todo lo relacionado con este emulador deberá ir en este hilo.

El desarrollador fjtrujy ha publicado el port del emulador arcade multiplataforma llamado NJEMU para PS2.

https://x.com/fjtrujy/status/2110492985473356030

NJEMU es un emulador de código abierto para hardware de arcades clásicos de Capcom y SNK.
Comenzó como un proyecto para PSP y, actualmente, utiliza una única base de código en C que funciona en PSP, PlayStation 2, PlayStation Vita y sistemas de escritorio.

El proyecto emula:

- Capcom CPS1
- Capcom CPS2
- Neo Geo MVS/AES
- Neo Geo CD (NCDZ)

NJEMU se centra en mantener la viabilidad técnica en consolas originales con memoria limitada, al tiempo que comparte la lógica de emulación, el código de la interfaz gráfica (GUI),
la semántica de renderizado, los metadatos, la configuración y las herramientas entre todas las plataformas.

Características:

- Emulación de CPS1, CPS2, MVS/AES y Neo Geo CD.
- Interfaz gráfica de usuario (GUI)/menú común, además de una opción de ejecución sin interfaz gráfica (GUI=OFF).
- Guardado de estado (save states) y previsualización de los estados guardados.
- Metadatos de juegos externos y paquetes de localización generados.
- Posibilidad de seleccionar el motor gráfico durante la ejecución, en caso de que la plataforma ofrezca más de una opción.
- Soporte para caché de transmisión (streaming cache) en configuraciones de CPS2/MVS con memoria limitada.
- Optimizaciones específicas para cada plataforma, en cuanto a renderizado, audio, entrada, gestión de hilos, temporización y memoria, bajo una estructura de controladores común
- Herramienta basada en navegador para la conversión de ROMs de MVS/CPS2, destinada a procesar recursos y generar caché

Las funcionalidades opcionales o específicas de cada plataforma se documentan por separado; su presencia no está garantizada en todas las combinaciones de núcleo (core) y plataforma.

Funcionalidades específicas de Playstation 2

- Renderizado nativo mediante gsKit/PS2SDK y controladores nativos de la plataforma.
- La compilación para CPS2 y MVS incluye, por defecto, soporte para caché en flujo (streaming-cache).
- Se dispone de E/S de caché acelerada para aquellas configuraciones que admiten el uso de caché.
- Los modos de salida incluyen 240p, 480i y 480p, con posibilidad de configuración global en tiempo de ejecución tras el inicio.
- Multijugador local con soporte para el Multitap de hasta 4 jugadores.
- Diseñado para el hardware de PS2 incluyendo configuraciones CRT.
- La versión estándar utiliza la ruta de imágenes de controladores integradas.
La opción que emplea imágenes IRX externas se mantiene como una variante destinada al desarrollo o la validación, en lugar de ser la recomendada para su distribución.

Descarga del emulador NJEMU y acceso al conversor de ROMS

Descargad la versión estable que se encuentra en la sección "Versiones etiquetadas":

https://fjtrujy.github.io/NJEMU/

El sitio ofrece tanto la versión estable más reciente (según SemVer) como una compilación de desarrollo, actualizada automáticamente a partir de la rama «master».
No se incluyen ROMs, BIOS, cachés, datos de juego procesados, partidas guardadas ni otros datos de ejecución que pertenezcan al usuario.

Guía de usuario

Controles y configuraciones recomendadas

Círculo - Aceptar
Equis - Cancelar / Volver atrás
Triángulo - Salir del emulador
SELECT - Muestra información sobre los controles
SELECT + START - [Durante el juego] Abre el menú de opciones

Para mejorar la jugabilidad se recomienda intentar usar siempre esta configuración:

Vídeo y pantalla:

Video Sync: On
Límite de FPS: Off

Si la emulación es bastante pesada y hay muchas caídas de frames se puede usar esta otra configuración:

Vídeo y pantalla:

Video Sync: Adaptativo
Límite de FPS: Off

Aunque al usar esta configuración si hay frames que van lentos causarán que aparezca tearing.

Capcom CPS1

Estructura de directorios:



ROMS

Coloca tus archivos ZIP de ROMs en el directorio roms/. Las ROMs deben estar en formato MAME.

Ejemplos:

- "sf2.zip" - Street Fighter II
- "ffight.zip2 - Final Fight
- "ghouls.zip" - Ghouls'n Ghosts
- "strider.zip" - Strider

Nota: Algunos juegos requieren ROMs «padre» (parent ROMs). Por ejemplo, "sf2ua.zip" (clon) requiere "sf2.zip" (ROM «padre»).

Trucos

Coloca los archivos INI de trucos en el directorio cheats/. Los archivos deben llevar el mismo nombre que la ROM (por ejemplo, "sf2.ini" para "sf2.zip").

Solución de problemas

"ROM no encontrada"

- Comprueba que el conjunto de ROMs aparezca en el archivo "gamelist_cps1.txt".
- Asegúrate de que las ROMs estén en formato MAME.
- Comprueba que las ROMs principales (parent ROMs) estén presentes si se trata de clones.

"El juego no aparece en la lista"

- Consulta el archivo "gamelist_cps1.txt" para ver los juegos compatibles.
- El nombre del archivo de la ROM debe coincidir exactamente (en algunas plataformas se distingue entre mayúsculas y minúsculas).

Capcom CPS2

Estructura de directorios:



Archivos de caché (OBLIGATORIOS)

Todos los juegos de CPS2 requieren archivos de caché para funcionar en la PS2 debido a limitaciones de memoria.

Genera los archivos de caché utilizando el conversor de ROMs basado en web:

https://fjtrujy.github.io/NJEMU/

Selecciona la opción "Abrir el conversor de ROM", luego la opción "CPS2", arrastra la ROM sobre la ventana y pulsa el botón "Convertir ROM".
Generará un archivo zip comprimido con la carpeta caché del juego, descomprime el archivo zip y copia la carpeta caché del juego dentro
de la carpeta "cache/".

ROMS

Coloca tus archivos ZIP de ROMs en el directorio roms/. Las ROMs deben estar en formato MAME.

Ejemplos:

- "ssf2t.zip" - Super Street Fighter II Turbo
- "mvsc.zip" - Marvel vs. Capcom
- "sfa3.zip" - Street Fighter Alpha 3
- "xmvsf.zip" - X-Men vs. Street Fighter

Nota: Algunos juegos requieren ROMs «padre» (parent ROMs). Por ejemplo, "ssf2tu.zip" (clon) requiere "ssf2t.zip" (ROM «padre»).

Trucos

Coloca los archivos INI de trucos en el directorio cheats/. Los archivos deben llevar el mismo nombre que la ROM (por ejemplo, "ssf2t.ini" para "ssf2t.zip").

Solución de problemas

"No se pudo abrir archivo de cache / El juego no inicia"

- Genera los archivos de caché en https://fjtrujy.github.io/NJEMU/
- Asegúrate de que la carpeta de caché del juego se encuentre en el directorio "cache/".
- El nombre de la carpeta de caché debe coincidir con el nombre de la ROM.

"ROM no encontrada"

- Comprueba que el conjunto de ROMs aparezca en el archivo "gamelist_cps2.txt".
- Asegúrate de que las ROMs estén en formato MAME.
- Comprueba que las ROMs principales (parent ROMs) estén presentes si se trata de clones.

"El juego no aparece en la lista"

- Consulta el archivo "gamelist_cps2.txt" para ver los juegos compatibles.
- El nombre del archivo de la ROM debe coincidir exactamente (en algunas plataformas se distingue entre mayúsculas y minúsculas).

NeoGeo MVS / AES

Estructura de directorios:



Archivo BIOS (OBLIGATORIO)

Coloca la BIOS en el directorio "roms/".

- neogeo.zip (BIOS de Neo Geo)

BIOS compatibles:

- BIOS MVS/AES estándar
- UniBIOS 1.0 - 3.0 (recomendada para cambiar de región o modo)
- BIOS NeoGit

Importante: Con copiar la BIOS neogeo.zip en su lugar, no es suficiente, hay que seleccionarla en el emulador.
Para ello estando en la lista de juegos situado sobre cualquier juego pulsa el botón "R1".
Se abrirá una pantalla con la lista de las BIOS que tenga el archivo neogeo.zip, selecciona una de ellas pulsando el botón círculo, luego pulsa el
botón equis para volver a la lista de juegos.
De esta forma el emulador tendrá seleccionada la BIOS.
Si en cualquier momento deseas cambiar de BIOS, sólo hay que ir de nuevo a la lista de juegos, pulsar el botón "R1" y seleccionar cualquier otra.

ROMS

Coloca tus archivos ZIP de ROMs en el directorio roms/. Las ROMs deben estar en formato MAME.

Ejemplos:

- "mslug.zip" - Metal Slug
- "kof97.zip" - The King of Fighters '97
- "garou.zip" - Garou: Mark of the Wolves

Nota: Algunos juegos requieren ROMs «padre» (parent ROMs). Por ejemplo, "kof97a.zip" (clon) requiere "kof97.zip" (ROM «padre»).

Archivos de caché (necesarios para juegos de gran tamaño)

Muchos juegos de MVS contienen datos gráficos que superan la memoria RAM disponible. Estos juegos requieren archivos de caché.

Genera los archivos de caché utilizando el conversor de ROMs basado en web:

https://fjtrujy.github.io/NJEMU/

Selecciona la opción "Abrir el conversor de ROM", luego la opción "NeoGeo-MVS", arrastra la ROM sobre la ventana y pulsa el botón "Convertir ROM".
Generará un archivo zip comprimido con la carpeta caché del juego, descomprime el archivo zip y copia la carpeta caché del juego dentro de la carpeta
"cache/".

Trucos

Coloca los archivos INI de trucos en el directorio cheats/. Los archivos deben llevar el mismo nombre que la ROM (por ejemplo, "mslug.ini" para "mslug.zip").

Solución de problemas

"BIOS no encontrada / El juego no inicia"

- Asegúrate de que el archivo "neogeo.zip" se encuentre en el directorio "roms/".
- Comprueba que el archivo de la BIOS no esté dañado.

"No se pudo abrir archivo de cache" o "Archivo no encontrado. processed/ssrom" / El juego no inicia"

- El juego requiere archivos de caché; genéralos en https://fjtrujy.github.io/NJEMU/
- Coloca la carpeta de caché en el directorio "cache/".

"ROM no encontrada"

- Comprueba que el conjunto de ROMs aparezca en el archivo "gamelist_mvs.txt".
- Asegúrate de que las ROMs estén en formato MAME.
- Comprueba que las ROMs principales (parent ROMs) estén presentes si se trata de clones.

"El juego no aparece en la lista"

- Consulta el archivo "gamelist_mvs.txt" para ver los juegos compatibles.
- El nombre del archivo de la ROM debe coincidir exactamente (en algunas plataformas se distingue entre mayúsculas y minúsculas).

"El cambio de región/modo no funciona"

- Algunos juegos cuentan con protección contra cambios de región.
- Utiliza UniBIOS para realizar cambios de región/modo de forma fiable.

NeoGeo CD

Estructura de directorios:



Archivos BIOS (OBLIGATORIOS)

Coloca estos archivos en el mismo directorio que el ejecutable, de lo contrario el emulador no iniciará:

- neocd.bin (BIOS de Neo Geo CDZ)
- 000-lo.lo (ROM LO de Neo Geo)

Imágenes de CD

Coloca tus imágenes de CD en el directorio roms/.

Formatos compatibles:

- Archivos ISO (.iso)
- Archivos BIN/CUE (.bin + .cue)

Ejemplos:

- lastblad.iso - The Last Blade
- kof97/ - The King of Fighters '97 (carpeta con pistas de audio CD)

Trucos

Coloca los archivos INI de trucos en el directorio cheats/.

Solución de problemas

"NEO GEO CDZ BIOS (neocd.bin) not found" (BIOS de NEO GEO CDZ no encontrada)

- Coloca el archivo "neocd.bin" en el mismo directorio que el ejecutable.
- Comprueba que el archivo no esté dañado.

"LO ROM not found" (BIOS LO ROM no encontrada)

- Coloca el archivo "000-lo.lo" en el mismo directorio que el ejecutable.

El juego no carga

- Comprueba que el formato de la imagen de CD sea compatible.
- Comprueba que la imagen no esté dañada.
- Algunos juegos pueden requerir versiones específicas de la BIOS.

Contribuciones y reportes de errores (Issues en Github)

Se proporcionan formularios de *issues* en GitHub para reportar errores, problemas de rendimiento y solicitudes de nuevas funcionalidades.
En el caso de errores o problemas de rendimiento en el emulador que puedan reproducirse una vez iniciada la partida, se debe incluir un estado guardado (*save state*)
capturado lo más cerca posible del momento en que ocurre el problema; esto permitirá a los desarrolladores reproducir la situación exacta con rapidez.

Los reportes también deben incluir la versión exacta del NJEMU que aparece en la aplicación o en los registros, el núcleo del emulador, el nombre de la ROM o del conjunto (ROM set),
la plataforma anfitriona, (en este caso Playstation 2), los ajustes relevantes del *backend* o de la caché, y los pasos para reproducir el problema.

Accede al siguiente enlace para hacer reportes:

https://github.com/fjtrujy/NJEMU/issues

Es importante que probéis los juegos en PS2 y reportéis todos los errores, así los desarrolladores podrán ir arreglándolos y mejorar el emulador.

Si te ha gustado o servido este trabajo puedes valorarlo positivamente haciendo clic en el icono de +1 que hay arriba a la derecha, agradecer no cuesta nada.

Saludos.