# Clair Obscur: Expedition 33 — UltraWide

⚠️ **Awaiting first-launch verification at 5120×1440.**

- **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
```

## Status / open questions

The game has an official ultrawide fix as of patch **1.2.3**, so some of this may be redundant. Unverified at 32:9:

- [ ] Does it launch correctly under Proton at 5120×1440?
- [ ] Is `Center HUD` at 16:9 right, or is 21:9 better?
- [ ] Any remaining pillarboxing in cutscenes or pre-rendered movies?
- [ ] Is the camera FOV Hor+ (see more) or Vert- (zoomed)?

If a gap remains that ClairObscurFix doesn't cover, *that* is where this repo would add its own patch.
