0.2.3: saved games load, and the 16:9 freezes fixed

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch: 0.2.3 makes saved games load (before, the game saved but always said "unable to load"), and fixes the 16:9 freezes. Your saves already on the card load too. Build it from your own copy of the game, from a disc image or the disc's files.

Note

Saves and freezes fixed; to be confirmed on a console. Saved games never loaded: the game showed "UNABLE TO LOAD SPIDER-MAN 2 SAVED GAME" and started over. And a tester's logs from 0.2.1 showed 16:9 freezing for up to 4 seconds at a time while the game waited for the SD card. Both are fixed, and checked on the PC test build. How it runs on a Switch still needs a console, so reports with the logs folder are very welcome. As with any homebrew, back up your SD card and use emuMMC.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.2.3.zip	The port and its builder. Unzip it and double-click build-windows.cmd (or run bash build.sh on Linux): it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.2.3

• Saved games load. The game saved fine, but loading always failed with "UNABLE TO LOAD SPIDER-MAN 2 SAVED GAME", so progress seemed lost every time you started the game. The game reads its save in small pieces and expects each read to still be in progress, as on the Xbox's hard disk; the port finished every read at once, and the game took that for the end of the file after only 1 KB of the 48 KB save. The saves were always written whole, so the ones already on your card load now: choose your save in the pause menu's SAVE/LOAD, or the game loads it when it starts.
• A copy of your saves, just in case. The port keeps a copy in sdmc:/config/SpiderMan2Xbox/save/, outside its own folder, and brings it up to date a few seconds after each save. If an update ever replaces the whole SpiderMan2Xbox folder and takes save/ with it, the copy is put back by itself at the next start.
• The game never waits for the SD card because of the log. The game's threads now only hand their log lines to a thread of the port's own, which writes them to the card four times a second. Before, some lines were still written by the game itself, and when the card was slow the game stopped until it was done.
• A message repeated too often is cut short. After 100 times in 10 seconds, the rest are only counted, and one line says how many were left out. In 0.2.1, 16:9 wrote one message over 9,000 times in 80 seconds. Errors are always written.
• A crash keeps the last lines. If the game crashes, the lines still in memory go into the log before the crash report.

Also new since 0.2.1 (from 0.2.2)

• 16:9 no longer writes to the SD card every frame. This was the cause of the 16:9 slowdown in 0.2.0 and 0.2.1.
• New 4:3 decoration: suit sides. In the debug menu, Screen now has 4:3, suit sides: the spider web at the sides in the suit's colours, red with raised black webbing, a dark seam, and blue below it. It costs nothing while you play.
• Texture filtering's help now says that anisotropic filtering is a lot of work for the Switch's graphics chip in the city. If the frame rate drops, try Standard first.

Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.2.3.zip. On Windows, double-click build-windows.cmd and choose your game (the first time it sets up WSL and the tools: step by step). On Linux, run bash build.sh --copy-game "/path/to/Spider-Man 2.iso" (on Ubuntu or Debian it installs its tools the first time: step by step).
3. Copy the switch folder it made (in SD card on Windows, out/sd on Linux) to the root of your SD card: your game is already in it.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.

Updating from 0.2.2, 0.2.1, 0.2.0 or 0.1.0: build 0.2.3 and copy its switch folder over the old one. game/, save/ and your settings stay (from 0.1.0 or 0.2.0, the stock clocks become Auto). The shaders already built are kept.

Known issues: web-swinging was reported to show only one animation, and building windows wrong reflections: neither is fixed yet, and a short video of each with the logs folder would show what to fix. Playing docked on a TV hasn't been confirmed on a console yet; the Auto clocks use more battery than the console's own; anisotropic filtering costs a lot of the graphics chip's time in the city; in Spanish, French, German and Italian the voices are in English (the disc only has the English ones); only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder, the frame-rate counter's number and the debug menu settings you use (or your settings.ini), and say what happens: it doesn't start, an error screen, a freeze, or it's slow. Every 5 seconds the log writes perf: lines that say where the time goes on your console.

---

Español

Spider-Man 2 (Xbox original, 2004) para Nintendo Switch: con la 0.2.3 las partidas guardadas cargan (antes el juego guardaba pero siempre decía "unable to load"), y se arreglan los congelamientos del 16:9. Las partidas que ya tienes en la tarjeta también cargan. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.

[!NOTE]
Partidas y congelamientos arreglados; por confirmar en una consola. Las partidas guardadas nunca cargaban: el juego mostraba "UNABLE TO LOAD SPIDER-MAN 2 SAVED GAME" y empezaba de nuevo. Y los registros de un tester con la 0.2.1 mostraban el 16:9 congelándose hasta 4 segundos seguidos mientras el juego esperaba a la tarjeta SD. Las dos cosas están arregladas y se comprobaron en la versión de prueba para PC. Cómo va en una Switch todavía necesita una consola, así que los reportes con la carpeta logs son muy bienvenidos. Como con cualquier homebrew, haz una copia de seguridad de tu tarjeta SD y usa emuMMC.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.2.3.zip	El port y su compilador. Descomprímelo y haz doble clic en build-windows.cmd (o ejecuta bash build.sh en Linux): crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.2.3

• Las partidas guardadas cargan. El juego guardaba bien, pero al cargar siempre fallaba con "UNABLE TO LOAD SPIDER-MAN 2 SAVED GAME", así que el progreso parecía perderse cada vez que abrías el juego. El juego lee su partida en trozos pequeños y espera que cada lectura siga en curso, como en el disco duro de la Xbox; el port terminaba cada lectura al instante, y el juego lo tomaba como el final del archivo después de solo 1 KB de los 48 KB de la partida. Las partidas siempre se escribieron completas, así que las que ya tienes en la tarjeta cargan ahora: elige tu partida en SAVE/LOAD del menú de pausa, o el juego la carga al arrancar.
• Una copia de tus partidas, por si acaso. El port guarda una copia en sdmc:/config/SpiderMan2Xbox/save/, fuera de su propia carpeta, y la pone al día unos segundos después de cada guardado. Si una actualización llega a reemplazar toda la carpeta SpiderMan2Xbox y se lleva save/, la copia vuelve sola en el siguiente arranque.
• El juego nunca espera a la tarjeta SD por culpa del registro. Los hilos del juego ahora solo le pasan sus líneas del registro a un hilo propio del port, que las escribe en la tarjeta cuatro veces por segundo. Antes, algunas líneas las seguía escribiendo el propio juego, y cuando la tarjeta iba lenta el juego se detenía hasta que terminaba.
• Un mensaje que se repite demasiado se corta. Pasadas 100 veces en 10 segundos, las demás solo se cuentan, y una línea dice cuántas se dejaron fuera. En la 0.2.1, el 16:9 escribió un mismo mensaje más d...

0.2.2: the 16:9 slowdown fixed, and suit-coloured 4:3 sides

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch: 0.2.2 fixes the 16:9 slowdown, and adds a new 4:3 decoration, the web in the suit's colours. In 16:9 the port wrote a line to its log on the SD card several times a frame, and the game waited for every write. Build it from your own copy of the game, from a disc image or the disc's files.

Note

The cause of the 16:9 slowdown, fixed; to be confirmed on a console. 0.2.0 and 0.2.1 were reported slow, above all in 16:9. The cause found is fixed in this version, and it was checked on the PC test build. How it runs on a Switch still needs a console, so reports with the logs folder are very welcome. As with any homebrew, back up your SD card and use emuMMC.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.2.2.zip	The port and its builder. Unzip it and double-click build-windows.cmd (or run bash build.sh on Linux): it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.2.2

• New 4:3 decoration: suit sides. In the debug menu, Screen now has 4:3, suit sides: the spider web at the sides in the suit's colours, red with raised black webbing hanging from the top corners, a dark seam, and blue below it. Like the web sides, it is drawn once and costs nothing while you play.
• 16:9 no longer writes to the SD card every frame. The game resets its camera to 4:3 every frame, once for each of its drawing passes. Every time the port switched it back to 16:9, it wrote a line to the log, and on the Switch each line went to the SD card at once while the game waited. That happened several times a frame: a short session on the PC test build wrote over 20,000 of those lines. Now it is logged only the first few times.
• No log line makes the game wait for the SD card any more. Warnings and errors are still saved at once. Everything else is collected and written to the card every quarter of a second by a separate thread, so a burst of log lines can't slow the game down again. A crash still leaves its report.
• Texture filtering's help now says that anisotropic filtering is a lot of work for the Switch's graphics chip in the city. If the frame rate drops, try Standard first.
• A correction: 0.2.1's notes said the port's threads all shared one of the Switch's cores. That was wrong: the Switch's system library already lets every thread use all three cores. 0.2.1 only gave the renderer and the sound a starting core of their own.

Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.2.2.zip. On Windows, double-click build-windows.cmd and choose your game (the first time it sets up WSL and the tools: step by step). On Linux, run bash build.sh --copy-game "/path/to/Spider-Man 2.iso" (on Ubuntu or Debian it installs its tools the first time: step by step).
3. Copy the switch folder it made (in SD card on Windows, out/sd on Linux) to the root of your SD card: your game is already in it.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.

Updating from 0.2.1, 0.2.0 or 0.1.0: build 0.2.2 and copy its switch folder over the old one. game/, save/ and your settings stay (from 0.1.0 or 0.2.0, the stock clocks become Auto). The shaders already built are kept.

Known issues: web-swinging was reported to show only one animation, and building windows wrong reflections: neither is fixed yet, and a short video of each with the logs folder would show what to fix. Playing docked on a TV and saving haven't been confirmed on a console yet; the Auto clocks use more battery than the console's own; anisotropic filtering costs a lot of the graphics chip's time in the city; in Spanish, French, German and Italian the voices are in English (the disc only has the English ones); only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder, the frame-rate counter's number and the debug menu settings you use (or your settings.ini). Every 5 seconds the log writes perf: lines that say where the time goes on your console.

---

Español

Spider-Man 2 (Xbox original, 2004) para Nintendo Switch: la 0.2.2 arregla el bajón del 16:9 y trae una decoración nueva para el 4:3, la telaraña con los colores del traje. En 16:9 el port escribía una línea en su registro de la tarjeta SD varias veces por imagen, y el juego esperaba cada escritura. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.

[!NOTE]
La causa del bajón en 16:9, arreglada; por confirmar en una consola. Se reportó que la 0.2.0 y la 0.2.1 iban lentas, sobre todo en 16:9. La causa encontrada está arreglada en esta versión y se comprobó en la versión de prueba para PC. Cómo va en una Switch todavía necesita una consola, así que los reportes con la carpeta logs son muy bienvenidos. Como con cualquier homebrew, haz una copia de seguridad de tu tarjeta SD y usa emuMMC.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.2.2.zip	El port y su compilador. Descomprímelo y haz doble clic en build-windows.cmd (o ejecuta bash build.sh en Linux): crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.2.2

• Decoración nueva para el 4:3: suit sides. En el menú de depuración, Screen ahora tiene 4:3, suit sides: la telaraña a los lados con los colores del traje, rojo con las líneas negras en relieve colgando de las esquinas de arriba, una costura oscura y azul debajo. Igual que la telaraña, se dibuja una sola vez y no cuesta nada mientras juegas.
• El 16:9 ya no escribe en la tarjeta SD en cada imagen. El juego vuelve a poner su cámara en 4:3 en cada imagen, una vez por cada una de sus pasadas de dibujo. Cada vez que el port la volvía a poner en 16:9 escribía una línea en el registro, y en la Switch cada línea iba a la tarjeta SD en el momento, mientras el juego esperaba. Pasaba varias veces por imagen: una sesión corta en la versión de prueba para PC escribió más de 20.000 de esas líneas. Ahora solo se registra las primeras veces.
• Ninguna línea del registro hace esperar al juego por la tarjeta SD. Las advertencias y los errores se siguen guardando al momento. Todo lo demás se junta y un hilo aparte lo escribe en la tarjeta cada cuarto de segundo, así que una ráfaga de líneas ya no puede volver a frenar el juego. Un cierre inesperado sigue dejando su reporte.
• La ayuda de Texture filtering ahora dice que el filtrado anisotrópico es mucho trabajo para el chip gráfico de la Switch en la ciudad. Si bajan las imágenes por segundo, prueba primero Standard.
• Una corrección: las notas de la 0.2.1 decían que todos los hilos del port compartían uno de los núcleos de la Switch. Era un error: la biblioteca del sistema de la Switch ya deja que cada hilo use los tres núcleos. La 0.2.1 solo le dio al renderizador y al sonido un núcleo de inicio propio.

Los detalles están en la lista de cambios (en inglés).

Cómo instalarlo

1. Consigue tu juego como imagen de disco o como los archivos del disco (cómo).
2. Descomprime SpiderMan2-2004-NX-0.2.2.zip. En Windows, haz doble clic en build-windows.cmd y elige tu juego (la primera vez prepara WSL y las herramientas: paso a paso). En Linux, ejecuta bash build.sh --copy-game "/ruta/a/Spider-Man 2.iso" (en Ubuntu o Debian instala sus herramientas la primera vez: [paso a paso](https://github.com/SantiBros/SpiderM...

0.2.1 – Faster: all three cores, Auto clocks, lighter 16:9 and 720p/1080p

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch: 0.2.1 is about speed. The port now uses all three of the Switch's cores, sets the clocks for the game by itself, keeps the HUD 4:3 in 16:9 almost for free, and at 720p and 1080p enlarges only the main picture. Build it from your own copy of the game, from a disc image or the disc's files.

Note

Faster, to be confirmed on a console. 0.2.0 was reported unplayable on a Switch Lite. The fixes below were measured on the PC test build; how fast 0.2.1 runs on a Switch still needs a console, so reports with the logs folder are very welcome. As with any homebrew, back up your SD card and use emuMMC.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.2.1.zip	The port and its builder. Unzip it and double-click build-windows.cmd (or run bash build.sh on Linux): it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.2.1

• All three cores. A thread a Switch program starts may only run on the first core unless it is told otherwise, so the game, the renderer and the sound were all taking turns on one core, and the render thread gained nothing. Now the renderer has the second core, the sound and the port's own small threads the third, and the game the first, and each can move to an idle core.
• Auto clocks, the new default. The debug menu's clocks start on Auto: 1785 MHz CPU, 1600 MHz memory, and a GPU clock that follows the picture (460.8 MHz at 480p in handheld mode, 768 MHz at 720p and docked). These are all clocks Nintendo uses. If your settings.ini had the old stock clocks, they switch to Auto; any clock you chose yourself stays. Stock is still there if you'd rather save battery.
• 16:9 costs almost nothing now. To keep the HUD 4:3, 0.2.0 ran every small draw through the CPU, about 11 ms a frame on the PC test build and several times that on a Switch. Now it is about 0.3 ms.
• 720p and 1080p enlarge only the main picture. The game's small extra images (its shadows and glow passes) stay at their original size, so the extra work grows with the main picture only. The picture looks the same.
• 1080p is for docked play. In handheld mode it draws 720p, which is what the screen shows anyway.
• No new stutter after updating: the shaders your console built with 0.2.0 are kept.
• Lighter screen sides, faster texture checks, fewer writes to the SD card, and a more detailed perf: line in the log, so a console's log can show what to speed up next.

Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.2.1.zip. On Windows, double-click build-windows.cmd and choose your game (the first time it sets up WSL and the tools: step by step). On Linux, run bash build.sh --copy-game "/path/to/Spider-Man 2.iso" (on Ubuntu or Debian it installs its tools the first time: step by step).
3. Copy the switch folder it made (in SD card on Windows, out/sd on Linux) to the root of your SD card: your game is already in it.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.

Updating from 0.2.0 or 0.1.0: build 0.2.1 and copy its switch folder over the old one. game/, save/ and your settings stay (stock clocks become Auto). From 0.2.0 the shaders already built are kept; from 0.1.0 they are built again once.

Known issues: web-swinging was reported to show only one animation, and building windows wrong reflections: neither is fixed yet, and a short video of each with the logs folder would show what to fix. Playing docked on a TV and saving haven't been confirmed on a console yet; the Auto clocks use more battery than the console's own; in Spanish, French, German and Italian the voices are in English (the disc only has the English ones); only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder, the frame-rate counter's number and the debug menu settings you use. Every 5 seconds the log writes perf: lines that say where the time goes on your console.

---

Español

Spider-Man 2 (Xbox original, 2004) para Nintendo Switch: la 0.2.1 se trata de velocidad. El port ahora usa los tres núcleos de la Switch, pone los relojes para el juego por sí solo, mantiene el HUD en 4:3 con 16:9 casi sin costo, y a 720p y 1080p solo agranda la imagen principal. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.

[!NOTE]
Más rápida, por confirmar en una consola. Se reportó que la 0.2.0 no se podía jugar en una Switch Lite. Los arreglos de abajo se midieron en la versión de prueba para PC; qué tan rápido va la 0.2.1 en una Switch todavía necesita una consola, así que los reportes con la carpeta logs son muy bienvenidos. Como con cualquier homebrew, haz una copia de seguridad de tu tarjeta SD y usa emuMMC.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.2.1.zip	El port y su compilador. Descomprímelo y haz doble clic en build-windows.cmd (o ejecuta bash build.sh en Linux): crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.2.1

• Los tres núcleos. Un hilo que inicia un programa de Switch solo puede correr en el primer núcleo si no se le indica otra cosa, así que el juego, el renderizador y el sonido se turnaban en un solo núcleo, y el hilo de renderizado no ayudaba en nada. Ahora el renderizador tiene el segundo núcleo, el sonido y los hilos pequeños del port el tercero, y el juego el primero, y cada uno puede pasar a un núcleo libre.
• Relojes Auto, el nuevo valor de fábrica. Los relojes del menú de depuración empiezan en Auto: 1785 MHz de CPU, 1600 MHz de memoria y un reloj de GPU que sigue a la imagen (460,8 MHz a 480p en modo portátil, 768 MHz a 720p y en el dock). Todos son relojes que usa Nintendo. Si tu settings.ini tenía los relojes de fábrica de antes, pasan a Auto; un reloj que hayas elegido tú se queda. Stock sigue ahí si prefieres ahorrar batería.
• 16:9 ya casi no cuesta. Para mantener el HUD en 4:3, la 0.2.0 pasaba cada dibujo pequeño por la CPU, unos 11 ms por imagen en la versión de prueba para PC y varias veces más en una Switch. Ahora son unos 0,3 ms.
• 720p y 1080p solo agrandan la imagen principal. Las imágenes extra pequeñas del juego (sus sombras y pasadas de brillo) se quedan en su tamaño original, así que el trabajo extra solo crece con la imagen principal. La imagen se ve igual.
• 1080p es para jugar en el dock. En modo portátil dibuja 720p, que es lo que la pantalla muestra de todos modos.
• Sin tirones nuevos al actualizar: los shaders que tu consola preparó con la 0.2.0 se conservan.
• Lados de la pantalla más ligeros, revisión de texturas más rápida, menos escrituras en la tarjeta SD y una línea perf: más detallada en el registro, para que el registro de una consola muestre qué acelerar después.

Los detalles están en la lista de cambios (en inglés).

Cómo instalarlo

1. Consigue tu juego como imagen de disco o como los archivos del disco (cómo).
2. Descomprime SpiderMan2-2004-NX-0.2.1.zip. En Windows, haz doble clic en build-windows.cmd y elige tu juego (la primera vez prepara WSL y las herramientas: paso a paso). En Linux, ejecuta bash build.sh --copy-game "/ruta/a/Spider-Man 2.iso" (en Ubuntu o Debian instala sus herramientas la primera vez: [paso a paso](https://github.com/SantiBros/SpiderMan2-2004-NX/blob/main/docs/INSTALL.es.md#en-l...

0.2.0 – 720p/1080p, full screen 16:9 and vibration

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch: 720p and 1080p, a full 16:9 screen without stretching, 4:3 with blurred or spider-web sides instead of black bars, sharper upscaling, anisotropic filtering, and vibration. Build it from your own copy of the game, from a disc image or the disc's files.

Note

New settings, to be tried on a console. 0.1.0 plays smoothly on a Switch Lite in handheld mode, and 0.2.0 starts with the same picture (480p, 4:3). The new resolutions, the 16:9 screen and the vibration were checked on the PC test build; how fast 720p and 1080p run on a Switch, and how the vibration feels, still need a console: reports are welcome. As with any homebrew, back up your SD card and use emuMMC.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.2.0.zip	The port and its builder. Unzip it and double-click build-windows.cmd (or run bash build.sh on Linux): it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.2.0

All of these are in the debug menu (ZL + ZR + −), change at once while you play, and are saved in settings.ini.

• 720p or 1080p (Resolution). Every surface the game draws is made bigger alike, the movies included, so the whole picture is sharper. 720p fills the handheld screen pixel for pixel; 1080p is drawn bigger and shrunk, with smoother edges. More work for the GPU: if the frame rate drops, raise the GPU clock.
• Full screen 16:9, nothing stretched (Screen → 16:9 full screen). The game has a widescreen camera of its own that the retail game never switched on: the port turns it on, so you see more of the city at the sides, while the HUD, menus, text and movies keep their 4:3 shape in the middle.
• 4:3 with something at the sides instead of black bars: the picture itself blurred and dimmed, or a spider web.
• Sharper upscaling (Upscaling → Sharp, a Catmull-Rom filter) and anisotropic filtering (4x, 8x, 16x) for crisper movies and streets in the distance.
• Vibration: Off, Low, Medium (the default) or High, on Joy-Con or a Pro Controller. The game never vibrated before: it asks each controller which motors it has, and the answer said none. A rumble the game leaves on dies away after 2 seconds, so a controller never keeps shaking on its own, and none runs while the debug menu is open or in the HOME menu. The Switch Lite has no rumble motor of its own: Joy-Con or a Pro Controller paired with it vibrate.
• Swing logging: each web-swing writes swing: lines to the log (which swing animations the game picks), for the report below.

Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.2.0.zip. On Windows, double-click build-windows.cmd and choose your game (the first time it sets up WSL and the tools: step by step). On Linux, run bash build.sh --copy-game "/path/to/Spider-Man 2.iso" (on Ubuntu or Debian it installs its tools the first time: step by step).
3. Copy the switch folder it made (in SD card on Windows, out/sd on Linux) to the root of your SD card: your game is already in it.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.

Updating from 0.1.0: build 0.2.0 and copy its switch folder over the old one. game/, save/ and your settings.ini stay as they are (the new settings start at 480p, 4:3 black sides, smooth, standard filtering and medium vibration). The shaders are built again at the first start, so the first time through each place can stutter briefly again.

Known issues: web-swinging was reported to show only one animation, and building windows wrong reflections: neither is fixed yet, and a short video of each with the logs folder would show what to fix. Playing docked on a TV and saving haven't been confirmed on a console yet; in Spanish, French, German and Italian the voices are in English (the disc only has the English ones); only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder, the frame-rate counter's number and the debug menu settings you use, and a photo or video if something looks wrong or it froze.

---

Español

Spider-Man 2 (Xbox original, 2004) para Nintendo Switch: 720p y 1080p, pantalla completa 16:9 sin estirar, 4:3 con los lados difuminados o con una telaraña en vez de franjas negras, un escalado más nítido, filtrado anisotrópico y vibración. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.

[!NOTE]
Ajustes nuevos, por probar en una consola. La 0.1.0 va fluida en una Switch Lite en modo portátil, y la 0.2.0 arranca con la misma imagen (480p, 4:3). Las nuevas resoluciones, la pantalla 16:9 y la vibración se comprobaron en la versión de prueba para PC; cómo de rápido van 720p y 1080p en una Switch, y cómo se siente la vibración, todavía necesitan una consola: los reportes son bienvenidos. Como con cualquier homebrew, haz una copia de seguridad de tu tarjeta SD y usa emuMMC.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.2.0.zip	El port y su compilador. Descomprímelo y haz doble clic en build-windows.cmd (o ejecuta bash build.sh en Linux): crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.2.0

Todo esto está en el menú de depuración (ZL + ZR + −), cambia al momento mientras juegas y se guarda en settings.ini.

• 720p o 1080p (Resolution). Todo lo que dibuja el juego se agranda por igual, también los vídeos, así que toda la imagen es más nítida. 720p llena la pantalla portátil píxel a píxel; 1080p se dibuja más grande y se reduce, con bordes más suaves. Es más trabajo para la GPU: si bajan las imágenes por segundo, sube el reloj de la GPU.
• Pantalla completa 16:9, sin estirar (Screen → 16:9 full screen). El juego tiene una cámara panorámica propia que la versión comercial nunca activó: el port la activa, así que ves más ciudad a los lados, mientras el HUD, los menús, los textos y los vídeos mantienen su forma 4:3 en el centro.
• 4:3 con algo a los lados en vez de franjas negras: la propia imagen difuminada y oscurecida, o una telaraña.
• Un escalado más nítido (Upscaling → Sharp, un filtro Catmull-Rom) y filtrado anisotrópico (4x, 8x, 16x) para vídeos más nítidos y calles más definidas a lo lejos.
• Vibración: Off, Low, Medium (la de fábrica) o High, en los Joy-Con o un Pro Controller. Antes el juego nunca vibraba: pregunta a cada control qué motores tiene, y la respuesta decía que ninguno. Si el juego deja una vibración encendida, se apaga sola a los 2 segundos, así que un control nunca se queda vibrando solo, y no vibra con el menú de depuración abierto ni en el menú HOME. La Switch Lite no tiene motor de vibración propio: los Joy-Con o un Pro Controller conectados a ella sí vibran.
• Registro del balanceo: cada balanceo con la telaraña escribe líneas swing: en el registro (qué animaciones de balanceo elige el juego), para el problema de abajo.

Los detalles están en la lista de cambios (en inglés).

Cómo instalarlo

1. Consigue tu juego como imagen de disco o como los archivos del disco (cómo).
2. Descomprime SpiderMan2-2004-NX-0.2.0.zip. En Windows, haz doble clic en build-windows.cmd y elige tu juego (la primera vez prepara WSL y las herramientas: paso a paso). En Linux, ejecuta bash build.sh --copy-game "/ruta/a/Spider-Man 2.iso" (en Ubuntu o Debian instala sus herramientas la...

Spider-Man 2 (Xbox) for Switch 0.1.0: debug menu and your language"

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch: a debug menu with a frame-rate counter and the Switch's clocks, the game in your console's language, a clean start screen and faster game code. Build it from your own copy of the game, from a disc image or the disc's files.

Warning

Test build, not yet played on a Switch. On the PC test build the game runs through its menus, cinematics and first missions in the city, in five languages. On a Switch it has not yet got past its start in testing, so how fast it runs there is not known yet: this version brings a frame-rate counter and the Switch's clocks to find out. Back up your SD card and use emuMMC. Testers are welcome.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.1.0.zip	The port and its builder. Unzip it and double-click build-windows.cmd (or run bash build.sh on Linux): it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.1.0

• A debug menu. Hold ZL + ZR and press − for the port's settings, over the game: the language, the Switch's CPU, GPU and memory clocks, a frame-rate counter, the sound volume, the renderer, the render thread and the start-up log. Each has a line of help, and the bottom line shows the frame rate of the moment. Saved in settings.ini beside the .nro; the touch screen works too.
• The Switch's clocks. Stock unless you change them, and only rates Nintendo's own performance profiles use (up to 1785 MHz CPU, 768 MHz GPU, 1600 MHz memory). The console's own clocks come back in the HOME menu and when you quit, and yours come back after docking or sleep. If the counter stays under 30, try a higher CPU clock first.
• A frame-rate counter in the black bar beside the picture: the frame rate, or also the time of a frame, the draw calls, the clocks and the memory.
• The game in your language. It follows the console's language: menus and subtitles in Spanish, French, German or Italian, from the texts on your disc (English for any other language). The voices stay in English, as the disc only has those. The debug menu can choose another language.
• A clean start screen: "Loading..." until the game draws, instead of the log scrolling by. The debug menu's start-up log brings the log back, for a photo when the game doesn't start.
• Faster: the game's thread needs about 14% less processor time a frame on the PC test build. The recompiled code now lets the processor keep the game's registers in its own between memory writes (about 5% less code for the Switch's processor), and recording each draw for the GPU costs less.
• A new icon in the Homebrew Menu: Spider-Man's mask with the game's logo.
• Easier to build. On Windows, double-click build-windows.cmd and choose your game: it sets up WSL and the tools the first time, builds the .nro, and makes an SD card folder with the port and your game in it, ready to copy. On Linux, build.sh installs its own tools on Ubuntu and Debian, and --copy-game puts your game in the SD card folder too.
• Saves in a folder of their own, like the NFS Most Wanted port: save/ holds your saves (easy to back up), and cache/ the rest of the Xbox's hard disk and the shader list (safe to delete).
  Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.1.0.zip. On Windows, double-click build-windows.cmd and choose your game (the first time it sets up WSL and the tools: step by step). On Linux, run bash build.sh --copy-game "/path/to/Spider-Man 2.iso" (on Ubuntu or Debian it installs its tools the first time: step by step).
3. Copy the switch folder it made (in SD card on Windows, out/sd on Linux) to the root of your SD card: your game is already in it.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.
   Updating from 0.0.10 or an earlier test build: build 0.1.0 and copy its switch folder over the old one. game/ stays as it is, and your saves in hdd/ move to the new save/ folder at the first start (the rest of hdd/ becomes cache/). Build it again from your copy: the recompiled code changed.

Known issues: how fast it runs on a Switch isn't known yet; the Windows builder is new, so if it stops, the install guide has the same steps by hand; in Spanish, French, German and Italian the voices are in English (the disc only has the English ones); the first time through a place can still stutter while shaders are built; only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder, the frame-rate counter's number and any debug menu settings you changed, and a photo of the screen if something looks wrong or it froze. If it stops on "Loading...", turn on the start-up log in the debug menu (or put startup_log=on in settings.ini) and send a photo.

---

Español

**Spider-Man 2 (Xbox original, 2004) para Nintendo Switch: un menú de depuración con contador de imágenes por segundo y los relojes de la Switch, el juego en el idioma de tu consola, una pantalla de arranque limpia y un código del juego más rápido. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.**

[!WARNING]
Versión de prueba, todavía no se ha jugado en una Switch. En la versión de prueba para PC el juego pasa por sus menús, cinemáticas y primeras misiones en la ciudad, en cinco idiomas. En una Switch todavía no ha pasado de su arranque en las pruebas, así que todavía no se sabe a qué velocidad va ahí: esta versión trae un contador de imágenes por segundo y los relojes de la Switch para averiguarlo. Haz una copia de seguridad de tu tarjeta SD y usa emuMMC. Se buscan testers.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.1.0.zip	El port y su compilador. Descomprímelo y haz doble clic en build-windows.cmd (o ejecuta bash build.sh en Linux): crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.1.0

• Un menú de depuración. Mantén ZL + ZR y pulsa − para los ajustes del port, sobre el juego: el idioma, los relojes de CPU, GPU y memoria de la Switch, un contador de imágenes por segundo, el volumen, el renderizador, el hilo de renderizado y el registro de arranque. Cada uno tiene una línea de ayuda, y la línea de abajo muestra las imágenes por segundo de ese momento. Se guarda en settings.ini, junto al .nro; también funciona la pantalla táctil. El menú está en inglés.
• Los relojes de la Switch. De fábrica salvo que los cambies, y solo velocidades que usan los perfiles de rendimiento de Nintendo (hasta 1785 MHz de CPU, 768 MHz de GPU, 1600 MHz de memoria). Los relojes de la consola vuelven en el menú HOME y al salir, y los tuyos vuelven después de conectar al dock o del modo reposo. Si el contador se queda por debajo de 30, prueba primero un reloj de CPU más alto.
• Un contador de imágenes por segundo en la franja negra junto a la imagen: las imágenes por segundo, o también el tiempo de cada imagen, las llamadas de dibujo, los relojes y la memoria.
• El juego en tu idioma. Sigue el idioma de la consola: menús y subtítulos en español, francés, alemán o italiano, con los textos de tu disco (en inglés para cualquier otro idioma). Las voces siguen en inglés, porque el disco solo trae esas. El menú de depuración permite elegir otro idioma.
• Una pantalla de arranque limpia: "Loading..." hasta que el juego dibuja, en vez del registro pasando. El registro de arranque del menú de depuración lo vuelve a mostrar, para una foto si el juego no arranca.
• Más rápido: el hilo del juego ne...

Spider-Man 2 (Xbox) for Switch 0.0.10: early test

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch: one crash fewer, plus 0.0.9's videos at their real speed, building shadows in the right place and fewer stutters. Build it from your own copy of the game, from a disc image or the disc's files.

Warning

Early test, not playable yet. On the PC test build the game runs through its menus, cinematics and demos into the city. On a Switch it has not yet got past its start, and 0.0.8 to 0.0.10 are the first builds that draw with the Switch's GPU, so how fast it runs there is not known yet. Back up your SD card and use emuMMC. Testers are welcome.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.0.10.zip	The port and its builder. Unzip it and run bash build.sh "your game": it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.0.10

• A crash waiting to happen is gone. A system function the game uses to ask about a drive (its free space and details) had no implementation, and a call to it would have stopped the game. It now answers like the port's other drive queries.

From 0.0.9 (if you're coming from 0.0.8)

• The videos play at their real speed. The Activision and Treyarch logos, the intro and the cutscene videos ran twice too fast: the game shows a frame every two vertical blanks (30 a second) and the port showed one every blank. The whole game now keeps to that pace, as on the Xbox, which is also half the work for the GPU.
• Building shadows fall where they should, and half of the screen no longer goes dark. The game fills its shadow volumes in the GPU's 2X multisample mode, where the screen counts half as many pixels across; the port squeezed them into the left half and darkened that half of the screen.
• Shadow volumes drawn with the right vertices: a mesh placed far into a shared vertex buffer was drawn from the start of it.
• Fewer stutters the second time. The shaders the game needed are kept in shaders.cache beside the .nro and built again at the next start, a little each frame, so a place you already went through doesn't stall on them. The log has a hitch: line for each stutter left, with what took the time.

Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.0.10.zip on a Linux PC or in WSL on Windows, and run bash build.sh "/path/to/Spider-Man 2.iso". The first time, install the tools it needs: sudo dkp-pacman -S switch-dev switch-mesa (step by step).
3. Copy out/sd/switch to the root of your SD card, and your game into switch/SpiderMan2Xbox/game/.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.

Updating from 0.0.9 or an earlier test build: build 0.0.10 and copy its out/sd/switch folder over the old one. game/ and hdd/ stay as they are.

Known issues: how fast it runs on a Switch isn't known yet; the first time through a place can still stutter while shaders are built; only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder (its perf: and hitch: lines say how fast it ran and where it stuttered), and a photo of the screen if something looks wrong or it froze.

---

Español

Spider-Man 2 (Xbox original, 2004) para Nintendo Switch: un cierre inesperado menos, y de la 0.0.9 vídeos a su velocidad real, sombras de los edificios en su sitio y menos tirones. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.

[!WARNING]
Prueba temprana, todavía no se puede jugar. En la versión de prueba para PC el juego pasa por sus menús, cinemáticas y demos hasta llegar a la ciudad. En una Switch todavía no ha pasado de su arranque, y de la 0.0.8 a la 0.0.10 son las primeras versiones que dibujan con la GPU de la Switch, así que todavía no se sabe a qué velocidad va ahí. Haz una copia de seguridad de tu tarjeta SD y usa emuMMC. Se buscan testers.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.0.10.zip	El port y su compilador. Descomprímelo y ejecuta bash build.sh "tu juego": crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.0.10

• Un cierre inesperado menos. Faltaba una función del sistema que el juego usa para consultar una unidad (su espacio libre y sus datos), y una llamada a ella habría detenido el juego. Ahora responde como las demás consultas de unidades del port.

De la 0.0.9 (si vienes de la 0.0.8)

• Los vídeos van a su velocidad real. Los logos de Activision y Treyarch, la intro y los vídeos de las escenas iban el doble de rápido: el juego muestra una imagen cada dos refrescos de pantalla (30 por segundo) y el port mostraba una en cada refresco. Ahora todo el juego va a ese ritmo, como en la Xbox, lo que también le ahorra la mitad del trabajo a la GPU.
• Las sombras de los edificios caen donde deben, y la mitad de la pantalla ya no se oscurece. El juego rellena sus volúmenes de sombra en el modo multisample 2X de la GPU, en el que la pantalla cuenta la mitad de píxeles a lo ancho; el port los apretaba en la mitad izquierda y oscurecía esa mitad de la pantalla.
• Volúmenes de sombra con sus vértices correctos: una malla colocada lejos dentro de un búfer de vértices compartido se dibujaba desde el principio de este.
• Menos tirones la segunda vez. Los shaders que necesitó el juego se guardan en shaders.cache, junto al .nro, y se vuelven a preparar al arrancar, un poco en cada imagen, así que un sitio por el que ya pasaste no se detiene por ellos. El registro tiene una línea hitch: por cada tirón que quede, con lo que se llevó el tiempo.

Los detalles están en la lista de cambios (en inglés).

Cómo instalarlo

1. Consigue tu juego como imagen de disco o como los archivos del disco (cómo).
2. Descomprime SpiderMan2-2004-NX-0.0.10.zip en un PC con Linux o en WSL en Windows, y ejecuta bash build.sh "/ruta/a/Spider-Man 2.iso". La primera vez, instala las herramientas que necesita: sudo dkp-pacman -S switch-dev switch-mesa (paso a paso).
3. Copia out/sd/switch a la raíz de tu tarjeta SD, y tu juego en switch/SpiderMan2Xbox/game/.
4. Mantén R mientras abres un juego para entrar al Homebrew Menu, y elige Spider-Man 2 (Xbox). No desde el Álbum: ahí no hay memoria suficiente.

Actualizar desde la 0.0.9 o una versión de prueba anterior: compila la 0.0.10 y copia su carpeta out/sd/switch encima de la anterior. game/ y hdd/ se quedan como están.

Problemas conocidos: todavía no se sabe a qué velocidad va en una Switch; la primera vez que pasas por un sitio todavía puede haber tirones mientras se preparan los shaders; solo funciona la edición cuyo default.xbe tiene el SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402.

Reportar problemas: abre un issue con la carpeta switch/SpiderMan2Xbox/logs comprimida (sus líneas perf: y hitch: dicen a qué velocidad fue y dónde dio tirones), y una foto de la pantalla si algo se ve mal o se congeló.

---

A project by SantiBros

SHA-256 of SpiderMan2-2004-NX-0.0.10.zip:
4fa0c551b204c0629fb6529d22febd9efb7188410c6da10791c716d3cc2e90ec

Spider-Man 2 (Xbox) for Switch 0.0.9: early test

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch: videos at their real speed, building shadows in the right place, fewer stutters. Build it from your own copy of the game, from a disc image or the disc's files.

Warning

Early test, not playable yet. On the PC test build the game runs through its menus, cinematics and demos into the city. On a Switch it has not yet got past its start, and 0.0.8 and 0.0.9 are the first builds that draw with the Switch's GPU, so how fast it runs there is not known yet. Back up your SD card and use emuMMC. Testers are welcome.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.0.9.zip	The port and its builder. Unzip it and run bash build.sh "your game": it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.0.9

• The videos play at their real speed. The Activision and Treyarch logos, the intro and the cutscene videos ran twice too fast: the game shows a frame every two vertical blanks (30 a second) and the port showed one every blank. The whole game now keeps to that pace, as on the Xbox, which is also half the work for the GPU.
• Building shadows fall where they should, and half of the screen no longer goes dark. The game fills its shadow volumes in the GPU's 2X multisample mode, where the screen counts half as many pixels across; the port squeezed them into the left half and darkened that half of the screen.
• Shadow volumes drawn with the right vertices: a mesh placed far into a shared vertex buffer was drawn from the start of it.
• Fewer stutters the second time. The shaders the game needed are kept in shaders.cache beside the .nro and built again at the next start, a little each frame, so a place you already went through doesn't stall on them. The log has a hitch: line for each stutter left, with what took the time.

Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.0.9.zip on a Linux PC or in WSL on Windows, and run bash build.sh "/path/to/Spider-Man 2.iso". The first time, install the tools it needs: sudo dkp-pacman -S switch-dev switch-mesa (step by step).
3. Copy out/sd/switch to the root of your SD card, and your game into switch/SpiderMan2Xbox/game/.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.

Updating from 0.0.8 or an earlier test build: build 0.0.9 and copy its out/sd/switch folder over the old one. game/ and hdd/ stay as they are.

Known issues: how fast it runs on a Switch isn't known yet; the first time through a place can still stutter while shaders are built; only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder (its perf: and hitch: lines say how fast it ran and where it stuttered), and a photo of the screen if something looks wrong or it froze.

---

Español

Spider-Man 2 (Xbox original, 2004) para Nintendo Switch: vídeos a su velocidad real, sombras de los edificios en su sitio y menos tirones. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.

[!WARNING]
Prueba temprana, todavía no se puede jugar. En la versión de prueba para PC el juego pasa por sus menús, cinemáticas y demos hasta llegar a la ciudad. En una Switch todavía no ha pasado de su arranque, y la 0.0.8 y la 0.0.9 son las primeras versiones que dibujan con la GPU de la Switch, así que todavía no se sabe a qué velocidad va ahí. Haz una copia de seguridad de tu tarjeta SD y usa emuMMC. Se buscan testers.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.0.9.zip	El port y su compilador. Descomprímelo y ejecuta bash build.sh "tu juego": crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.0.9

• Los vídeos van a su velocidad real. Los logos de Activision y Treyarch, la intro y los vídeos de las escenas iban el doble de rápido: el juego muestra una imagen cada dos refrescos de pantalla (30 por segundo) y el port mostraba una en cada refresco. Ahora todo el juego va a ese ritmo, como en la Xbox, lo que también le ahorra la mitad del trabajo a la GPU.
• Las sombras de los edificios caen donde deben, y la mitad de la pantalla ya no se oscurece. El juego rellena sus volúmenes de sombra en el modo multisample 2X de la GPU, en el que la pantalla cuenta la mitad de píxeles a lo ancho; el port los apretaba en la mitad izquierda y oscurecía esa mitad de la pantalla.
• Volúmenes de sombra con sus vértices correctos: una malla colocada lejos dentro de un búfer de vértices compartido se dibujaba desde el principio de este.
• Menos tirones la segunda vez. Los shaders que necesitó el juego se guardan en shaders.cache, junto al .nro, y se vuelven a preparar al arrancar, un poco en cada imagen, así que un sitio por el que ya pasaste no se detiene por ellos. El registro tiene una línea hitch: por cada tirón que quede, con lo que se llevó el tiempo.

Los detalles están en la lista de cambios (en inglés).

Cómo instalarlo

1. Consigue tu juego como imagen de disco o como los archivos del disco (cómo).
2. Descomprime SpiderMan2-2004-NX-0.0.9.zip en un PC con Linux o en WSL en Windows, y ejecuta bash build.sh "/ruta/a/Spider-Man 2.iso". La primera vez, instala las herramientas que necesita: sudo dkp-pacman -S switch-dev switch-mesa (paso a paso).
3. Copia out/sd/switch a la raíz de tu tarjeta SD, y tu juego en switch/SpiderMan2Xbox/game/.
4. Mantén R mientras abres un juego para entrar al Homebrew Menu, y elige Spider-Man 2 (Xbox). No desde el Álbum: ahí no hay memoria suficiente.

Actualizar desde la 0.0.8 o una versión de prueba anterior: compila la 0.0.9 y copia su carpeta out/sd/switch encima de la anterior. game/ y hdd/ se quedan como están.

Problemas conocidos: todavía no se sabe a qué velocidad va en una Switch; la primera vez que pasas por un sitio todavía puede haber tirones mientras se preparan los shaders; solo funciona la edición cuyo default.xbe tiene el SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402.

Reportar problemas: abre un issue con la carpeta switch/SpiderMan2Xbox/logs comprimida (sus líneas perf: y hitch: dicen a qué velocidad fue y dónde dio tirones), y una foto de la pantalla si algo se ve mal o se congeló.

---

A project by SantiBros

SHA-256 of SpiderMan2-2004-NX-0.0.9.zip:
0ba05e6688944a6668a6c326e82c51d013055fffd905fd174108dd799149b9fb

Spider-Man 2 (Xbox) for Switch 0.0.8: early test

Spider-Man 2 (original Xbox, 2004) for Nintendo Switch, now drawn by the Switch's graphics chip. Build it from your own copy of the game, from a disc image or the disc's files.

Warning

Early test, not playable yet. On the PC test build the game runs through its menus, cinematics and demos into the city. On a Switch it has not yet got past its start, and this is the first build that draws with the Switch's GPU, so how fast it runs there is not known yet. Back up your SD card and use emuMMC. Testers are welcome.

Important

No game files here, and no .nro. You need your own Spider-Man 2 for the original Xbox (not PS2, GameCube or PC), and you build the port from it on your computer. Never share the .nro you build: it holds code made from the game.

Which file do I download?

File	What it is	Do you need it?
SpiderMan2-2004-NX-0.0.8.zip	The port and its builder. Unzip it and run bash build.sh "your game": it makes the .nro from your own copy and lays out the SD card folder.	✅ Yes, this one
Source code (zip)	The same code, added by GitHub, without the version in the folder name.	❌ No (same thing)
Source code (tar.gz)	The same code as a .tar.gz, added by GitHub.	❌ No (same thing)

There is no ready-made .nro to download, and there never will be: it would contain the game's code.

New in 0.0.8

• The Switch's graphics chip draws the game, every frame, through OpenGL (Mesa), instead of a still picture from the CPU every few seconds. The game's vertex programs and pixel combiners become shaders; its textures are decoded once and kept; its vertices go to the GPU as the game made them.
• A render thread: the graphics work runs beside the game, on another core.
• Spider-Man is drawn when you play (only his shadow was), and the opening cinematic's sky is no longer grey noise.
• The log says where the time goes: every 5 seconds a perf: line with the frame rate and what each part of a frame cost.
• Start-up switches for testing, held while the port starts: R the old CPU renderer, ZR no render thread, L no sound.
• The repository is now SpiderMan2-2004-NX.

Also in this release, from 0.0.7 (never published on its own): your disc image works as it is (.iso / .xiso, .cci, .cso, also split for FAT32), clear messages when something is wrong, and one command to build. Details in the changelog.

How to install

1. Get your game as a disc image or as the disc's files (how).
2. Unzip SpiderMan2-2004-NX-0.0.8.zip on a Linux PC or in WSL on Windows, and run bash build.sh "/path/to/Spider-Man 2.iso". The first time, install the tools it needs, now with switch-mesa: sudo dkp-pacman -S switch-dev switch-mesa (step by step).
3. Copy out/sd/switch to the root of your SD card, and your game into switch/SpiderMan2Xbox/game/.
4. Hold R while launching a game to open the Homebrew Menu, then choose Spider-Man 2 (Xbox). Not from the Album: it doesn't have enough memory.

Updating from a test build (0.0.2 to 0.0.7): build 0.0.8 and copy its out/sd/switch folder over the old one. game/ and hdd/ stay as they are.

Known issues: how fast it runs on a Switch isn't known yet; only the release with default.xbe SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402 is supported.

Reporting: open an issue with the zipped switch/SpiderMan2Xbox/logs folder (its perf: lines say how fast it ran), and a photo of the screen if something looks wrong or it froze.

---

Español

Spider-Man 2 (Xbox original, 2004) para Nintendo Switch, ahora dibujado por el chip gráfico de la Switch. Compílalo a partir de tu propia copia del juego, desde una imagen de disco o los archivos del disco.

[!WARNING]
Prueba temprana, todavía no se puede jugar. En la versión de prueba para PC el juego pasa por sus menús, cinemáticas y demos hasta llegar a la ciudad. En una Switch todavía no ha pasado de su arranque, y esta es la primera versión que dibuja con la GPU de la Switch, así que todavía no se sabe a qué velocidad va ahí. Haz una copia de seguridad de tu tarjeta SD y usa emuMMC. Se buscan testers.

[!IMPORTANT]
Aquí no hay archivos del juego ni .nro. Necesitas tu propio Spider-Man 2 para la Xbox original (no el de PS2, GameCube ni PC), y compilas el port a partir de él en tu computador. Nunca compartas el .nro que compiles: contiene código hecho a partir del juego.

¿Qué archivo descargo?

Archivo	Qué es	¿Lo necesitas?
SpiderMan2-2004-NX-0.0.8.zip	El port y su compilador. Descomprímelo y ejecuta bash build.sh "tu juego": crea el .nro a partir de tu propia copia y prepara la carpeta de la tarjeta SD.	✅ Sí, este
Source code (zip)	El mismo código, añadido por GitHub, sin la versión en el nombre de la carpeta.	❌ No (es lo mismo)
Source code (tar.gz)	El mismo código en .tar.gz, añadido por GitHub.	❌ No (es lo mismo)

No hay un .nro listo para descargar, y nunca lo habrá: contendría el código del juego.

Novedades de la 0.0.8

• El chip gráfico de la Switch dibuja el juego, imagen por imagen, con OpenGL (Mesa), en vez de una imagen fija desde la CPU cada pocos segundos. Los programas de vértices y los combinadores de píxeles del juego se convierten en shaders; sus texturas se decodifican una vez y se guardan; sus vértices van a la GPU tal como los hizo el juego.
• Un hilo de renderizado: el trabajo gráfico va junto al juego, en otro núcleo.
• Spider-Man se dibuja mientras juegas (antes solo su sombra), y el cielo de la cinemática inicial ya no es ruido gris.
• El registro dice en qué se va el tiempo: cada 5 segundos una línea perf: con las imágenes por segundo y lo que costó cada parte de una imagen.
• Botones al arrancar para las pruebas, mantenidos mientras arranca el port: R el renderizador antiguo por CPU, ZR sin hilo de renderizado, L sin sonido.
• El repositorio ahora se llama SpiderMan2-2004-NX.

También en esta versión, de la 0.0.7 (que nunca se publicó por separado): tu imagen de disco funciona tal cual (.iso / .xiso, .cci, .cso, también divididas para FAT32), mensajes claros cuando algo está mal y un solo comando para compilar. Los detalles están en la lista de cambios (en inglés).

Cómo instalarlo

1. Consigue tu juego como imagen de disco o como los archivos del disco (cómo).
2. Descomprime SpiderMan2-2004-NX-0.0.8.zip en un PC con Linux o en WSL en Windows, y ejecuta bash build.sh "/ruta/a/Spider-Man 2.iso". La primera vez, instala las herramientas que necesita, ahora con switch-mesa: sudo dkp-pacman -S switch-dev switch-mesa (paso a paso).
3. Copia out/sd/switch a la raíz de tu tarjeta SD, y tu juego en switch/SpiderMan2Xbox/game/.
4. Mantén R mientras abres un juego para entrar al Homebrew Menu, y elige Spider-Man 2 (Xbox). No desde el Álbum: ahí no hay memoria suficiente.

Actualizar desde una versión de prueba (0.0.2 a 0.0.7): compila la 0.0.8 y copia su carpeta out/sd/switch encima de la anterior. game/ y hdd/ se quedan como están.

Problemas conocidos: todavía no se sabe a qué velocidad va en una Switch; solo funciona la edición cuyo default.xbe tiene el SHA-1 853bcb253c5baea2d7e2d9b59e5888b4c87bb402.

Reportar problemas: abre un issue con la carpeta switch/SpiderMan2Xbox/logs comprimida (sus líneas perf: dicen a qué velocidad fue), y una foto de la pantalla si algo se ve mal o se congeló.

---

A project by SantiBros

SHA-256 of SpiderMan2-2004-NX-0.0.8.zip:
a6dc49c7928c2bf0cfb69144c0a77266d0d8c602ebdded0e38d06c9eab77cd43