Files
UltraWidePatches/games/Expedition33/README.md
T
ckochandClaude Opus 4.8 6f24502956 Expedition 33: record version drift honestly, ship reduced profile
Running ClairObscurFix v0.0.10 with upstream defaults crashed on save load.
Removing it entirely let the game load normally, isolating the fix as the cause
rather than Proton or the year-old save. The fix is archived and predates the
current build; two pattern scans already failed outright, and the crash
coincides with its Level Load hook.

Ship a reduced profile with only Center HUD enabled - the one option actually
needed at 32:9 - and mark the game PARTIAL rather than implying full support.
Adds a revalidation checklist since vendored archived fixes decay as the game
patches, plus a note that the game has no DRM, so a dedicated HUD-centering
patch is a viable replacement if Center HUD eventually breaks too.

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

102 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Clair Obscur: Expedition 33 — UltraWide
⚠️ **Partial support — reduced feature profile.** ClairObscurFix v0.0.10 is archived and predates the current game build; running it with upstream defaults **crashed on save load**. This repo ships a reduced profile with only the 32:9 HUD centering enabled.
- **Engine:** Unreal Engine 5 — **no DRM** (no SteamStub; `.text` entropy 6.74)
- **Steam AppID:** 1903340
- **Executable:** `SandFall-Win64-Shipping.exe`
- **Method:** `external` — vendored third-party fix + our 32:9 config
## We did not write this fix
The ultrawide work here is **[ClairObscurFix](https://github.com/Lyall/ClairObscurFix) by [Lyall](https://github.com/Lyall)** (MIT), vendored unmodified. It is mature and already handles the hard parts; reimplementing it would be duplicated effort for no benefit. **All credit for the fix itself goes to Lyall.**
What this repo adds is the **32:9 configuration** verified on a Samsung 49" G93SC, packaging, and a one-command installer consistent with the other games here.
> The upstream repo is **archived**, so it will not receive further updates. Vendoring it here means the version you need stays available.
## Install (Linux / Proton)
```bash
./install.sh Expedition33
```
Then **required** — Steam → Properties → Launch Options:
```
WINEDLLOVERRIDES="dsound=n,b" %command%
```
Set **5120×1440** fullscreen in-game.
## Install (Windows)
Extract the release zip into `…\Expedition 33\Sandfall\Binaries\Win64\`.
## Our 32:9 config
`ClairObscurFix.ini` ships with upstream defaults **except**:
| Option | Upstream | Ours | Why |
|---|---|---|---|
| `[Center HUD] Enabled` | `false` | **`true`** | At 5120px wide, HUD elements anchored to screen edges end up absurdly far apart |
Everything else is left at upstream defaults, which are already ultrawide-friendly:
| Option | Default | Effect |
|---|---|---|
| `Cutscene Letterboxing` | `false` | No bars in cutscenes |
| `Fix Movies` | `true` | Crops letterboxing from pre-rendered video |
| `Adjust Resolution Checks` | `true` | Uses the monitor's max resolution rather than "native" |
| `Uncap Cutscene FPS` | `true` | Removes the 30fps cutscene cap |
### Tuning
Edit `…/Sandfall/Binaries/Win64/ClairObscurFix.ini` (requires a restart — this fix has no live reload):
- **HUD too cramped?** Raise `[Center HUD] AspectRatio` from `1.77778` (16:9) to `2.33333` (21:9) — usually the sweet spot at 32:9.
- **Prefer the HUD spanning the full width?** Set `[Center HUD] Enabled = false`.
- **Want cinematic bars back?** `[Cutscene Letterboxing] Enabled = true`.
## Uninstall
```bash
./install.sh Expedition33 uninstall
```
## Known issue: version drift
**ClairObscurFix v0.0.10 (May 2025) is archived and no longer tracks the game.**
Observed on a current build (2026-07-21), with upstream defaults:
```
[error] Resolution Checks: Pattern scan failed.
[error] Resolution Scale Bug: Pattern scan failed.
```
…followed by a **crash when loading a save**. Removing the fix entirely made the
game load normally, isolating the fix as the cause. The crash coincides with the
fix's `Level Load` hook, which is consistent with a hook attaching to shifted
code in a newer binary.
**Mitigation:** ship a reduced profile — everything disabled except `Center HUD`,
the only option genuinely needed at 32:9. The failing scans are disabled outright
since they were already inert.
## Maintenance / revalidation
Because upstream is archived, this entry decays as the game patches. Re-check
after any significant game update:
1. Launch and load a save. If it crashes, remove the fix (`./install.sh Expedition33 uninstall`) and retry to confirm the fix is the cause rather than the game or Proton.
2. Read `Sandfall/Binaries/Win64/ClairObscurFix.log``Pattern scan failed` lines mark hooks that no longer match the binary.
3. Disable any newly-failing feature in `ClairObscurFix.ini`; a failed scan is inert, but a *wrongly-attached* hook is what crashes.
4. If `Center HUD` itself stops working, this entry should be marked unsupported. The game has **no DRM**, so writing a small dedicated HUD-centering patch is a viable replacement.
## Still unverified at 32:9
- [ ] Is `Center HUD` at 16:9 right, or is 21:9 (`2.33333`) better?
- [ ] Camera FOV — Hor+ (see more) or Vert- (zoomed)?
- [ ] Pillarboxing in cutscenes / pre-rendered movies (`Fix Movies` currently **off**)