[GingerSnaps258]

• [X ] I have read and followed the Contribution Guidelines.
• [ X] I have read and followed the AI Policy.
• [X ] I have read and followed the Coding Guidelines to the best of my ability.
• I have put [HUMANMADE] in the title if the pr was human-made

---

Summary

Compute shaders disabled via the debug server (reject_shaders)
remained inactive after being restored until the emulator was
restarted. In The Legend of Zelda: Ocarina of Time, this left
the 3D viewport completely black.

This happened because KeplerCompute maintains its own cache of
programs that failed to execute (rejected_compute_programs), which
was never invalidated when shaders were re-enabled.

Update the debug-control logic to track a restore counter, and
have KeplerCompute clear its rejected program list whenever that
count increments. This only affects debugging tools and not normal play.

Assisted-by: Claude Opus 5.5 (traced the rejected program cache and wrote the restore counter fix)

Type of change

• [x ] Bug fix
• Game compatibility / game-support
• Performance
• New feature
• Refactor / cleanup
• CI / build
• Documentation

Related issues

None

Testing

• [x ] Tested on Windows
• Tested on Linux
• Tested on macOS
• Tested on NVIDIA
• Tested on AMD
• [x ] Tested on Intel

Games tested:

Ocarina of Time, gameplay in Kokiri Forest
Hardware: MSI Claw 8+ AI, Intel Arc 140V, driver 101.9175, Windows

Test: rejected the gameplay network’s main pass (da6df3e54c716df2) through the debug server, then restored it

Result: rejected → 3D view black (only hearts and minimap drawn); restored → normal again within ~2 s, no restart; nothing left rejected afterwards

Without the fix: the view stays black after restore until the emulator restarts

Checklist

• [x ] I built it locally and it compiles without new warnings
• [x ] I did not add any copyrighted game data, keys or firmware
• [x ] Docs updated if needed. (not needed)
• [x ] I added AI Disclosure if one was used

Screenshots / logs

Summary by CodeRabbit

• New Features
  • Added an optional local MCP server for emulator status, game control, input, screenshots, performance monitoring, debugging, and other tools.
  • Added graphics and performance options, including DLSS quality, mesh shaders, CPU-core preferences, and configurable memory hints.
  • Added recommended settings for more games and built-in patches for Ocarina of Time.
• Improvements
  • Improved graphics compatibility, including support for systems without native mesh shaders.
  • New Android usernames are validated for length and UTF-8 encoding.

[github-actions]

Retargeted to nx2-experimental for pre-build testing. It will be promoted to nx2 after validation.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: 946b19dc-3776-488a-8e37-ed802dc8ce6a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• Trigger review

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

[kraibse]

Thanks — the analysis is right and the fix is minimal. rejected_compute_programs is the third rejection cache (ShaderCache::RefreshDebugRejections clears rejected_native and dropscached programs, but nothing clears the per-address compute failure records), and it's only bypassed while Nx2Diag::Active(), which is why the viewport stayed black with diagnosticsoff. Confirmed nothing else in video_core caches compute rejection, so this closes the symptom.

[kraibse]

Just built and tested the build to see if there are any consequences on an unaffected device. Doesn't seem to be the case. This fix is deeply necessary as people are still having black screens but can see the UI. Another affected game would be FEFW.

Confirmed and merging.