kyber: document registry fix for Origin language error and GPU crash workaround

- Add troubleshooting for 'Origin Error: title installed in language not
  entitled to play' — Maxima's umu-run reg commands fail silently on some
  systems; manual wine64 regedit import of Origin locale keys fixes it
- Add windowed-mode / HDR fix for SWBF2 crash during level load on
  integrated GPUs (Intel Iris Xe, DXVK rendering crash)
- Document fix in both README.md and script header comments

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D8ckUJQtj1pH8jtAddBDZs

README.md

@@ -184,6 +184,31 @@ find ~/.steam/steam/steamapps -name "starwarsbattlefrontii.exe" 2>/dev/null | he
 ```
 Paste that path into the SET GAME FOLDER dialog.
 
+**If Origin Error: "title installed in language not entitled to play":**
+Maxima's Wine prefix is missing locale registry keys — its setup commands fail silently on some systems. Fix:
+```bash
+cat > /tmp/swbf2_fix.reg << 'EOF'
+Windows Registry Editor Version 5.00
+[HKEY_LOCAL_MACHINE\Software\Origin Games\1035052]
+"locale"="en_US"
+"displayname"="STAR WARS Battlefront II"
+[HKEY_LOCAL_MACHINE\Software\Wow6432Node\Origin Games\1035052]
+"locale"="en_US"
+"displayname"="STAR WARS Battlefront II"
+[HKEY_LOCAL_MACHINE\Software\Electronic Arts\EA Desktop]
+"InstallSuccessful"="true"
+[HKEY_LOCAL_MACHINE\Software\Origin]
+"InstallSuccessful"="true"
+"ClientPath"="C:\\Windows\\System32\\conhost.exe"
+[HKEY_CURRENT_USER\Control Panel\International]
+"Locale"="00000409"
+"LocaleName"="en-US"
+"sLanguage"="ENU"
+EOF
+WINEPREFIX=~/.local/share/maxima/wine/prefix wine64 regedit /tmp/swbf2_fix.reg
+```
+Then restart Kyber and try again.
+
 **First run (one-time setup):**
 1. Click **EA Account** → log in with your EA credentials in the browser
 2. Click **Skip** on Nexus Mods (optional, only needed for mods)
@@ -211,6 +236,16 @@ Paste that path into the SET GAME FOLDER dialog.
   to `/etc/sysctl.d/99-userns.conf` to persist across reboots.
   Without this fix Kyber fails with: `bwrap: setting up uid map: Permission denied`
 
+**If SWBF2 crashes immediately when a level starts loading:**
+Likely a DXVK rendering issue, especially on integrated GPUs (Intel Iris Xe, etc.).
+Disable fullscreen and HDR in the game settings file — the game writes this on first run:
+```bash
+PROFILE=$(find ~/.local/share/maxima -name "ProfileOptions_profile" 2>/dev/null | head -1)
+sed -i 's/GstRender.FullscreenEnabled 1/GstRender.FullscreenEnabled 0/' "$PROFILE"
+sed -i 's/GstRender.EnableHDR 1/GstRender.EnableHDR 0/' "$PROFILE"
+```
+Then restart Kyber and try hosting/joining again.
+
 **What does NOT work:**
 - Running the Windows `kyber_launcher.exe` under Wine/Proton: EA's auth
   callback uses the `eadesktop://` URI scheme which has no Linux handler,

scripts/setup-kyber-linux.sh

@@ -91,6 +91,36 @@
 #   kernel.unprivileged_userns_clone = 1
 #   kernel.apparmor_restrict_unprivileged_userns = 0
 #
+# ── "Origin Error: title installed in language not entitled" ───────────────
+#
+# If Kyber launches SWBF2 but the game shows an Origin Error about language
+# entitlement, Maxima's Wine prefix is missing the Origin locale registry keys.
+# Maxima writes these via umu-run reg commands on first run, but they can fail
+# silently (exit code 1) leaving the keys absent.
+#
+# Fix: manually import the registry keys into Maxima's Wine prefix.
+# Create a file (e.g. /tmp/swbf2_fix.reg) with:
+#
+#   Windows Registry Editor Version 5.00
+#   [HKEY_LOCAL_MACHINE\Software\Origin Games\1035052]
+#   "locale"="en_US"
+#   "displayname"="STAR WARS Battlefront II"
+#   [HKEY_LOCAL_MACHINE\Software\Wow6432Node\Origin Games\1035052]
+#   "locale"="en_US"
+#   "displayname"="STAR WARS Battlefront II"
+#   [HKEY_LOCAL_MACHINE\Software\Electronic Arts\EA Desktop]
+#   "InstallSuccessful"="true"
+#   [HKEY_LOCAL_MACHINE\Software\Origin]
+#   "InstallSuccessful"="true"
+#   "ClientPath"="C:\\Windows\\System32\\conhost.exe"
+#   [HKEY_CURRENT_USER\Control Panel\International]
+#   "Locale"="00000409"
+#   "LocaleName"="en-US"
+#   "sLanguage"="ENU"
+#
+# Then import it:
+#   WINEPREFIX=~/.local/share/maxima/wine/prefix wine64 regedit /tmp/swbf2_fix.reg
+#
 # ── "Game Not Found" dialog ────────────────────────────────────────────────
 #
 # If Kyber shows "Game Not Found" after launching: