# 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)

## BepInEx
- Author: BepInEx contributors
- Source: https://github.com/BepInEx/BepInEx
- License: LGPL-2.1
- Files: `vendor/BepInEx_win_x64_5.4.23.5.zip` (redistributed unmodified)
- Used by Unity games (e.g. Burglin' Gnomes) to load the C# fix plugin.

## UnityExplorer (development only)
- Author: sinai-dev
- Source: https://github.com/sinai-dev/UnityExplorer
- License: GPL-3.0
- Files: `vendor/UnityExplorer.BepInEx5.Mono.zip`
- Used only for runtime inspection while developing a fix; it is NOT part of any
  release package and is not required by end users.

## ClairObscurFix  (the entire Expedition 33 fix)
- Author: **Lyall** — https://github.com/Lyall/ClairObscurFix
- License: MIT (see `vendor/ClairObscurFix/LICENSE`)
- Files: `vendor/ClairObscurFix/**` — vendored **unmodified**
- Version: v0.0.10 (upstream repo is archived)
- The ultrawide fix for Clair Obscur: Expedition 33 is entirely Lyall's work.
  This repo contributes only a 32:9-tuned `ClairObscurFix.ini` and packaging.

## 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.