← Voltar para o InícioComo o Karamelo Emu funciona
Controles, ajustes por sistema, filtros, RetroAchievements e o que ainda não está funcionando. Sem rodeios: aqui vai o que foi verificado e o que ainda precisa de atenção.
Status real por sistema
Verificado significa: carregado e visto rodando, com imagem na tela. Os demais dependem de BIOS ou não foram testados nesta rodada.
| Sistema | Core | Situação | Observação |
|---|---|---|---|
| Master System | sms.dll — Gearsystem | ✅ Verificado | Usado como referência em todos os testes de vídeo. |
| PlayStation | psx.dll — Beetle PSX | ✅ Verificado | Fechava ao carregar até a ordem de inicialização das portas ser corrigida. |
| PlayStation 2 (PS2) | ps2.dll — LRPS2 (PCSX2) / Play! | ✅ Verificado | Core padrão LRPS2 (PCSX2) e alternativo Play!. Motor de áudio reformulado: detecta taxa nativa via SDL_AudioStream, reseta sincronia por jogo, compensação de deriva por histerese e fila adaptativa que auto-expande em underruns. |
| Nintendo DS | nds.dll — melonDS | ✅ Verificado | Com layouts de tela e caneta pelo mouse. |
| Mega CD / Sega CD | genesis.dll — Genesis Plus GX | 🔑 Precisa de BIOS | Precisa de bios_CD_U.bin (ou _E/_J). A abertura de alguns jogos é longa por emular leitora 1x. |
| NeoGeo CD | neocd_alt.dll | 🔑 Precisa de BIOS | BIOS em bios/neocd/. Imagens de disco não usam o core Geolith. |
| Saturn | saturn.dll — Beetle Saturn | 🔑 Precisa de BIOS | sega_101.bin / mpr-17933.bin. CHD e .7z funcionam. |
| Dreamcast | dreamcast.dll — Flycast | 🔑 Precisa de BIOS | Exige 3D Acceleration ligado em Settings → Video. |
| TurboGrafx CD | pce.dll | 🔑 Precisa de BIOS | syscard3.pce. |
| Nintendo 64 | n64.dll / n64_parallel.dll / n64_mupen.dll / n64_gopher.dll | 🔑 Precisa de BIOS | Seletor de core no menu (Mupen64Plus-Next, ParaLLEl N64 e Gopher64). |
| GameCube | gamecube.dll — Dolphin | ⛔ Não funciona | Não funciona. Falha dentro do Dolphin, em thread própria, logo após “Booting from disc”. Precisa de contexto OpenGL compartilhado entre threads, que o backend atual não oferece. |
Controles
🎮 Controle (SDL_Gamepad)
Não há nada para configurar. O frontend consulta até 4 controles via SDL_Gamepad a cada quadro, então um controle plugado no meio do jogo simplesmente passa a funcionar — sem reiniciar, sem mapear. Cobre Xbox, DualShock, DualSense, Switch Pro e genéricos Bluetooth/DirectInput pela mesma interface.
Mapeamento fixo (losango do MiSTer)| A (baixo) | → B | Pular / atacar |
| B (direita) | → A | Confirmar |
| X (esquerda) | → Y | Correr / atacar |
| Y (cima) | → X | Especial |
| LB / RB | → L / R | Ombros |
| Start / Back | → Start / Select | Start+Select abre o OSD |
L2 e R2 (gatilhos analógicos), L3 e R3 (clique dos analógicos), analógico esquerdo e direito. O analógico esquerdo também gera direcional.
Ajustável em Settings → Controller: 5%, 10%, 15% ou 20%.
Em Settings → Controller, o assistente percorre os 16 botões um a um (D-Pad, B, A, Y, X, L1, R1, Start, Select, L2, R2, L3, R3), mostrando na tela qual ele espera e a contagem [N/16]. Cada botão pressionado é atribuído e o assistente avança sozinho; ao terminar, grava a configuração. ESC cancela a qualquer momento.
⌨️ Teclado (Jogador 1)
As 12 teclas são remapeáveis em Settings → Controller (ou Define Buttons no menu em jogo). Enter na linha, aperte a tecla nova, pronto. Esc cancela.
| Botão | Tecla padrão | Chave no config |
|---|---|---|
| Cima | Seta ↑ | key_up |
| Baixo | Seta ↓ | key_down |
| Esquerda | Seta ← | key_left |
| Direita | Seta → | key_right |
| Botão B | Z | key_b |
| Botão A | X | key_a |
| Botão Y | A | key_y |
| Botão X | S | key_x |
| L (ombro) | Q | key_l |
| R (ombro) | W | key_r |
| Start | Enter | key_start |
| Select | Espaço | key_select |
- Esc e F12 não podem ser vinculados — são o que abre e fecha o menu. Vincular um deles deixaria você sem saída.
- Uma tecla já usada em outro botão é transferida, não duplicada. Dois botões na mesma tecla tornaria um deles impossível de apertar sozinho.
Tudo é gravado em Config/karamelo.cfg na hora. A linha “Restaurar” volta os 12 ao padrão.
🖱️ Mouse como caneta (Nintendo DS)
Segure o botão esquerdo sobre a tela de toque e o mouse vira a caneta. A posição é absoluta: o toque cai exatamente sob o cursor, seja qual for a proporção, o tamanho da janela ou as barras pretas.
Quando está ativo- Só com a janela em primeiro plano.
- Só com o OSD fechado — ali o mouse é do menu.
- Fora da imagem não conta como toque. Sem isso, a barra preta lateral valeria como a borda da tela e arrastaria a caneta para lá.
Opções por sistema
Aparecem no menu em jogo (F12) apenas quando o core correspondente está carregado.
🟦 Nintendo DS
As duas telas do DS lado a lado, empilhadas, invertidas, sozinhas ou em modo híbrido (uma grande e uma pequena no canto). Muda ao vivo, sem recarregar.
Distância entre as duas telas. O core aceita qualquer valor de 0 a 126; o menu oferece uma seleção porque passar de 1 em 1 por 127 valores é inviável.
Qual tela vai na janelinha do modo híbrido. Só aparece nos layouts híbridos.
🔵 Mega CD / Sega CD
Carrega a imagem inteira na RAM. Aceleração segura: não mexe em temporização, só elimina a busca no disco. Precisa recarregar o jogo.
O padrão “Real” emula a latência da leitora original, e é por isso que alguns jogos demoram. “Rápido” acelera muito, mas o próprio core avisa que alguns jogos travam se os dados do CD chegam cedo demais — por isso é escolha sua, não o padrão.
🟡 Master System
O chip de som FM que um punhado de jogos japoneses usa. O Genesis Plus GX sempre expôs isso; o frontend é que nunca oferecia.
🔴 NeoGeo
Console (AES), arcade (MVS) ou UniBIOS; tipo de leitora (CDZ, Top-Loading, Front-Loading); região; e cartão de memória plugado ou não.
As chaves de configuração da placa arcade, como no hardware real.
🟢 Nintendo 64
Três motores diferentes. O padrão não exporta a memória do console, então não rende conquistas — os outros dois rendem.
Escolhido conforme o modo de render: plugin OpenGL quando a aceleração 3D está ligada e disponível, rasterizador por software quando não. Entregar um plugin GL a uma máquina sem contexto trava o core.
🎮 PlayStation 2 (PS2)
Detecta a taxa nativa da placa de som do usuário via SDL_AudioStream em vez de forçar 48 kHz, eliminando reamostragem espúria. Inclui compensação de deriva com histerese inspirada no PCSX2 e fila adaptativa que aumenta a latência sozinha ao detectar underruns recorrentes, mantendo sincronia sem estalos — sem o bug antigo que travava a latência alta permanentemente.
A trava que elimina flutuações de pitch agora se recalibra a cada jogo ou core carregado, impedindo que a calibração de um jogo anterior cause dessincronia no seguinte durante a mesma sessão.
Ports & Recomp (Executáveis Nativos)
Uma categoria nova no menu principal, separada dos cores de emulação. São jogos clássicos que foram recompilados estaticamente (tecnologias como N64Recomp e ports de descompilação de fãs) para rodar como executáveis nativos de PC (Windows e Linux 64-bit), sem precisar de emulador. O app baixa, instala e já abre direto pelo menu.
Como funciona para o jogador (fluxo direto)
1. Menu principal: Navegue até a categoria “Ports & Recomp”. Cada título exibe [JOGAR] (se já baixado) ou [BAIXAR] (se ainda pendente).
2. Download em 1 tecla: Aperte Enter em [BAIXAR]. O app consulta a API do GitHub Releases (ou o servidor oficial do projeto, no caso do Foxhollow), baixa a versão mais recente dos binários, extrai na pasta correta e inicializa o jogo automaticamente — sem fechar o app nem mexer em diretório nenhum.
3. Varredura automática de ROMs: Para jogos que necessitam da ROM original para extrair assets (como na maioria dos ports de N64), o app busca sozinho na sua pasta roms/Nintendo64/ e copia para o lugar certo com segurança quando identifica o arquivo. Ports de GameCube (Melee Unlocked, Star Fox Adventures) leem o ISO do seu disco direto de roms/GameCube/, sem copiar.
4. Solicitação inteligente: Quando o nome do arquivo for genérico ou o port exigir imagem de outros consoles (PS1, PS2, PSP), o próprio port pede a imagem na primeira execução, exatamente no fluxo padrão de cada projeto.
O Karamelo Emulador NUNCA hospeda, baixa ou distribui ROMs, discos ou imagens proprietárias. O app baixa executáveis de código aberto ou de distribuição livre pública disponibilizados pelos próprios desenvolvedores de cada projeto (no GitHub ou, como no Foxhollow, no servidor oficial do projeto) (a esmagadora maioria open source; projetos específicos contam com licenças não-comerciais de terceiros). A posse legal da ROM ou mídia original para extração de assets permanece sendo de inteira responsabilidade do usuário, exatamente como já ocorre com os cores normais de emulação.
Catálogo de 61 jogos verificados
Todos os 61 jogos da tabela interna do app foram testados nesta versão (a imensa maioria já baixa pronta para rodar após a extração da ROM, enquanto títulos como Valkyrie Profile utilizam assistente próprio com compilação local a partir dos discos do jogador via Python 3, e Wave Race 64/Pokémon Snap contam com melhorias visuais ou Direct3D 12 no Windows). Destaques de 60 FPS cravados incluem Zelda 64 Recompiled, Castlevania: Symphony of the Night (SymphonyRecomp), SM64 CoopDX, Dr. Mario 64, Pokémon Stadium e Legend of Dragoon.
| Jogo | SO | Tecnologia / Plataforma | Status no Karamelo Emulador | Destaque Técnico |
|---|---|---|---|---|
| ⭐ Dr. Mario 64 (Recompiled 60 FPS) | 🪟 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela e 60 FPS confirmados. Execução nativa de altíssima fidelidade sem nenhum engasgo de emulador.🔗 Repositório |
| ⭐ Zelda 64: Recompiled — Majora's Mask | 🪟🐧🍎 | N64Recomp (Zelda64Recomp) (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela e 60 FPS confirmados. Widescreen nativo, alta taxa de quadros e suporte a controles analógicos modernos.🔗 Repositório |
| ⭐ Super Mario 64 Coop Deluxe (SM64 CoopDX) | 🪟🐧🍎 | PC Port Nativo (Nintendo 64 / PC) | ✅ Janela Confirmada (60 FPS) | Janela e 60 FPS confirmados. Modo cooperativo multiplayer nativo, física refinada e suporte a altas resoluções.🔗 Repositório |
| ⭐ Pokémon Stadium (Recompiled) | 🪟 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela e batalhas 3D confirmadas. Fluxo próprio com caixa de diálogo nativa do Windows solicitando a ROM correta na primeira vez.🔗 Repositório |
| ⭐ Legend of Dragoon: Severed Chains | 🪟 | Severed Chains Engine (PlayStation (PS1)) | ✅ Janela Confirmada (60 FPS) | Janela e 60 FPS confirmados. Baixa sozinho um runtime Java de ~190MB no primeiro boot e abre o clássico de 4 discos rodando a 60 FPS.🔗 Repositório |
| ⭐ Castlevania: Symphony of the Night (SymphonyRecomp) | 🪟 | PS1 Recomp / SymphonyRecomp (PlayStation (PS1)) | ✅ Janela Confirmada (60 FPS) | Janela e 60 FPS confirmados. Port nativo estático com áudio sem perdas, widescreen sem distorção e resposta imediata.🔗 Repositório |
| 🎮 Bomberman Hero | 🪟🐧🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada rodando em tela. Trilha sonora drum & bass sem cortes e taxa de quadros destravada.🔗 Repositório |
| 🎮 Zelda OoT — Ship of Harkinian | 🪟🐧🍎 | PC Port (Harbour Masters) (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Port nativo com câmera livre, gyro aiming, alta taxa de atualização e suporte a widescreen.🔗 Repositório |
| 🎮 Zelda MM — 2 Ship 2 Harkinian | 🪟🐧🍎 | PC Port (Harbour Masters) (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Suporte ultrawide, iluminação customizada e recursos modernos de acessibilidade.🔗 Repositório |
| 🎮 Star Fox (SNES, Enhanced) | 🪟🐧🍎 | SNES PC Port (Enhanced) (Super Nintendo) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Port nativo do Star Fox original de SNES (chip Super FX) em alta taxa e resolução — não confundir com Star Fox 64.🔗 Repositório |
| 🎮 Harvest Moon 64 (Recompiled) | 🪟🐧🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada rodando em tela. O clássico simulador de fazenda rodando como binário nativo x64.🔗 Repositório |
| 🎮 Snowboard Kids 2 (Recompiled) | 🪟🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada rodando em tela. Corridas velozes na neve e disputas multiplayer sem engasgos.🔗 Repositório |
| 🎮 Goemon 64 (Mystical Ninja) | 🪟🐧🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Clássico de aventura da Konami rodando como executável nativo do Windows x64.🔗 Repositório |
| 🎮 Dinosaur Planet | 🪟 | Native Executable Port (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. A lendária build da Rare compilada para rodar direto no PC.🔗 Repositório |
| 🎮 Banjo 64 (Banjo-Kazooie) | 🪟🐧🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Plataforma 3D preservada com taxa de quadros fluida e suporte a resoluções modernas. Tarball nativo com binário ELF x86_64 habilitou o Linux em 21/09/2026.🔗 Repositório |
| 🎮 Bomberman 64 | 🪟🐧🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Física de bombas e multiplayer clássico rodando sem quedas de quadros.🔗 Repositório |
| 🎮 Mega Man 64 | 🪟🐧🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Exploração 3D de Kattelox Island com áudio original e resposta rápida de controles.🔗 Repositório |
| 🎮 Star Fox 64 (Starship) | 🪟🐧 | PC Port Nativo (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Combate aéreo a 60 FPS nativos com suporte completo a comandos analógicos.🔗 Repositório |
| 🎮 Mario Kart 64 (SpaghettiKart) | 🪟🐧🍎 | PC Port Nativo (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Alta taxa de quadros e corridas multiplayer com tempo de resposta imediato.🔗 Repositório |
| 🎮 Super Mario 64 (Ghostship) | 🪟🐧🍎 | PC Port Nativo (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Renderização nativa Direct3D/OpenGL com suporte a texturas HD e widescreen.🔗 Repositório |
| 🎮 Perfect Dark | 🪟🍎 | PC Port Nativo (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. 60 FPS cravados em cenas pesadas com suporte a mouse e analógico duplo.🔗 Repositório |
| 🎮 Animal Crossing | 🪟 | GameCube Decomp (GameCube) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Executável nativo com simulação de relógio de tempo real.🔗 Repositório |
| 🎮 Banjo-Kazooie: Nuts & Bolts | 🪟 | Recomp Project (Xbox 360) | ✅ Janela Confirmada (60 FPS) | Janela confirmada via GitHub API. Recompilação estática de binários PowerPC.🔗 Repositório |
| 🎮 Chameleon Twist (versão japonesa) | 🪟 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Build da edição japonesa com física e dinâmica de língua intactas.🔗 Repositório |
| 🎮 Dragon Ball Z Budokai | 🪟 | PS2 PC Port (PlayStation 2) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Lutas em arena 3D compiladas para rodar nativamente no Windows.🔗 Repositório |
| 🎮 Infinite Mario 64 | 🪟🐧🍎 | SM64 PC Port Mod (Nintendo 64 / PC) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Geração procedural de mundos construída sobre a base de Mario 64.🔗 Repositório |
| 🎮 Jak & Daxter (OpenGOAL) | 🪟 | OpenGOAL Project (PlayStation 2) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Recompilação nativa avançada a partir do código descompilado GOAL.🔗 Repositório |
| 🎮 Quest 64 | 🪟 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. O RPG dos quatro elementos executando direto na CPU x64.🔗 Repositório |
| 🎮 REDRIVER 2 (Driver 2) | 🪟🐧 | REDRIVER 2 Engine (PlayStation (PS1)) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. 60 FPS, distância de visão estendida e suporte a resoluções ultrawide. Tarball nativo com executável Linux homologado em 21/09/2026.🔗 Repositório |
| 🎮 Sonic 1 Forever | 🪟 | Retro Engine Port (Mega Drive / PC) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Formato 16:9 nativo, movimentos modernos opcionais e áudio fiel.🔗 Repositório |
| 🎮 Sonic 3 A.I.R. (Angel Island Revisited) | 🪟🐧🍎 | Sonic 3 AIR Engine (Mega Drive / PC) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Executável nativo com física original e suporte a mods da comunidade. Tarball nativo com executável Linux homologado em 21/09/2026; no macOS, o .dmg Universal da release estável é montado e extraído pelo app.🔗 Repositório |
| 🎮 Sonic Unleashed Recompiled | 🪟 | Recomp Project (Xbox 360) | ✅ Janela Confirmada (60 FPS) | Janela confirmada via GitHub API. As fases diurnas do Hedgehog Engine compiladas para PC.🔗 Repositório |
| 🎮 Space Station Silicon Valley | 🪟🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. O clássico inventivo da DMA Design com bugs de hardware corrigidos.🔗 Repositório |
| 🎮 Super Mario Bros. Remastered | 🪟🐧 | Native C++ Engine (NES / PC) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Clássico 8-bit com rolagem suave a 60 FPS e resposta sem latência.🔗 Repositório |
| 🎮 Super Mario World (Recompiled) | 🪟🐧 | SNES Recomp (Super Nintendo) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Recompilação estática do processador 65C816 para binário x64 puro. Pacote .AppImage oficial, formato que o instalador passou a reconhecer em 21/09/2026.🔗 Repositório |
| 🎮 Super Metroid (Recompiled) | 🪟 | SNES Recomp (Super Nintendo) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Exploração de Zebes em executável nativo com tempo de resposta instantâneo. A release atual (v0.3.9) publica só build de Windows; as versões até a v0.3.8 tinham Linux e macOS.🔗 Repositório |
| 🎮 Viva Pinata: Trouble in Paradise | 🪟 | Recomp Project (Xbox 360) | ✅ Janela Confirmada (60 FPS) | Janela confirmada via GitHub. Executável nativo recompilado para Windows x64.🔗 Repositório |
| 🎮 WipEout Phantom Edition | 🪟 | WipEout PC Port (PlayStation (PS1)) | ✅ Janela Confirmada (60 FPS) | Janela confirmada. Corridas antigravitacionais em alta taxa de quadros e iluminação modernizada.🔗 Repositório |
| 🎮 OutRun (CannonBall DX) | 🪟 | CannonBall Engine Port (Arcade) (Arcade (MAME)) | ✅ Janela Confirmada (60 FPS) | Port nativo do motor CannonBall (não é uma recompilação) para o clássico arcade OutRun da Sega, já cadastrado como port oficial da lista principal e instalado automaticamente via Settings > Ports. Requer o romset outrun.zip do MAME: o app detecta e copia sozinho se o arquivo já estiver em roms/Arcade ou roms/MAME.🔗 Repositório |
| 🎮 Valkyrie Profile | 🪟🐧🍎 | PSXRecomp (PlayStation (PS1)) | ✅ Janela Confirmada (60 FPS) | Motor PSXRecomp (PolyForm Noncommercial). Requer Python 3 instalado no sistema: o pacote traz assistente que baixa a toolchain de compilação no 1º uso para gerar o executável a partir das imagens dos 2 discos originais fornecidos pelo jogador.🔗 Repositório |
| 🎮 Wave Race 64 (Recompiled) | 🪟🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS)🚧 Em Desenvolvimento | Em estágio beta (licença MIT). Pacote de download maior (~390MB) por embutir pacote de texturas HD e trilha sonora aprimorada. Pede a ROM .z64 original no primeiro boot.🔗 Repositório |
| 🎮 Pokémon Snap (Recompiled) | 🪟🐧🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Motor N64Recomp (GPL-3.0). Requer Direct3D 12 no Windows. Solicita a ROM original .z64 no primeiro boot. O build de Linux vem em .tar.gz, formato que o extrator do app passou a abrir, e a v1.1.0 trouxe o primeiro build Universal para macOS.🔗 Repositório |
| 🎮 Body Harvest (Recompiled) | 🪟🐧 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Motor N64Recomp da versão USA. Widescreen com HUD ancorado, interpolação de alta taxa de quadros e suporte completo a gamepads. O app copia a ROM automaticamente.🔗 Repositório |
| 🎮 Diddy Kong Racing (Recompiled) | 🪟🐧 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Motor N64Recomp com renderizador RT64. Widescreen, 60 FPS ou mais, multiplayer online e suporte nativo a controles. Pacote .AppImage oficial, formato que o instalador passou a reconhecer em 21/09/2026.🔗 Repositório |
| 🎮 Diablo (DevilutionX) | 🪟🐧🍎 | Native C++ Engine (PC (MS-DOS / Windows)) | ✅ Janela Confirmada (60 FPS) | Source port moderno de Diablo 1 e da expansão Hellfire. Builds nativas para Windows, Linux (.tar.xz) e macOS (.dmg universal, montado e extraído automaticamente pelo app). Resolução escalável, gamepads modernos e multiplayer. Requer os arquivos de dados do jogo original.🔗 Repositório |
| 🎮 Star Wars: Dark Forces (The Force Engine) | 🪟 | Native C++ Engine (PC (MS-DOS)) | ✅ Janela Confirmada (60 FPS) | Engine moderna substituta para o clássico Dark Forces da LucasArts. Renderização em alta resolução, mouse look e áudio aprimorado. Requer os arquivos de dados do jogo original.🔗 Repositório |
| 🎮 Fallout (Community Edition) | 🪟🐧🍎 | Native C++ Engine (PC (MS-DOS / Windows)) | ✅ Janela Confirmada (60 FPS) | Reimplementação open-source da engine do Fallout 1 original. Roda nativamente em Windows, Linux e macOS (Apple Silicon) com resoluções modernas e suporte a controles. Requer os arquivos de dados do jogo original.🔗 Repositório |
| 🎮 Pokémon Red & Blue (reblue) | 🪟🐧 | Recomp Project (Game Boy) | ✅ Janela Confirmada (60 FPS) | Recompilação nativa em C do clássico de Game Boy. Release v1.2.1 com executável nativo Windows x64. Pacote .AppImage oficial, formato que o instalador passou a reconhecer em 21/09/2026.🔗 Repositório |
| 🎮 Spider-Man (OpenSpidey) | 🪟 | PS1 Recomp (PlayStation (PS1)) | ✅ Janela Confirmada (60 FPS) | Recompilação nativa de Spider-Man 1 e 2 de PS1, com alta taxa de quadros e controles modernos no Windows.🔗 Repositório |
| 🎮 F-Zero X (Recompiled) | 🪟🍎 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Motor N64Recomp com builds nativas para Windows x64 e macOS Apple Silicon (ARM64). Timing NTSC aprimorado, independente da taxa de atualização da tela.🔗 Repositório |
| 🎮 AeroGauge (Recompiled) | 🪟🐧 | N64Recomp (Nintendo 64) | ✅ Janela Confirmada (60 FPS) | Motor N64Recomp com builds nativas para Windows e Linux. Renderização Vulkan, 60 FPS ou mais e assistência Easy Turbo.🔗 Repositório |
| 🎮 Crash Bandicoot (Native PC) | 🪟🐧 | Native Executable Port (PlayStation (PS1)) | ✅ Janela Confirmada (60 FPS) | Port nativo de Crash Bandicoot 1. Widescreen 16:9 real (sem esticar nem cortar geometria), 60/120/240 FPS ou destravado, e leitura de imagens .chd e .cue+.bin. Distribui executáveis avulsos, que o Karamelo instala direto na pasta do port.🔗 Repositório |
| 🎮 Super Mario Strikers (Native PC) | 🪟🐧🍎 | GameCube Decomp (Nintendo GameCube) | ✅ Janela Confirmada (60 FPS) | Port nativo completo de Super Mario Strikers / Mario Smash Football. Builds para Windows (.zip), Linux (.tar.gz) e macOS ARM64 (.tar.gz), com 60 FPS ou mais, widescreen e compilação de shaders em segundo plano.🔗 Repositório |
| 🎮 Pikmin (Open Nectar) | 🪟🐧 | GameCube Decomp (Nintendo GameCube) | ✅ Janela Confirmada (60 FPS) | Port nativo de Pikmin 1 para Windows e Linux. Texturas HD, modelos aprimorados e controles modernos por mouse ou gamepad.🔗 Repositório |
| 🎮 Soulcalibur II (Ring Out) | 🪟🐧 | GameCube Decomp (Nintendo GameCube) | ✅ Janela Confirmada (60 FPS) | Port nativo / recompilador de Soulcalibur II para Windows e Linux. Widescreen 16:9 real, netplay P2P e 60 FPS cravados.🔗 Repositório |
| 🎮 Super Smash Bros. Melee (Melee Unlocked) | 🪟 | GameCube Recomp (Nintendo GameCube) | ✅ Janela Confirmada🚧 Em Desenvolvimento | Recompilação estática do Melee NTSC 1.02, em beta (licença GPL-2.0). Direct3D 12 ou 11, FPS destravado com quadros intermediários reais, DLSS/DLAA, widescreen 16:9 e jogo online compatível com o netplay do Slippi (o port não é um produto do Slippi; online exige conta Slippi). Coloque o ISO NTSC 1.02 do seu próprio disco em roms/GameCube com "melee" no nome: o Karamelo lê o arquivo no lugar e ignora imagens 1.00, Training Mode ou 20XX.🔗 Repositório |
| 🎮 Monster Hunter Portable 3rd (Yakumo) | 🪟🐧🍎 | PSPRecomp (PlayStation Portable (PSP)) | ✅ Janela Confirmada🚧 Em Desenvolvimento | Recompilação estática do Monster Hunter Portable 3rd HD Ver., em alpha (licença MIT). Vulkan, SDL3, taxa de quadros destravada e multiplayer. O jogo oficial é em japonês (existe tradução para inglês feita por fãs). Na primeira abertura, o próprio Yakumo pede o ISO NPJB-40001 do seu jogo, o ISO de PSP que vem na versão HD do PS3: ISO de UMD comum (ULJM) e .cso são recusados. Pacote de ~220 MB.🔗 Repositório |
| 🎮 Star Fox Adventures (Foxhollow) | 🪟🐧🍎 | GameCube Decomp (Nintendo GameCube) | ✅ Janela Confirmada | Port nativo para PC feito a partir da decompilação do jogo (SFA-Decomp) e do renderizador Aurora, fiel ao original (licença CC0-1.0). Coloque o .iso ou .rvz do seu próprio disco em roms/GameCube com "fox" e "adventures" no nome: o Karamelo lê o arquivo no lugar, sem copiar. Aceita USA 1.0/1.1, Europa 1.0/1.1 e Japão 1.0. O download sai do servidor oficial do projeto (foxhollow.dev), não do GitHub. Build nativo Apple Silicon no macOS.🔗 Repositório |
| 🎮 Conker's Bad Fur Day (CBFD-Recompiled) | 🪟🐧🍎 | N64Recomp / RT64 (Nintendo 64) | ✅ Janela Confirmada | Port nativo para PC via recompilação estática com RT64, suporte a widescreen, 60 FPS, câmera livre e mira com giroscópio ou mouse. Coloque sua ROM americana (.z64) em roms/Nintendo64/: o Karamelo passa --rom e importa os assets na primeira vez, permitindo jogar direto. Suporta pacotes RT64 (.rtz) e GLideN64 (.htc). Builds nativos para Windows, Linux e macOS (Apple Silicon).🔗 Repositório |
| 🎮 Sly Cooper and the Thievius Raccoonus (ProjectCane) | 🪟🐧 | C++ Reverse Engineering (PlayStation 2) | ✅ Janela Confirmada🚧 Em Desenvolvimento | Port nativo para PC reconstruído em C++ via engenharia reversa da versão PS2 NTSC (SCUS-97198). Suporte a widescreen 16:9, 60+ FPS destravado, OpenGL e controles modernos. Se os assets ainda não foram extraídos, o Karamelo abre o File Extractor GUI (.NET 9) embutido para selecionar sua ISO de PS2. Disponível para Windows e Linux (Steam Deck).🔗 Repositório |
| 🎮 Castlevania: Legacy of Darkness (LodRecomp) | 🪟🐧🍎 | N64Recomp / RT64 (Nintendo 64) | ✅ Janela Confirmada | Port nativo para PC via recompilação estática com N64Recomp e RT64. 60 FPS, widescreen 16:9, controles modernos e áudio RSP nativo recompilado. Coloque sua ROM americana (.z64, ND4E) em roms/Nintendo64/ e jogue direto pelo menu do Karamelo. Builds nativos para Windows, Linux e macOS (Apple Silicon).🔗 Repositório |
Nota: Esta lista é viva e acompanha a evolução constante das comunidades de fãs. Alguns projetos são builds nightly ou experimentais dos desenvolvedores originais e podem sofrer melhorias a cada release.
Vídeo
💾 Save States com Slots e Horário
O menu in-game traz o seletor Slot de Save, que exibe < Slot N: DD/MM HH:MM > ou Vazio. As setas alternam os 10 slots (0 a 9) lendo a data e a hora reais de cada gravação. F2 salva e atualiza o rótulo na hora. O Gerenciador Slots lista os 10 de uma vez com tamanho em KB ou MB, data e hora, e permite salvar, carregar ou trocar de slot ali mesmo.
🖥️ Menu de Shaders CRT com Preview
Abrir CRT Shader com Enter ou A leva à tela Shaders CRT, que lista os 10 presets abaixo com uma descrição de cada um. O preset ativo aparece marcado com *, e navegar pela lista aplica o efeito na hora, com a imagem do jogo por trás — dá para comparar sem sair e voltar.
Os 10 modos de tela
Ordenados do mais suave para o mais forte. Os primeiros mexem só na intensidade da linha; os últimos simulam tipos diferentes de tela.
| # | Modo | O que faz |
|---|---|---|
| 1 | Off (Raw) | Pixel puro, sem nenhum tratamento. |
| 2 | Scanlines Leve | Linha quase imperceptível. O mais discreto dos que marcam presença. |
| 3 | CRT Suave (TV) | Linha suave mais borda arredondada. Suaviza sem dissolver o pixel art. |
| 4 | PVM Pro 600TVL | Linha nítida com o pixel absolutamente intacto. Monitor profissional. |
| 5 | Sony Trinitron | Grade de abertura, como a TV que dá nome ao modo. |
| 6 | Arcade Shadow | Máscara de sombra de monitor de fliperama. |
| 7 | Scanlines 50% | Linha sim, linha não, na intensidade máxima. |
| 8 | NTSC Composite | Sangramento de cor do sinal composto. |
| 9 | LCD Matrix | Grade de LCD, para o visual de tela portátil. |
| 10 | Tubo Curvado 3D | Curvatura de tubo com vinheta e borda de moldura. |
Outros ajustes de vídeo
Proporção da imagem dentro da janela.
Dá ao core um contexto de vídeo acelerado real — OpenGL, Vulkan ou DirectX 11, conforme o que o core pedir. É o que faz N64, Dreamcast e GameCube carregarem, e o motivo do Dreamcast (Flycast) agora rodar com aceleração de hardware de verdade via DirectX 11, algo que não existia antes. Fica opcional porque aceitar também tira o caminho por software que todo core usava antes.
Sincroniza a apresentação com o monitor.
“Taxa do jogo” roda na frequência original do console. “Taxa do monitor” encaixa na do seu display, o que elimina o repique de quadros quando as duas são próximas.
Buffer de áudio. O padrão é 32 ms.
RetroAchievements
Integração via rcheevos 12.4.0. Login por usuário e senha, token guardado localmente, e a lista de conquistas na tela pelo menu em jogo.
O RetroAchievements não reconhece este cliente — nos identificamos como Karamelo/2.0, que não é um emulador registrado lá. O servidor devolve uma entrada de aviso chamada “Warning: Unknown Emulator”. Não sabemos ainda se isso é apenas cosmético ou se impede os desbloqueios de valerem no seu perfil. O teste é ganhar uma conquista e conferir no site.
Carregar jogo pela linha de comando
O executável aceita o caminho de uma ROM como primeiro argumento. Serve para associação de arquivo e para arrastar-e-soltar.
Karamelo.exe "roms\PlayStation\Grand Theft Auto 2 (USA).chd"
Limitações conhecidas
O que não funciona, ou funciona pela metade. Sem rodeios.
Carrega até “Booting from disc” e falha dentro do Dolphin, numa thread dele. O core precisa de contexto OpenGL compartilhado entre threads; o backend atual entrega um contexto por vez. É trabalho arquitetural, não um ajuste.
As teclas e o mapa do controle valem para todos os cores. Não há perfil por console.
Os cores informam o que cada botão faz naquele jogo (SET_INPUT_DESCRIPTORS) e nós descartamos. Por isso não dá para mostrar “B = pular” por jogo.
Ver o aviso na seção de conquistas. Impacto real ainda não medido.
Karamelo é um projeto independente de software de emulação para computador. Não possui vínculo, afiliação, patrocínio ou aprovação de Alexey Melnikov (Sorgelig), do projeto MiSTer FPGA, ou de qualquer fabricante de consoles citado. As marcas registradas pertencem a seus respectivos proprietários.