ckochandClaude Opus 4.8 dc28d60392 Gundam Breaker 4 UltraWide Fix v1.0.0
32:9 / 21:9 ultrawide support for Gundam Breaker 4 (UE4.27) via SUWSF +
Ultimate ASI Loader. Forces Hor+ FOV (AspectRatioAxisConstraint=MaintainYFOV)
and disables pillarboxing, patched in decrypted memory at runtime so it holds
through missions (the exe is SteamStub-encrypted; a static patch is impossible).

Confirmed working in gameplay at 5120x1440 (Samsung Odyssey G93SC) on Proton.
Requires WINEDLLOVERRIDES="dsound=n,b" on Proton so the loader injects.

Includes: patch/SUWSF.ini, Proton installer with clean uninstall, release-zip
builder, and runtime dump/verify tooling. Third-party bundles under MIT (see
THIRD_PARTY.md).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-20 20:21:23 -04:00
2026-07-20 20:21:23 -04:00

Gundam Breaker 4 — UltraWide Fix

UltraWide (32:9) fix for Gundam Breaker 4 on PC, targeting the Samsung 49" Odyssey G93SC (5120×1440). Works on Linux/Proton and Windows.

What it fixes

At 32:9 the game keeps a fixed horizontal FOV, so a wider display just zooms the camera in instead of showing more. This forces the camera to keep vertical FOV constant and expand horizontally (Hor+), and disables the pillarbox/letterbox clamp — the correct ultrawide behavior.

How it works (and why it has to work this way)

  • GB4 is Unreal Engine 4.27. The classic fix is to set AspectRatioAxisConstraint = MaintainYFOV, but doing it in Engine.ini reverts once a mission loads — the game re-sets the camera constraint per view at runtime.
  • The shipping exe (GB4-Win64-Shipping.exe) is wrapped in SteamStub DRM: .text is encrypted on disk (entropy 8.0), so a static hex patch of the file is impossible. The real code only exists decrypted in memory.
  • So the fix is a runtime memory patch via SUWSF (Somewhat Universal Widescreen Fix) loaded by Ultimate ASI Loader. SUWSF scans the decrypted image at launch and rewrites the instruction that selects the FOV axis — surviving into missions.

Install (Linux / Proton)

./install.sh

This drops SUWSF.asi, dsound.dll (ASI loader), and SUWSF.ini next to the shipping exe, and adds the MaintainYFOV tweak to the Proton-prefix Engine.ini (fixes menus/lobby instantly; SUWSF covers missions). It never modifies the exe or any game file and keeps an Engine.ini.bak-bg4uw backup.

REQUIRED on Proton — add this to GB4's Steam → Properties → Launch Options, or the ASI loader is ignored and the fix only works in the lobby:

WINEDLLOVERRIDES="dsound=n,b" %command%

Then set the in-game resolution to 5120×1440 fullscreen. (If dsound ever collides, LOADER_NAME=version.dll ./install.sh with version=n,b works too.)

Confirmed working in gameplay at 5120×1440 (32:9) on Proton — Hor+ FOV holds through missions.

Install (Windows)

Extract dist/GB4_UltraWide_Fix.zip into ...\GB4\Binaries\Win64\ (next to GB4-Win64-Shipping.exe).

Uninstall

./install.sh uninstall

Status & the one open step

The byte patterns in patch/SUWSF.ini are candidate UE4 patterns proven on other UE4 titles (Trepang2, Lies of P). Because the DRM encrypts the exe, they can only be verified against GB4's decrypted memory at runtime. If they hit (likely — same engine family), you're done. If a patch reports no change:

# with the game running at the main menu:
python3 tools/dump_decrypted.py     # dumps decrypted image via /proc/<pid>/mem
python3 tools/aob.py                # reports which patterns matched (OK / MISS / MANY)

Send me the aob.py output and I'll derive GB4's exact pattern from the dump.

Layout

Path What
patch/SUWSF.ini The ultrawide patch definitions (HOR+, pillarbox, fallbacks)
install.sh Proton/Linux installer + uninstaller
tools/dump_decrypted.py Dumps the decrypted exe image from the running process
tools/aob.py Verifies/derives AOB patterns against a dump
tools/find_projfunc.py Static fingerprint scan (confirmed the DRM encryption)
dist/GB4_UltraWide_Fix.zip Drop-in bundle for manual/Windows install
vendor/SUWSF-x64/ Upstream SUWSF 2.3.0 + Ultimate ASI Loader

Credits

SUWSF by PhantomGamers · Ultimate ASI Loader by ThirteenAG · AspectRatioAxisConstraint / pillarbox patterns adapted from Lyall's UltrawidePatches.

S
Description
No description provided
Readme MIT
5.9 MiB
v1.2.0
Latest
2026-07-21 17:35:37 -04:00
Languages
C# 40.5%
Shell 34.4%
Python 25.1%