Mario Kart World (Nintendo Switch 2) recompilado para funcionar de forma nativa en Linux y Windows.
Versiones · Wiki de ayuda · Discord · Cambios · Contribuir · Fuentes · Hoja de ruta · Rendimiento · Issues · Discussions · Archivo
English · 简体中文 · Español · العربية · हिन्दी · Português (Brasil) · Português (Portugal) · Deutsch
Una recompilación estática de *Mario Kart World* (Nintendo Switch 2, versiones 1.0.0 y 1.8.0) en un programa nativo de PC para Linux y Windows. Necesita tu propia copia del juego, volcada de tu propia consola: nada del juego está en este repositorio ni en sus versiones publicadas. **Es una recompilación, no un emulador.** El código AArch64 del juego se traduce a C de antemano y se compila para la CPU del PC (x86-64, o AArch64 en Linux); no hay intérprete ni JIT de CPU. Tampoco se emula la GPU: NVN2, la API gráfica de Switch 2, se reimplementa sobre Vulkan a nivel de API, y los shaders SM86 del juego se traducen a SPIR-V de antemano. Las funciones del SDK de Nintendo (`nn::*`) se sustituyen por nombre con código propio. ## Estado Temprano, y avanzando rápido. A 12/11/2026: - Arranca, reproduce los vídeos de introducción, recorre los menús y corre carreras, en Linux y en Windows (x86-64), y en Linux sobre AArch64 (con su propio AppImage; probado en una consola portátil con Adreno 740). - La pantalla de inicio prepara el juego a partir de tu copia en tu máquina (genera y compila el C, traduce los shaders, calienta la caché de pipelines) y guarda todos los ajustes: pantalla, calidad gráfica, controles, hacks. - Las carreras van a 60 fps en GPU de gama alta y a 30 en las de gama media; ver [Rendimiento](#performance). - Problemas conocidos: algunos menús (modo, selección de personaje y de vehículo) aún necesitan trabajo, la sombra del kart pierde un fotograma de vez en cuando, parte del audio se corta en los vídeos y con algunos drivers de AMD la GPU puede colgarse. No hay juego en línea. ## Hoja de ruta El trabajo pendiente principal, por orden; los detalles están en [docs/project/roadmap.md](../../docs/project/roadmap.md). - **60 fps en carrera.** Hoy un fotograma de carrera es una cadena en serie: el juego termina su fotograma (~3 ms\*), luego el back end de Vulkan graba el gran envío del juego (~19 ms\*), luego la GPU lo ejecuta (~10 ms\*), y solo entonces empieza el siguiente fotograma. Grabar está en el camino crítico, así que el trabajo es grabar con menos CPU: estado dinámico solo cuando cambia, cachés de dibujos entre fotogramas, grabación en paralelo y un hilo del juego más rápido. - **La imagen como en la consola**: los últimos fallos del traductor de shaders, la sombra del kart, los push constants, cero errores de validación de Vulkan. - **Todos los menús comprobados** contra la consola: los siguientes, modo y selección de personaje y de vehículo. - **Sin cuelgues de GPU** y menos memoria de GPU; después, cargas sin tirones y un paquete de Linux para distribuciones que no son de actualización continua. - **La 1.8.0 a la par de la 1.0.0**: su aspecto ultrapanorámico, el tamaño del mapa de sombras y la semilla fija ([#19](https://github.com/adriadam10/mkw-recomp/issues/19)). \* Medido el 09/11/2026 en nuestra máquina de pruebas: APU Radeon 660M (Ryzen 5 7535HS), Linux, resolución interna 720p. ## Rendimiento Los tiempos por fotograma medidos, cada uno con la versión que probó, están en [docs/project/performance.md](../../docs/project/performance.md). Para añadir tu máquina, abre un [informe de rendimiento](https://github.com/adriadam10/mkw-recomp/issues/new?template=performance.yml): entra en la tabla con la versión que indica. Los tiempos son los fotogramas del propio juego: la generación de fotogramas muestra más fotogramas pero no los acorta. 16,7 ms son 60 fps; con Fotogramas por segundo en Automático (lo de la consola) baja a 30 fps cuando 60 no se alcanzan, y un fotograma de más de 33,3 ms hace que la carrera vaya más lenta que el tiempo real. | Fecha | GPU | Resolución interna | fps en carrera | Tiempo por fotograma | |---|---|---|---|---| | 11/11/2026 | RX 7900 XTX (Windows) | 2160p | 60 | 16,7 ms | | 11/11/2026 | RX 9070 XT (Linux, RADV) | 720p a 2160p | 60 | 16,7 ms | | 10/11/2026 | RTX 3060 (Windows) | 1080p | ~48 | ~21 ms | | 11/11/2026 | RTX 3050 Laptop (Windows) | 720p | ~37 | 26,7 ms | | 09/11/2026 | Radeon 660M (Linux, RADV) | 720p | 30-32 | 31-33 ms | | 11/11/2026 | GTX 1650 SUPER (Windows) | 1080p | ~24 | ~41 ms | | 09/11/2026 | GTX 1050 Ti (Windows) | 1080p | 22-24 | 42-45 ms | ## Cómo jugar   1. Vuelca Mario Kart World 1.0.0 o 1.8.0 de tu Switch 2 (`exefs/` y `romfs/`, descifrados; la 1.8.0 con la actualización integrada en la RomFS del juego base), o ese mismo volcado empaquetado en un único archivo `.nup` o `.nx`. 2. Descarga el lanzador para tu sistema desde [Versiones](https://github.com/adriadam10/mkw-recomp/releases): en Linux el `.AppImage` (`-aarch64` en ARM; la carpeta del juego por defecto es `~/.local/share/mkw-recomp`; glibc 2.31 o posterior: Debian 11, Ubuntu 20.04, SteamOS y posteriores), en Windows el `.zip`, descomprimido en una carpeta. En los dos hacen falta unos 30 GB libres. 3. Ejecuta el AppImage (antes, `chmod +x`) o `mkw.exe`, abre **Ficheros del juego**, si quieres elige con **Elegir carpeta del juego** dónde se instalará el juego (o una instalación que ya exista), indica tu volcado (**Elegir carpeta** o **Elegir archivo .nup o .nx**) y pulsa **Preparar**. El lanzador recuerda la carpeta de instalación; ahí viven el juego compilado, los ficheros preparados, las partidas guardadas, los ajustes y las cachés. Elegir otra carpeta deja los ficheros existentes donde están. La primera preparación tarda un rato (compila el juego entero y descarga `nvdisasm` y `ptxas` de NVIDIA, 84 MB en Linux y 126 MB en Windows, para describir la codificación de los shaders en tu máquina); después, **Jugar**. 4. Cuando sale una versión nueva, la pantalla de inicio la ofrece (**Actualizar a vX**): la descarga, la comprueba, sustituye el programa y vuelve a preparar solo lo que cambió. **Configuración → Menú → Buscar actualizaciones** lo desactiva. Requisitos: CPU x86-64 con AVX2 (o, en Linux, AArch64 con ARMv8.2: LSE, FP16, RCpc, DotProd, CRC32), una GPU con Vulkan 1.3 (se recomienda `VK_EXT_mesh_shader`; sin ella, los task y mesh shaders se ejecutan como compute) y 16 GB de RAM recomendados. En un contenedor Docker o Podman en Linux, permite `userfaultfd` en su perfil seccomp (el de Docker lo rechaza por defecto): sin él, el port no sabe qué memoria del juego cambió y va varias veces más lento. ## Funciones extra Más allá de la consola, todas opcionales y desactivadas (o al valor de la consola) por defecto: - **Pantalla**: resolución interna por encima o por debajo de la de la consola, 21:9, 32:9 y 48:9 (las carreras muestran más a los lados), escalado AMD FSR 1, HDR en pantallas HDR, VSync, presentación mailbox o inmediata. - **Generación de fotogramas**: fotogramas intercalados entre los del juego (una carrera a 30 fps mostrada a 60, o a 240 en una pantalla de 240 Hz). Más fluido, no más rápido: la imagen llega hasta un fotograma más tarde, y el movimiento rápido y el minimapa pueden emborronarse. - **Gráficos**: filtrado y calidad de texturas, distancia de detalle y calidad de sombras por encima o por debajo de las de la consola. - **Sonido**: sonido envolvente 5.1. - **Controles**: todas las teclas y botones reasignables, cámara con el ratón, iconos de botones de Nintendo, Xbox o PlayStation, dirección por movimiento, intensidad de la vibración; multijugador local con un mando cada uno. Los mandos de Switch 2 (Pro Controller, Joy-Con, GameCube) funcionan por Bluetooth y, en Linux, por USB; en Windows el USB necesita un paso único con el controlador, más abajo. - **Hacks**: turbo (mantener o alternar F2), saltar vídeos, desbloquearlo todo, la misma aleatoriedad cada vez, directo a contrarreloj o a modo libre. - **Idiomas**: los menús en 20 idiomas; el propio juego también en catalán, gallego, euskera y turco. - **Ficheros del juego**: elegir la carpeta de instalación; un volcado en carpetas o en un único archivo `.nup` o `.nx`, usado donde está; actualizaciones desde la pantalla de inicio. - **Superposición de rendimiento** (FPS, o CPU, GPU y memoria al completo) e información del sistema en un clic para los informes de fallos. ### Mandos de Switch 2 por USB en Windows Estos mandos solo arrancan tras una orden enviada a su segunda interfaz USB, que Windows deja sin un controlador que una aplicación pueda usar. Una vez por mando, con [Zadig](https://zadig.akeo.ie/): 1. Conecta el mando con un cable USB-C y abre Zadig. 2. **Options → List All Devices**, y elige la **Interface 1** del mando (ID USB `057E` y `2069` para el Pro Controller, `2066`/`2067` para el Joy-Con derecho/izquierdo, `2073` para el mando de GameCube). No la Interface 0: esa es la entrada normal del mando, y sustituirla lo oculta a todas las demás aplicaciones. 3. Controlador **WinUSB**, y **Replace Driver** (o **Install Driver**). Lo mismo vale para un mando virtual que aparezca con esos ID USB (el modo USB/IP de Switch2Connect). Para deshacerlo, desinstala el dispositivo de esa interfaz en el Administrador de dispositivos con «eliminar el controlador» marcado. ## Mods La página **Mods** de la pantalla de inicio instala los mods tal como se publican para el juego y los lista en dos pestañas: - **Buscar en GameBanana**: los mods de Mario Kart World en [GameBanana](https://gamebanana.com/games/22152), listados o buscados, con el autor, la licencia, las capturas y la descripción de cada uno. **Instalar** descarga el archivo de GameBanana, solo cuando lo pides. - **Instalados**: tus mods, cada uno con su interruptor; **Importar zip / Importar carpeta** toma un mod que ya tengas (`.zip`, `.rar` o `.7z`, con `romfs/`, `exefs/` y/o `plugin/` en cualquier parte, también con la estructura `atmosphere/contents/`). Los mods que sustituyen ficheros del juego (`romfs/`: skins, texturas, textos, circuitos) se aplican en el siguiente arranque. Los que cambian el código del juego (parches `.ips` o `.pchtxt` de `exefs/`, como 200cc o 30 FPS) se integran en el código del juego: activar o desactivar uno lo recompila antes de jugar (unos minutos). Dos mods que cambian el mismo archivo se combinan fichero a fichero, y la página pregunta cuál gana donde los dos cambian el mismo fichero. La página avisa de los mods que sustituyen los ajustes gráficos o los shaders del juego, que el port gestiona a su manera. Un mod con carpeta `plugin/` lleva un plugin nativo (`.dll` en Windows, `.so` en Linux) que el juego carga al arrancar mientras el mod está activado. Ejecuta su propio programa en tu ordenador, así que la página lo avisa: actívalo solo si confías en su origen. Para quien hace mods, la API es una sola cabecera, [`runtime/plugin/mkw_plugin.h`](../../runtime/plugin/mkw_plugin.h), explicada en la página [Writing a plugin](https://github.com/adriadam10/mkw-recomp/wiki/Writing-a-plugin) de la wiki. Más sobre instalar y ordenar mods: la página [Mods](https://github.com/adriadam10/mkw-recomp/wiki/Mods) de la wiki. Los mods los hacen otras personas y este proyecto no los prueba: uno puede colgar el juego o dañar tu partida guardada. Lee la página de un mod antes de instalarlo, guarda una copia de tu partida y comunica los problemas de un mod a su autor; cuando informes de un fallo aquí, di qué mods estaban activados (el log los lista), o prueba antes sin ellos. ## Compilar desde el código fuente Linux, con `uv`, `clang`, `lld`, `ninja`, SDL3, Opus, libvpx, zstd, xxHash, las cabeceras de Vulkan y VMA 3.4.0 (detalles en [tools/build/README.md](../../tools/build/README.md)). Pon tu volcado en `game/` (`game/exefs`, `game/romfs`) o define `MKW_GAME=