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>
30 lines
1.2 KiB
Markdown
30 lines
1.2 KiB
Markdown
# Third-Party Components
|
|
|
|
This project bundles the following components, redistributed under their
|
|
respective licenses. This ultrawide fix is a configuration + installer around
|
|
them; all runtime patching is performed by SUWSF.
|
|
|
|
## SUWSF (Somewhat Universal Widescreen Fix)
|
|
- Author: PhantomGamers
|
|
- Source: https://github.com/PhantomGamers/SUWSF
|
|
- License: MIT (see `vendor/SUWSF-x64/LICENSE`)
|
|
- Files: `vendor/SUWSF-x64/SUWSF.asi`
|
|
- Version bundled: 2.3.0
|
|
|
|
## Ultimate ASI Loader
|
|
- Author: ThirteenAG
|
|
- Source: https://github.com/ThirteenAG/Ultimate-ASI-Loader
|
|
- License: MIT
|
|
- Files: `vendor/SUWSF-x64/dsound.dll` (renamed proxy; adapts by filename)
|
|
|
|
## Patch patterns
|
|
The `AspectRatioAxisConstraint` (HOR+) and `ConstrainAspectRatio` (pillarbox)
|
|
byte patterns in `games/*/SUWSF.ini` are adapted from the UE4 fixes in
|
|
[Lyall's UltrawidePatches](https://codeberg.org/Lyall/UltrawidePatches)
|
|
(notably Trepang2 and Lies of P), which are provided for community use with SUWSF.
|
|
|
|
## Note
|
|
This project does not modify, crack, or circumvent any game copy protection.
|
|
SUWSF applies runtime aspect-ratio/FOV adjustments in memory for the benefit of
|
|
owners playing on ultrawide displays. You must own the game.
|