Cosmic Recomp v0.2.1-test.1 — gameplay callback hotfix

English | Português (Brasil)

v0.2.1-test.1 — gameplay callback fix and failure diagnostics

The missing 0x8210BB88 callback is restored from the user's original executable and registered by static code generation. It passed 8,192 instruction-oracle cases, actual native dispatch/callee execution on an isolated guest allocation and a 180-second game smoke test. Prior callback fixes remain checked at startup.

A separate first-boss death crash at target zero remains under investigation. Failure-only register and stack diagnostics are included for its next reproduction; this release does not claim that crash is fixed. See HOTFIX.md. Saves, graphics DLL and accumulated graphics optimizations are preserved. No new FPS gain is claimed.

Features retained from v0.2.0-test.1

• Standalone Full Emerald-style Dear ImGui/SDL/OpenGL launcher: Play, Settings, Quit and Start directly in game. The frontend exits before gameplay; the game still uses ReXGlue Direct3D 12.
• Choose an installation folder, import your supported ISO and find the actual save folder. Existing saves are preserved.
• VIDEO in the original OPTIONS menu: 720p/1080p/1440p/4K startup presets and internal 30/60 FPS caps. Default 30; 60 is experimental; uncapped disabled.
• Separate QUIT TO LAUNCHER near original QUIT, with confirmation and return even when direct-start is enabled.
• Optional GIF background support; the final recording is not included. No Mods, Players or extra achievements menu.
• English interface, English-first documentation with Portuguese sections, dependency origins, licenses, build instructions and explicit test limitations.

Validated with automated menu/controller and process-lifecycle tests, including spaces and accented folder names. Save/Continue was previously manually confirmed. The complete campaign and stable 60 FPS are not validated. The GPU DLL and retained graphics optimizations are unchanged. The runtime DLL contains the callback and failure-diagnostic changes described above; no new FPS gain is claimed.

Bring your own supported copy. The package contains no ISO, XEX, original game assets, generated game source or personal saves. Extract the whole ZIP, select your existing installation or import your ISO, and preserve user during updates. Do not mix runtime files between releases.

SDK source archive correction (fix1)

For rebuilding, use CosmicRecomp-test-0.2.1-sdk-source-fix1.zip and SHA256SUMS-v0.2.1-source-fix1.txt. This complete source snapshot supersedes the earlier SDK source archive, which omitted the project-owned direct-resolve shader bytecode header and retained a private research include. The corrected archive includes the exact existing shader bytes and prepare_sdk_source.py to relocate the bundled integration headers. Do not reapply the supplied SDK diff to this already-patched archive.

The revised diff was applied to pristine files from the pinned SDK commit; all 26 patched files matched the corrected source snapshot, and all 16 diagnostic include references resolved after relocation. A full clean-machine build remains unverified. Repository source correction: commit 63789de. The game ZIP and all previous published assets are unchanged; this is not a new gameplay build or performance claim.

---

v0.2.1-test.1 — correção de callback e diagnóstico de falha

O callback ausente 0x8210BB88 foi restaurado e registrado. Passou em 8.192 casos de comparação com as instruções originais, execução nativa real sobre memória isolada e teste de jogo de 180 segundos. As correções anteriores continuam verificadas na inicialização.

O crash separado ao morrer no primeiro chefe, com alvo zero, continua em investigação. Esta versão registra contexto/pilhas somente quando a falha ocorre para permitir sua reprodução e correção; não declara essa falha resolvida. Consulte HOTFIX.md. Saves, DLL da GPU e otimizações acumuladas foram preservados. Não há promessa de ganho novo de FPS.

Recursos mantidos da v0.2.0-test.1

Launcher separado no estilo Full Emerald, com Play, Settings, Quit e início direto; ele encerra antes do jogo. A instalação pode ficar na pasta escolhida, e Settings mostra o local dos saves. VIDEO fica em OPTIONS, com presets de 720p a 4K e limites internos de 30/60 FPS. O padrão é 30; 60 é experimental e ilimitado está desativado. QUIT TO LAUNCHER fica separado de QUIT e usa confirmação.

O fundo GIF opcional está preparado; a gravação final não acompanha o pacote. A interface está em inglês e a documentação tem seções em português. Testes automáticos cobriram menus, controle e ciclo de processos em pastas com espaços/acentos. Save/Continuar já foi confirmado manualmente. Campanha completa e 60 FPS estáveis continuam sem validação. O DLL da GPU e as otimizações gráficas não mudaram; o runtime inclui a correção de callback e o diagnóstico descritos acima. Não há promessa de ganho novo de FPS.

Forneça sua própria cópia suportada. Extraia o ZIP inteiro, selecione a instalação existente ou importe a ISO e preserve user. Não misture arquivos de runtime entre versões. Nenhum recurso original ou save pessoal é distribuído.

Correção do pacote de fontes do SDK (fix1)

Para recompilar, use CosmicRecomp-test-0.2.1-sdk-source-fix1.zip e SHA256SUMS-v0.2.1-source-fix1.txt. O pacote completo corrige um header de shader próprio ausente e um include privado, preservando os mesmos bytes do shader. O auxiliar prepare_sdk_source.py ajusta os includes aos headers fornecidos; o diff já está aplicado nesse arquivo.

O diff foi aplicado aos arquivos originais do commit fixado do SDK: os 26 arquivos coincidiram com o pacote corrigido e os 16 includes de diagnóstico foram resolvidos após o ajuste. Uma compilação completa em máquina limpa continua sem verificação. A correção do repositório está no commit 63789de. O ZIP do jogo e os arquivos anteriormente publicados permanecem iguais; não é uma nova build de gameplay nem um ganho de desempenho.