Mario Kart World (Nintendo Switch 2) recompilado para rodar nativamente no Linux e no Windows.
Versões · Wiki de ajuda · Discord · Mudanças · Contribuir · Fontes · Roteiro · Desempenho · Issues · Discussões · Arquivo
English · 简体中文 · Español · العربية · हिन्दी · Português (Brasil) · Português (Portugal) · Deutsch
Uma recompilação estática de *Mario Kart World* (Nintendo Switch 2, versões 1.0.0 e 1.8.0) em um programa nativo de PC para Linux e Windows. Ele precisa da sua própria cópia do jogo, extraída do seu próprio console: nada do jogo está neste repositório nem nas suas versões publicadas. **É uma recompilação, não um emulador.** O código AArch64 do jogo é traduzido para C com antecedência e compilado para a CPU do PC (x86-64, ou AArch64 no Linux); não há interpretador nem JIT de CPU. A GPU também não é emulada: o NVN2, a API gráfica do Switch 2, é reimplementado sobre Vulkan no nível da API, e os shaders SM86 do jogo são traduzidos para SPIR-V com antecedência. As funções do SDK da Nintendo (`nn::*`) são substituídas pelo nome por código próprio. ## Status No começo, e avançando rápido. Em 12/11/2026: - Ele inicia, reproduz os vídeos de abertura, passa pelos menus e roda corridas, no Linux e no Windows (x86-64), e no Linux em AArch64 (com seu próprio AppImage; testado em um portátil com Adreno 740). - A tela inicial prepara o jogo a partir da sua cópia na sua máquina (gera e compila o C, traduz os shaders, aquece o cache de pipelines) e guarda todas as configurações: tela, qualidade gráfica, controles, hacks. - As corridas rodam a 60 fps em GPUs de ponta e a 30 nas intermediárias; veja [Desempenho](#performance). - Problemas conhecidos: alguns menus (modo, seleção de personagem e de veículo) ainda precisam de trabalho, a sombra do kart perde um quadro de vez em quando, parte do áudio corta nos vídeos e com alguns drivers da AMD a GPU pode travar. Não há jogo online. ## Roteiro O principal trabalho em aberto, em ordem; os detalhes estão em [docs/project/roadmap.md](../../docs/project/roadmap.md). - **60 fps nas corridas.** Hoje um quadro de corrida é uma cadeia em série: o jogo termina seu quadro (~3 ms\*), depois o back end Vulkan grava o grande envio do jogo (~19 ms\*), depois a GPU o executa (~10 ms\*), e só então começa o próximo quadro. Gravar está no caminho crítico, então o trabalho é gravar usando menos CPU: estado dinâmico só quando muda, caches de desenhos entre quadros, gravação em paralelo e uma thread do jogo mais rápida. - **A imagem como no console**: os últimos bugs do tradutor de shaders, a sombra do kart, push constants, zero erros de validação do Vulkan. - **Todos os menus conferidos** com o console: os próximos são modo e seleção de personagem e de veículo. - **Sem travamentos de GPU** e menos memória de GPU; depois, carregamentos sem engasgos e um pacote para distribuições Linux que não são rolling release. - **A 1.8.0 no mesmo nível da 1.0.0**: seu aspecto ultrawide, o tamanho do mapa de sombras e a semente fixa ([#19](https://github.com/adriadam10/mkw-recomp/issues/19)). \* Medido em 09/11/2026 na nossa máquina de teste: APU Radeon 660M (Ryzen 5 7535HS), Linux, resolução interna 720p. ## Desempenho Os tempos de quadro medidos, cada um com a versão testada, estão em [docs/project/performance.md](../../docs/project/performance.md). Para incluir a sua máquina, abra um [relatório de desempenho](https://github.com/adriadam10/mkw-recomp/issues/new?template=performance.yml): ele entra na tabela com a versão indicada. Os tempos são os quadros do próprio jogo: a geração de quadros mostra mais quadros, mas não os encurta. 16,7 ms são 60 fps; com Taxa de quadros em Automático (a do console) cai para 30 fps quando 60 não são alcançados, e um quadro acima de 33,3 ms faz a corrida rodar mais devagar que o tempo real. | Data | GPU | Resolução interna | fps na corrida | Tempo de quadro | |---|---|---|---|---| | 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 | ## Como jogar   1. Extraia o dump de Mario Kart World 1.0.0 ou 1.8.0 do seu Switch 2 (`exefs/` e `romfs/`, descriptografados; a 1.8.0 com a atualização mesclada à RomFS do jogo base), ou esse mesmo dump empacotado em um único arquivo `.nup` ou `.nx`. 2. Baixe o launcher para o seu sistema em [Versões](https://github.com/adriadam10/mkw-recomp/releases): no Linux o `.AppImage` (`-aarch64` em ARM; a pasta padrão do jogo é `~/.local/share/mkw-recomp`; glibc 2.31 ou mais recente: Debian 11, Ubuntu 20.04, SteamOS e posteriores), no Windows o `.zip`, descompactado em uma pasta. Os dois precisam de uns 30 GB livres. 3. Execute o AppImage (antes, `chmod +x`) ou o `mkw.exe`, abra **Arquivos do jogo**, se quiser use **Escolher pasta do jogo** para escolher onde o jogo será instalado (ou uma instalação que já exista), aponte para o seu dump (**Escolher pasta** ou **Escolher arquivo .nup ou .nx**) e clique em **Preparar**. O launcher lembra a pasta de instalação; é nela que ficam o jogo compilado, os arquivos preparados, os saves, as configurações e os caches. Escolher outra pasta deixa os arquivos existentes onde estão. A primeira preparação demora um pouco (compila o jogo inteiro e baixa o `nvdisasm` e o `ptxas` da NVIDIA, 84 MB no Linux e 126 MB no Windows, para descrever a codificação dos shaders na sua máquina); depois, **Jogar**. 4. Quando sai uma versão nova, a tela inicial a oferece (**Atualizar para vX**): ela baixa, verifica, substitui o programa e prepara de novo só o que mudou. **Configurações → Menu → Buscar atualizações** desativa essa verificação. Requisitos: CPU x86-64 com AVX2 (ou, no Linux, AArch64 com ARMv8.2: LSE, FP16, RCpc, DotProd, CRC32), uma GPU com Vulkan 1.3 (`VK_EXT_mesh_shader` recomendado; sem ele, os task e mesh shaders rodam como compute) e 16 GB de RAM recomendados. Em um contêiner Docker ou Podman no Linux, permita `userfaultfd` no perfil seccomp (o padrão do Docker o recusa): sem ele, o port não sabe qual memória do jogo mudou e roda várias vezes mais devagar. ## Recursos extras Além do console, todos opcionais e desligados (ou no valor do console) por padrão: - **Tela**: resolução interna acima ou abaixo da do console, 21:9, 32:9 e 48:9 (as corridas mostram mais nas laterais), escala AMD FSR 1, HDR em telas HDR, VSync, apresentação mailbox ou imediata. - **Geração de quadros**: quadros criados entre os do jogo (uma corrida a 30 fps mostrada a 60, ou a 240 em uma tela de 240 Hz). Mais fluido, não mais rápido: a imagem chega até um quadro depois, e movimentos rápidos e o minimapa podem borrar. - **Gráficos**: filtragem e qualidade de texturas, distância de detalhes e qualidade de sombras acima ou abaixo das do console. - **Som**: som surround 5.1. - **Controles**: todas as teclas e botões remapeáveis, câmera com o mouse, ícones de botões da Nintendo, Xbox ou PlayStation, direção por movimento, intensidade da vibração; multijogador local com um controle para cada um. Os controles do Switch 2 (Pro Controller, Joy-Con, GameCube) funcionam por Bluetooth e, no Linux, por USB; no Windows o USB precisa de um passo único com o driver, abaixo. - **Hacks**: turbo (segurar ou alternar F2), pular vídeos, desbloquear tudo, a mesma aleatoriedade sempre, direto para contra o relógio ou modo livre. - **Idiomas**: os menus em 20 idiomas; o próprio jogo também em catalão, galego e basco. - **Arquivos do jogo**: escolher a pasta de instalação; um dump em pastas ou em um único arquivo `.nup` ou `.nx`, usado onde está; atualizações pela tela inicial. - **Sobreposição de desempenho** (FPS, ou CPU, GPU e memória por completo) e informações do sistema em um clique para relatórios de bugs. ### Controles do Switch 2 por USB no Windows Esses controles só começam a funcionar depois de um comando enviado à sua segunda interface USB, que o Windows deixa sem um driver que um aplicativo possa usar. Uma vez por controle, com o [Zadig](https://zadig.akeo.ie/): 1. Conecte o controle com um cabo USB-C e abra o Zadig. 2. **Options → List All Devices**, e escolha a **Interface 1** do controle (ID USB `057E` e `2069` para o Pro Controller, `2066`/`2067` para o Joy-Con direito/esquerdo, `2073` para o controle de GameCube). Não a Interface 0: ela é a entrada normal do controle, e substituí-la esconde o controle de todos os outros aplicativos. 3. Driver **WinUSB**, depois **Replace Driver** (ou **Install Driver**). O mesmo vale para um controle virtual que apareça com esses IDs USB (o modo USB/IP do Switch2Connect). Para desfazer, desinstale o dispositivo dessa interface no Gerenciador de Dispositivos com "excluir o driver" marcado. ## Mods A página **Mods** da tela inicial instala os mods do jeito que são publicados para o jogo e os lista em duas abas: - **Buscar no GameBanana**: os mods de Mario Kart World no [GameBanana](https://gamebanana.com/games/22152), listados ou pesquisados, com o autor, a licença, as capturas de tela e a descrição de cada um. **Instalar** baixa o arquivo do GameBanana, só quando você pede. - **Instalados**: os seus mods, cada um com seu interruptor; **Importar zip / Importar pasta** recebe um mod que você já tenha (`.zip`, `.rar` ou `.7z`, com `romfs/` e/ou `exefs/` em qualquer lugar, inclusive na estrutura `atmosphere/contents/`). Os mods que substituem arquivos do jogo (`romfs/`: skins, texturas, textos, pistas) valem a partir da próxima inicialização. Os que mudam o código do jogo (patches `.ips` ou `.pchtxt` de `exefs/`, como 200cc ou 30 FPS) são incorporados ao código do jogo: ligar ou desligar um o recompila antes de jogar (alguns minutos). Dois mods que mudam o mesmo pacote são mesclados arquivo por arquivo, e a página pergunta qual vale onde os dois mudam o mesmo arquivo. A página avisa sobre mods que substituem as configurações gráficas ou os shaders do jogo, que o port trata do seu jeito. Os mods são feitos por outras pessoas e não são testados por este projeto: um mod pode travar o jogo ou danificar o seu save. Leia a página de um mod antes de instalar, guarde uma cópia do seu save e informe os problemas de um mod ao autor dele; quando relatar um bug aqui, diga quais mods estavam ligados (o log os lista), ou tente antes sem eles. ## Compilar a partir do código-fonte Linux, com `uv`, `clang`, `lld`, `ninja`, SDL3, Opus, libvpx, zstd, xxHash, os cabeçalhos do Vulkan e VMA 3.4.0 (detalhes em [tools/build/README.md](../../tools/build/README.md)). Coloque o seu dump em `game/` (`game/exefs`, `game/romfs`) ou defina `MKW_GAME=