Files

T

ckochandClaude Opus 4.8 5d6fd277c9 Restructure into multi-game UltraWidePatches umbrella

Generalize the project from a single GB4 fix into a collection that can host
ultrawide patches for many games.

- games/<Game>/{SUWSF.ini,game.conf,README.md}; GB4 moved in as the first entry
- game.conf carries all game-specific data (appid, exe, paths, loader, launch
  option), so install.sh is fully generic: ./install.sh <Game> [uninstall]
- installer gains GAME_DIR / PREFIX_INI_FILE / LOADER_NAME overrides; verified
  install -> idempotent re-run -> uninstall leaves the tree pristine
- tools de-hardcoded: dump_decrypted.py takes an exe name, read_protonlog.sh
  takes an appid, aob.py takes a dump + game ini, build_release.sh takes a game
- README rewritten as an umbrella index with an "adding a game" guide
- LICENSE copyright -> programmingPug

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-21 11:21:20 -04:00

2.0 KiB

Raw Blame History

Gundam Breaker 4 — UltraWide Fix

✅ Confirmed working in gameplay at 5120×1440 (32:9) on Proton.

Forces Hor+ FOV so an ultrawide display shows more of the battlefield instead of zooming the camera in, and disables pillarboxing.

Engine: Unreal Engine 4.27
Steam AppID: 1672500
Executable: GB4-Win64-Shipping.exe (SteamStub-encrypted → runtime patch required)

Install (Linux / Proton)

./install.sh GundamBreaker4

Then required — Steam → right-click Gundam Breaker 4 → Properties → Launch Options:

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

Without it, Proton ignores the native dsound.dll and the fix appears to work only in the lobby (that part is the Engine.ini tweak) while reverting in missions.

Finally, set the in-game resolution to 5120×1440, fullscreen.

Install (Windows)

Extract the release zip into …\GB4\Binaries\Win64\ (next to GB4-Win64-Shipping.exe). No launch option needed.

Uninstall

./install.sh GundamBreaker4 uninstall

What it patches

Patch	Effect
`AspectRatioAxisConstraint`	Forces `MaintainYFOV` (0) → Hor+ FOV. Do not use at 16:9 or narrower.
`ConstrainAspectRatio`	NOPs the pillarbox/letterbox clamp
`HardcodedAspect_16by9_*`	Optional fallbacks, disabled by default

The patterns are UE4-generic (adapted from Trepang2 / Lies of P in Lyall's UltrawidePatches) and matched GB4's 4.27 code as-is.

Troubleshooting

Add PROTON_LOG=1 to the launch options, relaunch, then:

./tools/read_protonlog.sh 1672500

That reports whether the ASI injected and how many matches each pattern found. If a pattern shows No pattern found, derive the exact bytes:

python3 tools/dump_decrypted.py GB4-Win64-Shipping.exe   # while the game runs
python3 tools/aob.py <dump> games/GundamBreaker4/SUWSF.ini

Known / not yet verified

HUD/UI scaling and cutscene framing at 32:9 have not been formally checked.

2.0 KiB Raw Blame History Unescape Escape