#!/bin/bash # setup-kyber-linux.sh — Install the Kyber Launcher for SWBF2 (2017) on a # native Linux Steam machine (headless or desktop) with Proton Experimental. # # Kyber is a community multiplayer client for Star Wars Battlefront II (2017) # after EA shut down the official servers. It is a Windows app (Flutter/Rust). # # ── How Kyber's EA login actually works ──────────────────────────────────── # # Kyber uses the "Maxima" OAuth PKCE flow: # 1. Kyber starts a temporary HTTP server on 127.0.0.1 (dynamic port ~41413+) # 2. It calls cmd /c start "" "" to open a browser # 3. You log in on the EA page; EA redirects to 127.0.0.1:PORT/?code=... # 4. Kyber's HTTP server catches the code and exchanges it for tokens # # On native Linux, Wine's built-in cmd.exe passes http(s):// URLs to # xdg-open, which launches your system browser. Steam's pressure-vessel # (bwrap) sandbox does NOT block xdg-open on native Linux — xdg-open reaches # the host desktop and the browser opens normally. # # After you approve the EA login page the browser is redirected to # 127.0.0.1:PORT (Kyber's loopback server). The browser hits that address, # Kyber receives the auth code, and login completes. No special shims needed. # # ── Why NOT to run Kyber inside Wolf / Games-on-Whales ───────────────────── # # Wolf runs Docker + Proton's bwrap nested. The double-sandbox blocks # CLONE_NEWUSER which breaks WebView2, AND the inner bwrap prevents # xdg-open from reaching the host display. Kyber's loopback redirect to # 127.0.0.1:PORT also fails inside the container network stack. Use native # Linux Steam instead — it's the supported path. # # ── WebView2 ─────────────────────────────────────────────────────────────── # # WebView2 is NOT required for the login flow (Maxima handles that). This # script still installs the WebView2 Evergreen runtime because Kyber may use # it for in-app content rendering. Installing it causes no harm and prevents # any fallback-related error dialogs inside Kyber. # # ── Headless note ────────────────────────────────────────────────────────── # # On a headless GPU box use Steam Remote Play: install Steam, configure a # virtual/dummy display so Steam has something to render to, add Kyber + # SWBF2, then connect with the Steam Link app from any device. # This script warns if no display is detected at setup time. # # ── Prerequisites ────────────────────────────────────────────────────────── # a. Steam installed and launched at least once (native, not Flatpak ideally # — Flatpak works but paths differ; this script handles both). # b. SWBF2 (AppID 1237950) installed and working with Proton Experimental # (run setup-swbf2-linux.sh first). # c. KyberLauncher.exe downloaded from https://kyber.gg saved to # ~/Downloads/KyberLauncher.exe (or pass the path as $1). # # ── Usage ────────────────────────────────────────────────────────────────── # chmod +x setup-kyber-linux.sh # ./setup-kyber-linux.sh [/path/to/KyberLauncher.exe] set -euo pipefail KYBER_INSTALLER="${1:-$HOME/Downloads/KyberLauncher.exe}" KYBER_COMPAT_ID="kyber" # Wine prefix name under compatdata/ KYBER_APPID="9900000001" # non-Steam shortcut appid echo "=== Kyber Launcher — Native Linux Steam Setup ===" echo "" # ── Locate Steam home ────────────────────────────────────────────────────── find_steam_home() { for candidate in \ "$HOME/.steam/steam" \ "$HOME/.local/share/Steam" \ "$HOME/.var/app/com.valvesoftware.Steam/.steam/steam"; do if [ -d "$candidate/steamapps" ]; then echo "$candidate" return 0 fi done return 1 } STEAM_HOME=$(find_steam_home) || { echo "ERROR: Steam home not found. Install Steam and launch it once." exit 1 } echo "Steam home: $STEAM_HOME" # ── Verify / download Kyber installer ───────────────────────────────────── if [ ! -f "$KYBER_INSTALLER" ]; then echo "" echo "Kyber installer not found at: $KYBER_INSTALLER" echo "Downloading from kyber.gg API..." mkdir -p "$(dirname "$KYBER_INSTALLER")" KYBER_ZIP="/tmp/kyber-installer-$$.zip" KYBER_DL_URL="https://api.prod.kyber.gg/download/kyber-installer-win64.zip" if curl -L --progress-bar -o "$KYBER_ZIP" "$KYBER_DL_URL" && [ -s "$KYBER_ZIP" ]; then # Extract the installer .exe from the zip _exe=$(unzip -Z1 "$KYBER_ZIP" 2>/dev/null | grep -i '\.exe$' | head -1) if [ -z "$_exe" ]; then echo "ERROR: No .exe found inside the downloaded zip." rm -f "$KYBER_ZIP" exit 1 fi unzip -p "$KYBER_ZIP" "$_exe" > "$KYBER_INSTALLER" rm -f "$KYBER_ZIP" echo "Extracted: $(basename "$_exe") → $KYBER_INSTALLER" else echo "" echo "ERROR: Download failed." echo "Download the zip manually from https://kyber.gg, extract the .exe, then:" echo " $0 /path/to/KyberLauncher.exe" rm -f "$KYBER_ZIP" exit 1 fi fi echo "Kyber installer: $KYBER_INSTALLER" # ── Locate Proton Experimental ───────────────────────────────────────────── # Kyber's WebView2 is best supported on Proton Experimental (newest Wine + # the most complete WebView2/Edge compatibility shims). GE-Proton also works, # but Experimental tends to have the freshest fixes for Chromium sandboxing. PROTON_DIR=$(find "$STEAM_HOME/steamapps/common" -maxdepth 1 -type d \ -iname "Proton Experimental" 2>/dev/null | head -1) if [ -z "$PROTON_DIR" ]; then PROTON_DIR=$(find "$STEAM_HOME/steamapps/common" -maxdepth 1 -type d \ -iname "Proton*" 2>/dev/null | sort | tail -1) fi if [ -z "$PROTON_DIR" ] || [ ! -x "$PROTON_DIR/proton" ]; then echo "" echo "ERROR: Proton not found under $STEAM_HOME/steamapps/common." echo " In Steam → Settings → Compatibility, install Proton Experimental," echo " then re-run this script." exit 1 fi echo "Proton: $PROTON_DIR" # ── Headless display check ───────────────────────────────────────────────── # WebView2 (and Kyber's Flutter UI) need a display to render to. On a headless # box with no X/Wayland session, Kyber's window has nowhere to draw. if [ -z "${DISPLAY:-}" ] && [ -z "${WAYLAND_DISPLAY:-}" ]; then echo "" echo "NOTE: No DISPLAY or WAYLAND_DISPLAY detected (headless box)." echo " For Steam Remote Play you need a virtual display so Steam can" echo " render. Options:" echo " - Configure your GPU driver's dummy/virtual display (recommended" echo " for hardware-encoded Remote Play), OR" echo " - Run this whole setup under Xvfb for the install step only:" echo " xvfb-run -a $0 $KYBER_INSTALLER" echo "" echo " Continuing the install (the prefix can be built headless), but you" echo " must have a real or virtual display when you actually launch Kyber." echo "" fi # ── Build Kyber Wine prefix and run the installer ────────────────────────── echo "" echo "[1/5] Installing Kyber into Wine prefix..." KYBER_PFX="$STEAM_HOME/steamapps/compatdata/$KYBER_COMPAT_ID" export STEAM_COMPAT_DATA_PATH="$KYBER_PFX" export STEAM_COMPAT_CLIENT_INSTALL_PATH="$STEAM_HOME" export PROTON_NO_ESYNC=1 # Check if Kyber is already installed — skip the installer if so. KYBER_EXE_PATH=$(find "$KYBER_PFX/pfx" -name "Kyber.exe" 2>/dev/null | head -1) if [ -n "$KYBER_EXE_PATH" ]; then echo " Kyber.exe already present — skipping installer." else mkdir -p "$KYBER_PFX" # Kill any leftover Wine/Proton processes from a previous attempt. pkill -9 -f "compatdata/$KYBER_COMPAT_ID" 2>/dev/null || true sleep 1 echo " Running installer (silent)..." # /S = NSIS silent flag; if Kyber's installer ignores it a GUI appears. "$PROTON_DIR/proton" run "$KYBER_INSTALLER" /S 2>/dev/null || \ "$PROTON_DIR/proton" run "$KYBER_INSTALLER" 2>/dev/null || true sleep 5 KYBER_EXE_PATH=$(find "$KYBER_PFX/pfx" -name "Kyber.exe" 2>/dev/null | head -1) if [ -z "$KYBER_EXE_PATH" ]; then echo "" echo "WARNING: Kyber.exe not found after installation." echo " Default install path assumed; continuing." fi fi # Resolve Windows-style paths for the shortcut if [ -n "$KYBER_EXE_PATH" ]; then rel=$(echo "$KYBER_EXE_PATH" | sed "s|.*/pfx/drive_c/||") KYBER_EXE_WIN="C:\\$(echo "$rel" | sed 's|/|\\|g')" dir_rel=$(dirname "$rel") KYBER_START_DIR="C:\\$(echo "$dir_rel" | sed 's|/|\\|g')\\" else KYBER_EXE_WIN='C:\Program Files (x86)\KYBER Launcher\Kyber.exe' KYBER_START_DIR='C:\Program Files (x86)\KYBER Launcher\' fi echo " Windows path: $KYBER_EXE_WIN" # ── Ensure WebView2 Evergreen runtime is installed ───────────────────────── echo "" echo "[2/5] Verifying WebView2 runtime in the Kyber prefix..." # The Evergreen runtime lives here once installed. WV2_FOUND=$(find "$KYBER_PFX/pfx/drive_c" -iname "msedgewebview2.exe" 2>/dev/null | head -1) if [ -n "$WV2_FOUND" ]; then echo " WebView2 runtime present:" echo " $WV2_FOUND" else echo " WebView2 runtime NOT found — installing..." # Prefer winetricks if available — it handles the prefix env automatically # and uses a cached offline installer so no Wine-internal network call needed. if command -v winetricks >/dev/null 2>&1; then echo " Using winetricks to install webview2..." WINEPREFIX="$KYBER_PFX/pfx" \ WINE="$PROTON_DIR/files/bin/wine64" \ winetricks -q webview2 || true else # Download the Evergreen STANDALONE (offline) installer — linkid=2135547. # The bootstrapper (linkid=2124703) requires a second download from inside # Wine which reliably fails. The standalone is ~150 MB but self-contained. echo " Downloading WebView2 standalone installer (~150 MB)..." WV2_STANDALONE="/tmp/WebView2RuntimeInstaller_$$.exe" WV2_URL="https://go.microsoft.com/fwlink/p/?LinkId=2135547" if curl -L --progress-bar -o "$WV2_STANDALONE" "$WV2_URL" && [ -s "$WV2_STANDALONE" ]; then "$PROTON_DIR/proton" run "$WV2_STANDALONE" /silent /install || true rm -f "$WV2_STANDALONE" else echo " WARNING: Could not download WebView2 standalone installer." rm -f "$WV2_STANDALONE" fi fi sleep 5 WV2_FOUND=$(find "$KYBER_PFX/pfx/drive_c" -iname "msedgewebview2.exe" 2>/dev/null | head -1) if [ -n "$WV2_FOUND" ]; then echo " WebView2 runtime installed:" echo " $WV2_FOUND" else echo "" echo " WARNING: WebView2 runtime still not found after install attempt." echo " Install winetricks and re-run, or install manually:" echo " sudo apt install winetricks" echo " $0" fi fi # ── Add Kyber as a non-Steam shortcut ────────────────────────────────────── echo "" echo "[3/5] Adding Kyber as a non-Steam shortcut..." STEAM_UID=$(ls "$STEAM_HOME/userdata/" 2>/dev/null | grep -E '^[0-9]+$' | head -1) if [ -z "$STEAM_UID" ]; then echo " WARNING: No Steam userdata found — sign in to Steam once, then re-run." echo " Skipping shortcut + compat mapping." SKIP_STEAM_CFG=1 else SHORTCUTS_DIR="$STEAM_HOME/userdata/$STEAM_UID/config" SHORTCUTS_FILE="$SHORTCUTS_DIR/shortcuts.vdf" mkdir -p "$SHORTCUTS_DIR" if [ -f "$SHORTCUTS_FILE" ] && [ ! -w "$SHORTCUTS_FILE" ]; then echo " Fixing permissions on shortcuts.vdf..." chmod 644 "$SHORTCUTS_FILE" || { echo " WARNING: Cannot write $SHORTCUTS_FILE — run:" echo " chmod 644 $SHORTCUTS_FILE" echo " then re-run this script." SKIP_STEAM_CFG=1 } fi [ -f "$SHORTCUTS_FILE" ] && cp "$SHORTCUTS_FILE" "$SHORTCUTS_FILE.bak" python3 - "$SHORTCUTS_FILE" "$KYBER_APPID" "$KYBER_EXE_WIN" "$KYBER_START_DIR" << 'PYEOF' import sys, struct, os def s(key, value): # VDF string field return b'\x01' + key.encode() + b'\x00' + value.encode() + b'\x00' def i(key, value): # VDF int field return b'\x02' + key.encode() + b'\x00' + struct.pack('/?code=... — Kyber's" echo " loopback server catches the auth code and login completes." echo " The browser tab will show a plain 'OK' or a connection-refused" echo " message once the code is consumed — that is normal." echo "" echo "Streaming from a headless box:" echo " Use Steam Remote Play — install the Steam Link app on your client," echo " it discovers this host over your network. No Wolf, no Moonlight, no" echo " VPN required for a single user." echo "" echo "If the EA login page never opens:" echo " xdg-open failed to reach your desktop. Make sure a display is set:" echo " export DISPLAY=:0 (or WAYLAND_DISPLAY=wayland-0, etc.)" echo " Then relaunch Kyber from that terminal." echo "" echo "If the browser opens but login redirects back to the EA sign-in page:" echo " Kyber's loopback server timed out. Log in faster, or close and" echo " reopen Kyber to get a fresh loopback server before clicking Login." echo "" echo "If WebView2 errors appear inside Kyber (not the login flow):" echo " find \"$KYBER_PFX/pfx/drive_c\" -iname msedgewebview2.exe" echo " If missing, re-run the WebView2 install step shown above."