Add EQL installer

docs/eqlegends.md

@@ -0,0 +1,98 @@
+# 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
+```