From 01796c3041c346869f238e120adbd78cb2e5412f Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 25 Jun 2026 14:20:16 +0000
Subject: [PATCH] docs: clarify that SWBF2 must be launched from Steam before
 using Kyber
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Kyber does not launch the game itself — Steam must start SWBF2 first
and let it reach the main menu. Added this to both the script output
and the README gaming section.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01D8ckUJQtj1pH8jtAddBDZs
---
 README.md                    | 16 ++++++++++++----
 scripts/setup-kyber-linux.sh | 15 ++++++++++-----
 2 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 0bd98d0..200fffe 100644
--- a/README.md
+++ b/README.md
@@ -165,15 +165,23 @@ chmod +x scripts/setup-kyber-linux.sh
 The script downloads the latest AppImage, installs a desktop entry, and
 creates a `kyber` command in `~/.local/bin`.
 
-**First run:**
+**Every time you want to play:**
+1. **Launch SWBF2 from Steam first** — let it fully load to the main menu
+2. Launch Kyber (`kyber` or from the app menu)
+3. In Kyber: join a server (HOME) or create one (HOST)
+4. Kyber connects to the already-running game instance
+
+Kyber does not launch the game itself — Steam must start it first.
+
+**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)
-3. Browse servers on **HOME** or create one under **HOST**
+3. EA login is cached — you stay logged in across sessions
 
 **Hosting a private server with bots:**
 - HOST → pick maps/modes → set a **name** and **PASSWORD** → Start Server
-- Share the name + password with friends; they search by name in HOME
-- SWBF2 fills empty slots with AI automatically — no separate bot setting
+- Share the server name + password with friends; they search by name in HOME
+- SWBF2 fills empty slots with AI automatically — no separate bot setting needed
 
 **Requirements:**
 - SWBF2 (Steam AppID 1237950) installed with GE-Proton (recommended over
diff --git a/scripts/setup-kyber-linux.sh b/scripts/setup-kyber-linux.sh
index ce2ec54..dfcbf35 100755
--- a/scripts/setup-kyber-linux.sh
+++ b/scripts/setup-kyber-linux.sh
@@ -157,15 +157,20 @@ echo "  From terminal:    kyber"
 echo "  From app menu:    search 'Kyber Launcher'"
 echo "  Direct:           $APPIMAGE_PATH"
 echo ""
-echo "First run:"
+echo "Every time you want to play:"
+echo "  1. Launch SWBF2 from Steam first — let it fully load to the main menu."
+echo "  2. Then launch Kyber and join or host a server."
+echo "  Kyber does not launch the game itself — Steam must start SWBF2 first."
+echo ""
+echo "First run (one-time):"
 echo "  1. Click 'EA Account' and log in with your EA credentials."
 echo "  2. Click 'Skip' on the Nexus Mods step (optional — only needed for mods)."
-echo "  3. You're in. Browse servers on HOME or create one under HOST."
+echo "  3. EA login is cached — you stay logged in across sessions."
 echo ""
-echo "Hosting a private server:"
+echo "Hosting a private server with bots:"
 echo "  HOST → pick maps → set a name and PASSWORD → Start Server."
-echo "  Share the server name + password with friends."
-echo "  Bots fill empty slots automatically — no separate setting needed."
+echo "  Share the server name + password with friends (they search by name in HOME)."
+echo "  Bots fill empty slots automatically — no separate bot setting needed."
 echo ""
 echo "SWBF2 must be installed via Steam (AppID 1237950) with GE-Proton."
 echo "GE-Proton: https://github.com/GloriousEggroll/proton-ge-custom/releases"