ESO Linux Wine/Proton setup

Repository per installare, aggiornare e avviare The Elder Scrolls Online su Arch/Garuda Linux usando un prefisso Wine pulito, comprensivo di gestore addon Minion.

Il setup separa due operazioni:

• Launcher/update ESO tramite Wine di sistema.
• Gioco (eso64.exe) avviato direttamente con GE-Proton tramite umu-run.
• Gestione AddOns tramite Minion Flatpak nativo Linux; non usa Wine/Proton, ma punta alla cartella AddOns usata da ESO.

Questa separazione è intenzionale: il launcher viene usato solo per installare e aggiornare, mentre il gioco viene avviato direttamente dallo script dedicato, mentre Minion gira nativamente.

Sommario

• Guida di installazione
  • Installazione base
  • Installazione Minion
• Troubleshooting
  • Timeout del launcher
  • Crash premendo PLAY dal launcher
  • Client obsoleto
  • GE-Proton non trovato
  • Wine Mono
  • Video iniziali ancora visibili
  • Minion non trova gli AddOns
  • Log
• Altro
  • Schema operativo
  • Percorsi generati
  • Variabili ambiente
  • Note

Guida di installazione

Installazione base

1. Installare le dipendenze

Su Arch-based:

sudo pacman -S --needed wine winetricks umu-launcher curl unzip rsync desktop-file-utils

Serve anche GE-Proton, installato di norma in:

~/.local/share/Steam/compatibilitytools.d/

Lo script cerca automaticamente l'ultima directory GE-Proton*.

2. Clonare il repository

git clone git@github.com:DavideFasolo/Elder-Scrolls-Online---Arh-linux-setup.git eso-linux-wine-proton-setup
cd eso-linux-wine-proton-setup

3. Eseguire il setup

./setup-eso.sh

Lo script:

• crea un prefisso Wine pulito;
• scarica il launcher ufficiale ESO;
• verifica lo SHA256 del pacchetto launcher;
• installa il launcher nel prefisso;
• installa runtime utili tramite winetricks;
• genera gli script di avvio;
• genera i file .desktop.

4. Installare o aggiornare ESO

Avvia il launcher:

~/scripts/games/eso-launcher-update.sh

Nel launcher premi Install o lascia completare l'aggiornamento.

Quando il launcher mostra PLAY, chiudilo.

Non avviare il gioco dal pulsante PLAY del launcher.

5. Avviare il gioco

Avvia direttamente il client:

~/scripts/games/eso-play.sh

Lo script cerca eso64.exe dentro il prefisso e lo avvia con GE-Proton tramite umu-run.

Lo script imposta anche:

SET SkipPregameVideos "1"

nei file UserSettings.txt trovati, così i video iniziali Bethesda/ZeniMax vengono saltati quando possibile.

Installazione Minion

Minion può essere usato per gestire gli AddOns di ESO.

1. Installare le dipendenze

sudo pacman -S --needed flatpak desktop-file-utils

2. Eseguire lo script Minion

scripts/setup-minion-addon-manager.sh

Lo script:

• configura Flathub se manca;
• installa Minion Flatpak;
• concede a Minion accesso alla home;
• crea le cartelle AddOns e SavedVariables;
• genera un launcher desktop dedicato.

3. Percorso AddOns

Il percorso consigliato viene scritto in:

~/.cache/eso-linux/minion-addon-path.txt

Nel setup verificato, il percorso AddOns è:

~/Documenti/Elder Scrolls Online/live/AddOns

Avvio Minion:

flatpak run gg.minion.Minion

Installazione Tamriel Trade Centre updater

L'installazione degli addon di gioco resta gestita da Minion. Questo repository non installa Tamriel Trade Centre, HarvestMap o altri addon ESO: prepara solo l'updater dati Linux e i wrapper locali.

L'updater dati serve per sincronizzare Tamriel Trade Centre senza avviare Client.exe tramite Wine/Proton.

1. Prerequisiti

Installa le dipendenze base:

sudo pacman -S --needed curl unzip python python-pip tk

Installa poi con Minion almeno:

Tamriel Trade Centre

HarvestMap, HarvestMap-Data ed ESO-Hub Trading sono opzionali e dipendono dall'uso che vuoi farne.

2. Scaricare e installare l'updater dati

Esegui:

scripts/setup-ttc-updater.sh

Nel setup verificato, il percorso AddOns è:

~/Documenti/Elder Scrolls Online/live/AddOns

Se serve forzarlo:

scripts/setup-ttc-updater.sh --addon-dir "$HOME/Documenti/Elder Scrolls Online/live/AddOns"

Lo script:

• scarica lo zip dell'updater da ESOUI;
• estrae Linux_Tamriel_Trade_Center.sh;
• genera il wrapper ~/scripts/games/eso-ttc.sh;
• crea una venv dedicata ~/scripts/games/eso-ttc-ui-venv;
• installa customtkinter dentro la venv;
• installa la UI Python ~/scripts/games/eso-ttc-ui.py;
• crea il launcher UI ~/scripts/games/eso-ttc-ui;
• non usa --steam;
• non modifica Steam launch options;
• non installa addon ESO.

3. Uso da terminale

Aggiornamento singolo EU:

~/scripts/games/eso-ttc.sh --eu --once

Loop EU mentre giochi:

~/scripts/games/eso-ttc.sh --eu --loop

Server NA:

~/scripts/games/eso-ttc.sh --na --once

Stato:

~/scripts/games/eso-ttc.sh --status

Log:

~/scripts/games/eso-ttc.sh --log

Abilitare TTC in AddOnSettings.txt, se l'updater lo vede come disabilitato:

~/scripts/games/eso-ttc.sh --enable-ttc

4. UI grafica

Avvia:

~/scripts/games/eso-ttc-ui

La UI usa CustomTkinter e permette di scegliere:

• server EU/NA;
• modalità once/loop.

5. Nota su SavedVariables

Per caricare dati nuovi verso TTC, ESO deve prima scriverli nei SavedVariables. Se hai appena visitato guild trader o generato nuovi dati, fai logout, chiudi ESO o usa /reloadui prima di rilanciare l'updater.

Troubleshooting

Timeout del launcher

Se compare:

Timeout waiting for window to load

non avviare il launcher con Proton, UMU o Lutris.

Usa:

eso-launcher-update

oppure:

~/scripts/games/eso-launcher-update.sh

Crash premendo PLAY dal launcher

È previsto in questa configurazione.

Il launcher serve solo per installare e aggiornare.

Chiudilo quando mostra PLAY, poi avvia:

eso-play

Client obsoleto

Avvia:

eso-launcher-update

Lascia aggiornare.

Quando il launcher mostra PLAY, chiudilo e poi avvia:

eso-play

GE-Proton non trovato

Installa GE-Proton in:

~/.local/share/Steam/compatibilitytools.d/

Oppure forza il percorso:

export ESO_PROTON_DIR="$HOME/.local/share/Steam/compatibilitytools.d/GE-Proton10-34"
./setup-eso.sh

Wine Mono

Lo script del launcher disabilita Wine Mono con:

WINEDLLOVERRIDES="mscoree=d"

Controllo rapido:

grep -n 'WINEDLLOVERRIDES' ~/scripts/games/eso-launcher-update.sh

Video iniziali ancora visibili

Controlla:

grep -RIn '^SET SkipPregameVideos ' \
  "$HOME/Documenti/Elder Scrolls Online/live" \
  "$HOME/Games/eso-clean-wine11-prefix/drive_c/users" 2>/dev/null

Valore atteso:

SET SkipPregameVideos "1"

Minion non trova gli AddOns

Controlla:

cat ~/.cache/eso-linux/minion-addon-path.txt

Poi usa in Minion il percorso AddOns indicato lì.

Log

Launcher:

cat ~/.cache/eso-linux/eso-launcher-update.log

Gioco:

cat ~/.cache/eso-linux/eso-play.log

Altro

Schema operativo

Uso normale:

eso-play

Aggiornamento:

eso-launcher-update

Flusso consigliato:

1. Avvia eso-launcher-update
2. Installa o aggiorna dal launcher
3. Quando compare PLAY, chiudi il launcher
4. Avvia eso-play

Percorsi generati

Prefisso Wine:

~/Games/eso-clean-wine11-prefix

Script:

~/scripts/games/eso-launcher-update.sh
~/scripts/games/eso-play.sh

Desktop entry:

~/.local/share/applications/eso-launcher.desktop
~/.local/share/applications/eso-game.desktop

Log:

~/.cache/eso-linux/eso-launcher-update.log
~/.cache/eso-linux/eso-play.log

Minion:

~/.local/share/applications/eso-minion.desktop
~/.cache/eso-linux/minion-addon-path.txt

TTC updater:

~/scripts/games/ttc-esoui-updater/Linux_Tamriel_Trade_Center.sh
~/scripts/games/eso-ttc.sh
~/scripts/games/eso-ttc-ui.py
~/scripts/games/eso-ttc-ui
~/scripts/games/eso-ttc-ui-venv/
~/Documents/Linux_Tamriel_Trade_Center/

Variabili ambiente

Percorsi personalizzabili:

export ESO_PREFIX="$HOME/Games/eso-clean-wine11-prefix"
export ESO_SCRIPT_DIR="$HOME/scripts/games"
export ESO_DESKTOP_DIR="$HOME/.local/share/applications"
export ESO_PROTON_DIR="$HOME/.local/share/Steam/compatibilitytools.d/GE-Proton10-34"

./setup-eso.sh

Ricreare da zero il prefisso:

./setup-eso.sh --force

Attenzione: --force cancella il prefisso indicato da ESO_PREFIX.

Note

Questo repository non contiene file del gioco, credenziali, account, launcher binario o contenuti Bethesda/ZeniMax.

Lo script scarica il launcher ufficiale e prepara solo l'ambiente locale.