# Azahar 2126.0 — Azahar 2126.0

- Product: Azahar (https://whatsnew.fyi/product/azahar)
- Vendor: Azahar
- Date: 2026-08-10
- Version: 2126.0
- Original notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0
- Permalink: https://whatsnew.fyi/product/azahar/releases/2126.0
- Labels: Platforms: Desktop, Android

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **changed** — Improved GPU interrupt queue and GPU timing emulation with a new experimental feature that can be toggled in graphics settings as 'Simulate 3DS GPU timings'
- **changed** — Completely revamped the implementation of GDB functionality with numerous debugging improvements and new debugging features
- **changed** — Refactored how filesystem access is handled for special files in preparation for future changes
- **fixed** — Fixed compressed 3DSX files with an embedded RomFS failing to load properly
- **fixed** — Fixed an issue where screenshots could have their colour channels swapped on certain platforms and system configurations
- **added** — Added a setting to skip presenting duplicate frames, which is enabled by default
- **added** — Added a new option to toggle whether the emulated 3DS system thinks headphones are plugged in
- **changed** — In multiplayer rooms, users' usernames are now pulled directly from the username set in the System tab instead of being a separate option
- **fixed** — Fixed a crash which could occur when an application submits a vertex array with an invalid base address
- **changed** — Adjusted rom loading error messages to be more easily understandable and user-friendly
- **changed** — LG2/EX2 subroutine functions are now only emitted for shaders when necessary, reducing memory usage
- **fixed** — Fixed an issue where certain older homebrew software would get stuck on a black screen at boot
- **changed** — Migrated many non-English language translations to simplified language codes for more consistent system language detection
- **fixed** — Fixed an issue related to disabled cubemap texture units
- **fixed** — Adjusted the unimplemented gas stub behaviour for the Vulkan renderer, fixing a graphical issue in Monster Hunter games
- **fixed** — Fixed a possible integer overflow issue relating to custom Luma3DS mapping
- **added** — Implemented APT:MapProgramIdForDebug
- **fixed** — Fixed handling of APT communication between applications
- **fixed** — Fixed behaviour of HTTPC:GetRequestState when the request still has pending post data
- **added** — Added an API to allow applications to register and unregister URL replacements

###### Known Issue Notice

There is a minor known issue in the new MXE build for Windows where frame pacing may be slightly inconsistent. A potential fix for this issue has already been implemented, but requires additional testing. This fix will be included in the 2126.1 update.

**Most users likely won't notice this issue**, so use of the MXE build is still encouraged.
The MXE build will replace the MSYS2 build in 2127.0.

Thank you for your understanding.

---

#### Azahar 2126.0 Changelog

#### All
- Improved GPU interrupt queue & GPU timing emulation. This feature is highly experimental and is disabled by default, the toggle for it can be found in the graphics settings: "Simulate 3DS GPU timings". | @PabloMK7 #2095, #2145
  - This change improves emulation accuracy by more closely mirroring the behaviour of real hardware.
    - This PR is known to fix GPU timing issues in Luigi's Mansion 2: Dark Moon, which is now made playable without use of the "delay render thread" option, but likely impacts many other games as well.
  - This PR also introduces a fix for an issue in Super Mario 3D Land which would prevent users from loading a save file after completing the game.
  - This is a big change behind the scenes, and may inadvertently introduce issues due to its large scope. Please report any issues which may have been introduced by the new behaviour.
  - Games that use dynamic FPS and don't reach 60 FPS on real hardware will also not reach 60 FPS on Azahar with this feature enabled.
  - The PR description contains an in-depth technical explanation of the changes.
- Completely revamped the implementation of GDB functionality, with numerous debugging improvements and new debugging features. | @PabloMK7 #2086 
  - The PR description for this change goes into extensive detail about the changes, so read there for more information if curious.
- Refactored how filesystem access is handled for special files (such as Z3DS files), in preparation for changes coming in Azahar 2127. | @PabloMK7 #2352
    - Fixes compressed 3DSX files (`.z3dsx`) with an embedded RomFS failing to load properly. 
    - Users should not expect any visible changes as this is only an internal restructuring of the code. If that is not the case please consider [filing a bug report](https://github.com/azahar-emu/azahar/issues).
    - **NOTE: Due to internal changes on how system files are stored, system files set up on Azahar 2126 or newer will become incompatible with older Azahar versions. On the other hand, system files set up on versions older than Azahar 2126 will remain backwards compatible for the foreseeable future**.
    - More details on why this change is neccessary can be found in the pull request.
- Fixed an issue where screenshots produced by Azahar could have their colour channels swapped on certain platforms and system configurations. | @mal-cap #2170
- Added a setting to skip presenting duplicate frames, which is enabled by default. | @KojoZero #1867
  - This makes frame generation software work properly with Azahar. 
- Added a new option which allows users to toggle whether the emulated 3DS system thinks headphones are plugged in. | @PabloMK7 #2099 
  - A very small number of games have altered behaviour when using wired headphones. For example, when headphones are plugged in while playing Super Mario 3D Land, the audio playback is slightly altered.
- In multiplayer rooms, users' usernames are now pulled directly from the username set in the System tab in Azahar's settings instead of being a separate option.
- Fixed a crash which could occur when an application submits a vertex array with an invalid base address. | @PabloMK7 #2299
  - Known to fix a crash in the credits of Mario & Luigi: Superstar Saga. May fix other problems elsewhere.
- Adjusted rom loading error messages displayed to users to be more easily understandable and user-friendly. | @PabloMK7 #2097 
- LG2/EX2 subroutine functions are now only emitt

_[Truncated at 4000 characters — full notes: https://github.com/azahar-emu/azahar/releases/tag/2126.0]_