# EverQuest Legends on NixOS via Wine

EverQuest Legends is distributed as a standalone Daybreak/LaunchPad installer, not through Steam. The flake provides an `eqlegends` app that creates a mutable Wine prefix and installs the launcher from `EQLegends_setup.exe`.

The installer in this repository is a Nullsoft/NSIS installer containing `LaunchPad.exe`, CEF libraries, and `LaunchPad.ini` with `appName=EverQuest Legends` and `id=eqns`. The game data itself is expected to be downloaded later by LaunchPad.

## Quick start

From the repository directory containing `EQLegends_setup.exe`:

```bash
nix run .#eqlegends
```

Or point the wrapper at the installer explicitly:

```bash
EQL_INSTALLER=/path/to/EQLegends_setup.exe nix run .#eqlegends
```

The Wine prefix lives at:

```text
~/.local/share/eqlegends/wine
```

The wrapper installs LaunchPad to:

```text
C:\Games\EverQuestLegends
```

inside that Wine prefix.

## Useful environment variables

| Variable | Use |
|----------|-----|
| `EQL_INSTALLER=/path/to/EQLegends_setup.exe` | Use an installer outside the current working directory. |
| `EQL_WINEPREFIX=/path/to/prefix` | Override the default Wine prefix location. |
| `EQL_RESET_PREFIX=1` | Delete and recreate the prefix before launching. |
| `EQL_DXVK=1` | Install DXVK DLLs into the prefix before launching. |
| `EQL_WINEDEBUG=+seh,+tid` | Override Wine debug logging. Defaults to `-all`. |

There is also a reset helper:

```bash
nix run .#eqlegends-reset-prefix
```

If the flake app is installed into a profile, the helper is available as:

```bash
eqlegends-reset-prefix
```

## DXVK

The wrapper defaults to WineD3D. Run with DXVK only if the game client needs it or performs better with Vulkan translation:

```bash
EQL_DXVK=1 nix run .#eqlegends
```

DXVK is copied into the prefix, so switching back to WineD3D requires a prefix reset:

```bash
EQL_RESET_PREFIX=1 nix run .#eqlegends
```

## Troubleshooting

If the installer cannot be found, run from the repository root or set `EQL_INSTALLER`.

If LaunchPad installs somewhere unexpected, inspect:

```bash
find ~/.local/share/eqlegends/wine/drive_c -iname LaunchPad.exe
```

The wrapper records the executable it launches in:

```text
~/.local/share/eqlegends/wine/.eqlegends-launcher-path
```

If the launcher opens but renders as a blank CEF window, try a clean prefix first, then try DXVK:

```bash
EQL_RESET_PREFIX=1 nix run .#eqlegends
EQL_DXVK=1 nix run .#eqlegends
```

For verbose Wine logs:

```bash
EQL_WINEDEBUG=+seh,+tid,+loaddll nix run .#eqlegends
```