Disable recursive search for dependacies

.gitea/workflows/release.yml

@@ -29,6 +29,14 @@ jobs:
         shell: powershell
         run: |
           $ErrorActionPreference = 'Stop'
+          # Stamp version into sealoader_version.py from release tag
+          if ($env:GITHUB_EVENT_NAME -eq 'release') {
+            $tag = '${{ github.event.release.tag_name }}'
+          } else {
+            $tag = (git describe --tags --always) 2>$null
+            if (-not $tag) { $tag = "0.0.0-dev" }
+          }
+          ("__version__ = '" + $tag + "'") | Out-File -FilePath sealoader_version.py -Encoding UTF8 -Force
           # Bundle PNG resources referenced at runtime
           pyinstaller --noconfirm --onefile --windowed sealoader_gui.py --name SeaLoader `
             --add-data "SeaLoader.png;." `

README.md

@@ -1,3 +1,73 @@
 # SeaLoader
 
-A Modloader based off of the workshop
+SeaLoader is a minimal, dark-themed helper app for Sea Power that fetches a scenario’s required Steam Workshop mods, resolves names, checks for transitive dependencies, and enables matching mods in your `usersettings.ini`. It also supports subscribing to missing mods, scanning the Steam Workshop folder for installed content, and self-updating.
+
+## Features
+- Fetch required mods from a Workshop URL and resolve their names
+- Recursive dependency expansion: also fetches each required mod’s own requirements
+- Two-pane UI:
+  - Installed Mods (from Steam Workshop folder) with status: Enabled, Disabled, or Disabled (Not in INI)
+  - Scenario Required Mods with Installed/Missing status
+- Enable Matching Mods: writes to `[LoadOrder]` and appends missing workshop IDs as new `ModNDirectory=<id>,True`
+- Subscribe Missing Mods: opens Steam deep links per mod; step-by-step flow with remaining count
+- Refresh: reload Installed Mods and re-fetch Required Mods (if URL provided)
+- Guided flashing to lead the user through steps (URL → Fetch → Subscribe/Refresh → Enable)
+- Game Path persistence: remembers the Steam game path next to `usersettings.ini`
+- Version display and update check (Gitea API + RSS fallback), with clickable link
+- Auto-update install (EXE only): download zip, replace EXE safely, relaunch
+
+## Requirements
+- Windows 10+
+- Python 3.10+ (for running from source) or the packaged EXE
+- Steam client installed and logged in (for Subscribe Missing Mods)
+
+## Run from source
+```bash
+python -m pip install -r requirements.txt
+python sealoader_gui.py
+```
+
+## Usage
+1. Game Path: Click Browse and select your Sea Power install folder (e.g., `.../steamapps/common/Sea Power`).
+   - If previously saved, SeaLoader loads it automatically on start.
+2. Paste a Workshop URL and click Fetch Required Mods.
+   - The right list shows all required Workshop IDs and names, including transitive dependencies.
+3. If some are Missing:
+   - Click Subscribe Missing Mods. A per-mod dialog will open; it shows how many remain.
+   - After subscribing, click Refresh to reload Installed Mods and re-fetch required.
+4. Click Enable Matching Mods to enable all installed required mods.
+   - A backup `usersettings.ini.bak` is created.
+
+Statuses in Installed Mods:
+- Enabled: Present in INI and enabled
+- Disabled: Present in INI but disabled
+- Disabled (Not in INI): Found in workshop folder but no INI entry yet (Enable adds it)
+
+## Self-update
+- SeaLoader shows current and latest versions in the footer.
+- If a newer version exists, a modal dialog appears with options:
+  - Download: opens the release page
+  - Auto-Install (EXE only): downloads `SeaLoader_Windows_x64.zip`, replaces `SeaLoader.exe`, and relaunches
+- Latest version is discovered via Gitea API with RSS fallback: `releases.rss`.
+
+## Build (Gitea Actions)
+- Workflow: `.gitea/workflows/release.yml`
+  - On release: stamps `sealoader_version.py` with the tag, bundles PNGs, and builds onefile EXE via PyInstaller
+  - Uploads `SeaLoader_Windows_x64.zip` as the release asset
+- Runner: Windows; steps use `powershell`
+
+## Files
+- `sealoader_gui.py`: GUI application
+- `steam_required_ids.py`: Workshop scraping, ID resolution, recursive expansion
+- `sealoader_version.py`: version stamp used by the update checker
+- `requirements.txt`: dependencies (requests, beautifulsoup4)
+- `.gitea/workflows/release.yml`: release build pipeline
+
+## Troubleshooting
+- Footer icons not visible in EXE: ensure `SeaLoader.png` and `hrsys.png` are present at build; the workflow includes them via `--add-data`.
+- Update checker says unavailable: RSS fallback is in place; ensure `SEALOADER_GITEA` and `SEALOADER_REPO` env vars are correct if using a mirror.
+- Subscribe Missing Mods not opening Steam: ensure Steam client is running and you’re signed in.
+- INI not updated: verify `usersettings.ini` path and that `[LoadOrder]` exists. SeaLoader will append new entries if needed.
+
+## Credits
+Created by HudsonRiggs.Systems.

sealoader_gui.py

@@ -3,15 +3,18 @@ import os
 import shutil
 import sys
 import threading
+import time
 import webbrowser
+import re
 from dataclasses import dataclass
 from pathlib import Path
 from typing import Dict, List, Tuple
 
 import tkinter as tk
-from tkinter import messagebox, ttk
+from tkinter import messagebox, ttk, filedialog
 
 from steam_required_ids import extract_required_item_ids, resolve_workshop_names
+from sealoader_version import __version__
 
 
 # Minimal dark theme colors
@@ -70,6 +73,74 @@ def read_installed_mods(ini_path: str) -> Dict[str, InstalledMod]:
     return mods
 
 
+def _get_enabled_mod_ids_from_ini(ini_path: str) -> set[str]:
+    try:
+        mods = read_installed_mods(ini_path)
+    except FileNotFoundError:
+        return set()
+    return {mid for mid, m in mods.items() if m.enabled}
+
+def _get_all_mod_ids_from_ini(ini_path: str) -> set[str]:
+    try:
+        mods = read_installed_mods(ini_path)
+    except FileNotFoundError:
+        return set()
+    return set(mods.keys())
+
+
+def _find_steamapps_dir_from_game_path(game_path: str) -> Path | None:
+    p = Path(game_path).resolve()
+    for parent in [p] + list(p.parents):
+        if parent.name.lower() == "common" and parent.parent.name.lower() == "steamapps":
+            return parent.parent
+        if parent.name.lower() == "steamapps":
+            return parent
+    return None
+
+
+def _detect_app_id(steamapps_dir: Path, installdir_name: str) -> str | None:
+    target = installdir_name.lower()
+    for acf in steamapps_dir.glob("appmanifest_*.acf"):
+        try:
+            text = acf.read_text(encoding="utf-8", errors="ignore")
+        except Exception:
+            continue
+        if '"installdir"' in text:
+            for line in text.splitlines():
+                if '"installdir"' in line:
+                    parts = [seg for seg in line.split('"') if seg.strip()]
+                    if parts:
+                        val = parts[-1].strip().lower()
+                        if val == target:
+                            return acf.stem.replace("appmanifest_", "")
+    return None
+
+
+def read_installed_mods_from_workshop(game_path: str, ini_path: str) -> Dict[str, InstalledMod]:
+    if not game_path:
+        return {}
+    steamapps = _find_steamapps_dir_from_game_path(game_path)
+    if not steamapps or not steamapps.exists():
+        return {}
+    installdir = Path(game_path).name
+    app_id = _detect_app_id(steamapps, installdir)
+    if not app_id:
+        return {}
+    workshop_dir = steamapps / "workshop" / "content" / app_id
+    if not workshop_dir.exists():
+        return {}
+    enabled_ids = _get_enabled_mod_ids_from_ini(ini_path)
+    mods: Dict[str, InstalledMod] = {}
+    try:
+        for child in workshop_dir.iterdir():
+            if child.is_dir() and child.name.isdigit():
+                mid = child.name
+                mods[mid] = InstalledMod(mod_id=mid, enabled=(mid in enabled_ids))
+    except Exception:
+        pass
+    return mods
+
+
 def enable_mods_in_ini(ini_path: str, ids_to_enable: List[str]) -> Tuple[int, int]:
     parser = configparser.ConfigParser()
     parser.optionxform = str
@@ -86,6 +157,16 @@ def enable_mods_in_ini(ini_path: str, ids_to_enable: List[str]) -> Tuple[int, in
     enabled_count = 0
     missing_count = 0
 
+    # Determine next index for new Mod entries
+    next_idx = 1
+    for key, _ in parser[section].items():
+        m = re.match(r"Mod(\d+)Directory", key, re.IGNORECASE)
+        if m:
+            try:
+                next_idx = max(next_idx, int(m.group(1)) + 1)
+            except Exception:
+                pass
+
     # Maintain order and preserve original left token (may include name after ID)
     items = list(parser[section].items())
     # Maintain order
@@ -118,7 +199,11 @@ def enable_mods_in_ini(ini_path: str, ids_to_enable: List[str]) -> Tuple[int, in
                     enabled_count += 1
                 break
         if not found_key:
-            missing_count += 1
+            # Append new entry at bottom for this workshop ID, disabled status will be set to True
+            new_key = f"Mod{next_idx}Directory"
+            parser[section][new_key] = f"{target_id},True"
+            next_idx += 1
+            enabled_count += 1
 
     with open(ini_path, "w", encoding="utf-8") as f:
         parser.write(f)
@@ -139,6 +224,9 @@ class SeaLoaderApp(tk.Tk):
         self.required_ids: List[str] = []
         self.installed_names_map: Dict[str, str] = {}
         self._icon_img = None
+        self._did_flash_fetch = False
+        self._did_flash_enable = False
+        self._flash_states = {}
 
         self._style()
         self._layout()
@@ -158,6 +246,25 @@ class SeaLoaderApp(tk.Tk):
             self.bind("<F1>", lambda e: self._on_help())
         except Exception:
             pass
+        # Guide: when URL is filled, flash Fetch
+        try:
+            self.url_var.trace_add('write', self._on_url_changed)
+        except Exception:
+            pass
+
+        # Load saved game path (if any) and auto-load mods
+        try:
+            saved = self._load_saved_game_path()
+            if saved:
+                self.game_path_var.set(saved)
+                self._load_installed_mods()
+                if not self.url_var.get().strip():
+                    self._start_flash(self.url_entry, entry=True)
+        except Exception:
+            pass
+
+        # Check for updates asynchronously
+        threading.Thread(target=self._check_for_updates_async, daemon=True).start()
 
     def _style(self) -> None:
         style = ttk.Style(self)
@@ -175,6 +282,9 @@ class SeaLoaderApp(tk.Tk):
         style.configure("TScrollbar", background=PANEL_BG, troughcolor=BG)
         style.configure("Treeview", background=PANEL_BG, fieldbackground=PANEL_BG, foreground=FG, borderwidth=0)
         style.configure("Treeview.Heading", background=PANEL_BG, foreground=MUTED)
+        # Flash styles
+        style.configure("Flash.TEntry", fieldbackground="#2b3a5a", foreground=FG, insertcolor=FG)
+        style.configure("Flash.TButton", background=ACCENT, foreground="#0d1117")
 
     def _layout(self) -> None:
         top = ttk.Frame(self, style="TFrame")
@@ -188,6 +298,15 @@ class SeaLoaderApp(tk.Tk):
         self.fetch_btn = ttk.Button(top, text="Fetch Required Mods", command=self._on_fetch)
         self.fetch_btn.pack(side=tk.LEFT)
 
+        # Game path row
+        path_row = ttk.Frame(self, style="TFrame")
+        path_row.pack(fill=tk.X, padx=12, pady=(0, 6))
+        ttk.Label(path_row, text="Game Path:", style="TLabel").pack(side=tk.LEFT)
+        self.game_path_var = tk.StringVar()
+        self.game_path_entry = ttk.Entry(path_row, textvariable=self.game_path_var, width=70)
+        self.game_path_entry.pack(side=tk.LEFT, padx=8, fill=tk.X, expand=True)
+        ttk.Button(path_row, text="Browse", command=self._browse_game_path).pack(side=tk.LEFT)
+
         main = ttk.Frame(self, style="TFrame")
         main.pack(fill=tk.BOTH, expand=True, padx=12, pady=6)
 
@@ -198,7 +317,7 @@ class SeaLoaderApp(tk.Tk):
 
         left_header = ttk.Label(left_panel, text="Installed Mods", style="Header.TLabel")
         left_header.pack(anchor="w", padx=8, pady=8)
-        self.installed_tree = self._create_tree(left_panel, ["Mod ID", "Name", "Enabled"], [0.30, 0.55, 0.15])
+        self.installed_tree = self._create_tree(left_panel, ["Mod ID", "Name", "Status"], [0.30, 0.50, 0.20])
         self.installed_tree.pack(fill=tk.BOTH, expand=True, padx=8, pady=(0, 8))
 
         right_header = ttk.Label(right_panel, text="Scenario Required Mods", style="Header.TLabel")
@@ -212,7 +331,11 @@ class SeaLoaderApp(tk.Tk):
         self.enable_btn.pack(side=tk.LEFT)
         self.disable_all_btn = ttk.Button(bottom, text="Disable All Mods", command=self._on_disable_all)
         self.disable_all_btn.pack(side=tk.LEFT, padx=(8, 0))
+        self.refresh_btn = ttk.Button(bottom, text="Refresh", command=self._on_refresh)
+        self.refresh_btn.pack(side=tk.LEFT, padx=(8, 0))
         self.help_btn = ttk.Button(bottom, text="Help", command=self._on_help)
+        self.subscribe_btn = ttk.Button(bottom, text="Subscribe Missing Mods", command=self._on_subscribe_missing)
+        self.subscribe_btn.pack(side=tk.RIGHT, padx=(0, 8))
         self.help_btn.pack(side=tk.RIGHT)
 
         # Footer attribution
@@ -226,6 +349,12 @@ class SeaLoaderApp(tk.Tk):
         link_lbl = ttk.Label(footer, text="Created by HudsonRiggs.Systems", style="TLabel", foreground=MUTED)
         link_lbl.pack(side=tk.LEFT, padx=(6, 0))
         link_lbl.bind("<Button-1>", lambda e: self._open_link("https://hudsonriggs.systems"))
+        # Version labels at bottom-right
+        self.version_lbl = ttk.Label(footer, text=f"v{__version__}", style="TLabel", foreground=MUTED)
+        self.version_lbl.pack(side=tk.RIGHT)
+        self.latest_var = tk.StringVar(value="latest: checking…")
+        self.latest_lbl = ttk.Label(footer, textvariable=self.latest_var, style="TLabel", foreground=MUTED)
+        self.latest_lbl.pack(side=tk.RIGHT, padx=(0, 8))
 
     def _create_tree(self, parent, columns: List[str], ratios: List[float]):
         tree = ttk.Treeview(parent, columns=columns, show="headings", height=12)
@@ -253,18 +382,40 @@ class SeaLoaderApp(tk.Tk):
 
     def _load_installed_mods(self) -> None:
         try:
-            self.installed_mods = read_installed_mods(self.ini_path)
+            game_path = self.game_path_var.get().strip() if hasattr(self, "game_path_var") else ""
+            if game_path:
+                self.installed_mods = read_installed_mods_from_workshop(game_path, self.ini_path)
+            else:
+                self.installed_mods = {}
         except FileNotFoundError as e:
             messagebox.showerror("SeaLoader", str(e))
             self.installed_mods = {}
         self._refresh_installed_list()
         self._resolve_installed_names_async()
 
+    def _browse_game_path(self) -> None:
+        path = filedialog.askdirectory(title="Select Sea Power install folder (steamapps/common/Sea Power)")
+        if path:
+            self.game_path_var.set(path)
+            # Auto-load mods when path selected
+            self._load_installed_mods()
+            # Flash the URL box to guide next step
+            self._start_flash(self.url_entry, entry=True)
+            # Persist selection
+            try:
+                self._save_game_path(path)
+            except Exception:
+                pass
+
     def _refresh_installed_list(self) -> None:
         for row in self.installed_tree.get_children():
             self.installed_tree.delete(row)
+        ini_ids = _get_all_mod_ids_from_ini(self.ini_path)
         for mod in self.installed_mods.values():
-            status = "Yes" if mod.enabled else "No"
+            if mod.enabled:
+                status = "Enabled"
+            else:
+                status = "Disabled" if mod.mod_id in ini_ids else "Disabled (Not in INI)"
             display_name = self.installed_names_map.get(mod.mod_id, "")
             self.installed_tree.insert("", tk.END, values=(mod.mod_id, display_name, status))
 
@@ -300,7 +451,8 @@ class SeaLoaderApp(tk.Tk):
 
         def task():
             try:
-                ids = extract_required_item_ids(url)
+                base_ids = extract_required_item_ids(url)
+                ids = base_ids
                 # Reuse installed cache to reduce API calls
                 names_map = {i: self.installed_names_map[i] for i in ids if i in self.installed_names_map}
                 ids_to_lookup = [i for i in ids if i not in names_map]
@@ -318,6 +470,10 @@ class SeaLoaderApp(tk.Tk):
                 self._refresh_required_list(names_map)
                 self.fetch_btn.configure(state=tk.NORMAL)
                 self.enable_btn.configure(state=tk.NORMAL)
+                # Stop flashing Fetch now that step is complete
+                self._stop_flash(self.fetch_btn)
+                # Decide next guided step based on missing
+                self._guide_after_fetch()
 
             self.after(0, update)
 
@@ -354,6 +510,17 @@ class SeaLoaderApp(tk.Tk):
         else:
             msg_lines.append("All required mods were found.")
         messagebox.showinfo("SeaLoader", "\n".join(msg_lines))
+        # Stop flashing Enable step after completion
+        self._stop_flash(self.enable_btn)
+
+    def _on_refresh(self) -> None:
+        # Reload installed mods from current game path
+        self._load_installed_mods()
+        # If a URL is provided, refetch required mods as well
+        if self.url_var.get().strip():
+            # Stop flashing refresh as this step has been taken
+            self._stop_flash(self.refresh_btn)
+            self._on_fetch()
 
     def _on_help(self) -> None:
         ini_hint = (
@@ -361,14 +528,13 @@ class SeaLoaderApp(tk.Tk):
         )
         text = (
             "Usage:\n\n"
-            "1) Download all required mods from Steam Workshop.\n"
-            "   - Using subscribe to all wil work, you must load into seapower after they have downloaded then close the game.\n"
-            "2) Paste a Steam Workshop URL at the top and click 'Fetch Required Mods'.\n"
+            "1) Paste a Steam Workshop URL at the top and click 'Fetch Required Mods'.\n"
             "   - Right list shows required Mod IDs, names and whether they are installed.\n"
-            "3) Installed mods load automatically from usersettings.ini (left list).\n"
+            "2) Installed mods load automatically from usersettings.ini (left list).\n"
+            "3) Click 'Subscribe Missing Mods' to subscribe to any missing Workshop items in Steam.\n"
+            "   - Steam desktop must be running and signed in; downloads happen in the background.\n"
             "4) Click 'Enable Matching Mods' to turn on any installed required mods.\n"
-            "   - A .bak backup of usersettings.ini is created before changes.\n"
-            "5) Mods marked Missing must be downloaded from the workshop see step 1.\n\n"
+            "   - A .bak backup of usersettings.ini is created before changes.\n\n"
             "Tips:\n"
             "- Run with a custom INI path: python sealoader_gui.py \"<path-to-usersettings.ini>\"\n"
             "- Press F1 to open this help.\n\n"
@@ -438,6 +604,326 @@ class SeaLoaderApp(tk.Tk):
         with open(self.ini_path, "w", encoding="utf-8") as f:
             parser.write(f)
 
+    def _on_subscribe_missing(self) -> None:
+        if not self.required_ids:
+            messagebox.showinfo("SeaLoader", "Fetch a Workshop URL first to determine missing mods.")
+            return
+        installed_ids = set(self.installed_mods.keys())
+        missing = [i for i in self.required_ids if i not in installed_ids]
+        if not missing:
+            messagebox.showinfo("SeaLoader", "No missing mods to subscribe.")
+            return
+        self.subscribe_btn.configure(state=tk.DISABLED)
+        # Process one-by-one with remaining counter in the dialog
+        self._subscribe_queue = list(missing)
+        self._subscribe_next()
+
+    def _subscribe_next(self) -> None:
+        queue: List[str] = getattr(self, "_subscribe_queue", [])
+        if not queue:
+            self.subscribe_btn.configure(state=tk.NORMAL)
+            messagebox.showinfo("SeaLoader", "Finished opening subscriptions in Steam.")
+            # Chain: after subscribing, guide to Refresh
+            if getattr(self, "_guide_wait_refresh_after_subscribe", False):
+                self._stop_flash(self.subscribe_btn)
+                self._start_flash(self.refresh_btn, entry=False)
+            return
+        mod_id = queue[0]
+        remaining = len(queue) - 1
+        try:
+            self._open_link(f"steam://subscribe/{mod_id}")
+            time.sleep(0.2)
+            self._open_link(f"steam://openurl/https://steamcommunity.com/sharedfiles/filedetails/?id={mod_id}")
+        except Exception:
+            pass
+        # Show per-item info and proceed when dismissed
+        messagebox.showinfo("SeaLoader", f"Opened subscribe for {mod_id}.\n{remaining} remaining.")
+        # Advance queue and continue
+        queue.pop(0)
+        self._subscribe_queue = queue
+        self.after(0, self._subscribe_next)
+
+    # Guided flashing helpers
+    def _flash_widget(self, widget: ttk.Widget, entry: bool = False, cycles: int = 6, interval_ms: int = 300) -> None:
+        try:
+            normal_style = widget.cget('style') or ("TEntry" if entry else "TButton")
+            flash_style = "Flash.TEntry" if entry else "Flash.TButton"
+            state = {"on": True, "count": cycles * 2}
+
+            def tick():
+                if state["count"] <= 0:
+                    widget.configure(style=normal_style)
+                    return
+                widget.configure(style=flash_style if state["on"] else normal_style)
+                state["on"] = not state["on"]
+                state["count"] -= 1
+                self.after(interval_ms, tick)
+
+            tick()
+        except Exception:
+            try:
+                widget.focus_set()
+            except Exception:
+                pass
+
+    def _on_url_changed(self, *_args):
+        if self.url_var.get().strip():
+            if not self._did_flash_fetch:
+                self._did_flash_fetch = True
+                # Stop URL flash and start flashing Fetch until fetch completes
+                self._stop_flash(self.url_entry)
+                self._start_flash(self.fetch_btn, entry=False)
+
+    def _maybe_flash_enable(self) -> None:
+        if self.required_ids and not self._did_flash_enable:
+            self._did_flash_enable = True
+            self._start_flash(self.enable_btn, entry=False)
+
+    def _guide_after_fetch(self) -> None:
+        installed_ids = set(self.installed_mods.keys())
+        missing = [i for i in self.required_ids if i not in installed_ids]
+        if missing:
+            # Prompt user to subscribe missing first
+            self._stop_flash(self.enable_btn)
+            self._start_flash(self.subscribe_btn, entry=False)
+            # After subscribe series ends, flash refresh
+            self._guide_wait_refresh_after_subscribe = True
+        else:
+            # No missing; go straight to enable
+            self._stop_flash(self.subscribe_btn)
+            self._start_flash(self.enable_btn, entry=False)
+
+    # Continuous flashing (until stopped)
+    def _start_flash(self, widget: ttk.Widget, entry: bool = False, interval_ms: int = 300) -> None:
+        try:
+            normal_style = widget.cget('style') or ("TEntry" if entry else "TButton")
+            flash_style = "Flash.TEntry" if entry else "Flash.TButton"
+            # Cancel existing
+            self._stop_flash(widget)
+            state = {"on": True, "normal": normal_style, "flash": flash_style, "running": True, "job": None}
+            self._flash_states[widget] = state
+
+            def tick():
+                st = self._flash_states.get(widget)
+                if not st or not st["running"]:
+                    try:
+                        widget.configure(style=normal_style)
+                    except Exception:
+                        pass
+                    return
+                try:
+                    widget.configure(style=flash_style if st["on"] else normal_style)
+                except Exception:
+                    pass
+                st["on"] = not st["on"]
+                st["job"] = self.after(interval_ms, tick)
+
+            tick()
+        except Exception:
+            try:
+                widget.focus_set()
+            except Exception:
+                pass
+
+    def _stop_flash(self, widget: ttk.Widget) -> None:
+        st = self._flash_states.pop(widget, None)
+        if st:
+            st["running"] = False
+            try:
+                widget.configure(style=st["normal"])  # restore
+            except Exception:
+                pass
+
+    # Simple storage for game path next to INI
+    def _storage_file_path(self) -> Path:
+        try:
+            ini_dir = Path(self.ini_path).resolve().parent
+        except Exception:
+            ini_dir = Path.cwd()
+        return ini_dir / "sealoader_game_path.txt"
+
+    def _save_game_path(self, path: str) -> None:
+        p = self._storage_file_path()
+        p.write_text(path.strip(), encoding="utf-8")
+
+    def _load_saved_game_path(self) -> str:
+        p = self._storage_file_path()
+        if p.exists():
+            return p.read_text(encoding="utf-8").strip()
+        return ""
+
+    # Update checker
+    def _check_for_updates_async(self) -> None:
+        try:
+            import requests
+            import re
+            # Configure your Gitea server/repo here
+            owner_repo = os.getenv("SEALOADER_REPO", "HRiggs/SeaLoader")
+            server = os.getenv("SEALOADER_GITEA", "https://git.hudsonriggs.systems")
+
+            latest_tag = None
+            release_url = None
+
+            # Try API first
+            try:
+                api_url = f"{server}/api/v1/repos/{owner_repo}/releases/latest"
+                resp = requests.get(api_url, timeout=10)
+                if resp.status_code == 200:
+                    data = resp.json()
+                    latest_tag = (data.get("tag_name") or data.get("name") or "").strip()
+                    release_url = data.get("html_url") or f"{server}/{owner_repo}/releases"
+            except Exception:
+                pass
+
+            # Fallback to RSS if API didn't produce a tag
+            if not latest_tag:
+                try:
+                    rss_url = f"{server}/{owner_repo}/releases.rss"
+                    r2 = requests.get(rss_url, timeout=10)
+                    if r2.status_code == 200 and r2.text:
+                        # Find the first /releases/tag/<tag>
+                        m = re.search(r"/releases/tag/([\w\.-]+)", r2.text)
+                        if m:
+                            latest_tag = m.group(1)
+                            release_url = f"{server}/{owner_repo}/releases/tag/{latest_tag}"
+                except Exception:
+                    pass
+
+            if latest_tag:
+                def show_latest():
+                    self.latest_var.set(f"latest: {latest_tag}")
+                    if latest_tag != __version__:
+                        # Open a modal dialog prompting to download or ignore
+                        self._show_update_dialog(latest_tag, release_url or f"{server}/{owner_repo}/releases")
+                self.after(0, show_latest)
+            else:
+                self.after(0, lambda: self.latest_var.set("latest: unavailable"))
+        except Exception:
+            pass
+
+    def _show_update_dialog(self, latest_tag: str, url: str) -> None:
+        try:
+            dlg = tk.Toplevel(self)
+            dlg.title("Update Available")
+            dlg.configure(bg=BG)
+            dlg.resizable(False, False)
+            dlg.transient(self)
+            dlg.grab_set()
+
+            frame = ttk.Frame(dlg, style="Panel.TFrame")
+            frame.pack(fill=tk.BOTH, expand=True, padx=12, pady=12)
+
+            ttk.Label(frame, text=f"A new version is available:", style="TLabel").pack(anchor="w")
+            ttk.Label(frame, text=f"Current: {__version__}", style="TLabel").pack(anchor="w", pady=(4,0))
+            ttk.Label(frame, text=f"Latest:  {latest_tag}", style="TLabel").pack(anchor="w")
+
+            link = ttk.Label(frame, text=url, style="TLabel", foreground=ACCENT)
+            link.pack(anchor="w", pady=(8, 12))
+            link.bind("<Button-1>", lambda e: self._open_link(url))
+
+            btns = ttk.Frame(frame, style="TFrame")
+            btns.pack(fill=tk.X)
+            ttk.Button(btns, text="Ignore", command=dlg.destroy).pack(side=tk.RIGHT)
+            # Auto-Install button (only meaningful for frozen exe)
+            auto_btn = ttk.Button(btns, text="Auto-Install", command=lambda: (dlg.destroy(), self._auto_install_update(latest_tag, url)))
+            auto_btn.pack(side=tk.RIGHT, padx=(0,8))
+            if not getattr(sys, 'frozen', False):
+                try:
+                    auto_btn.state(['disabled'])
+                except Exception:
+                    pass
+            ttk.Button(btns, text="Download", command=lambda: (self._open_link(url), dlg.destroy())).pack(side=tk.RIGHT, padx=(0,8))
+
+            # Center over parent
+            try:
+                self.update_idletasks()
+                px = self.winfo_rootx() + (self.winfo_width() - dlg.winfo_reqwidth()) // 2
+                py = self.winfo_rooty() + (self.winfo_height() - dlg.winfo_reqheight()) // 2
+                dlg.geometry(f"+{px}+{py}")
+            except Exception:
+                pass
+        except Exception:
+            # Fallback to simple prompt
+            if messagebox.askyesno("Update Available", f"Latest: {latest_tag}\nOpen download page?", parent=self):
+                self._open_link(url)
+
+    def _auto_install_update(self, latest_tag: str, release_page_url: str) -> None:
+        try:
+            import requests, zipfile, io, tempfile, subprocess
+            owner_repo = os.getenv("SEALOADER_REPO", "HRiggs/SeaLoader")
+            server = os.getenv("SEALOADER_GITEA", "https://git.hudsonriggs.systems")
+
+            # Try to find asset URL via API for the given tag
+            asset_url = None
+            try:
+                api = f"{server}/api/v1/repos/{owner_repo}/releases/tags/{latest_tag}"
+                r = requests.get(api, timeout=15)
+                if r.status_code == 200:
+                    data = r.json()
+                    attachments = data.get('assets') or data.get('attachments') or []
+                    for a in attachments:
+                        name = a.get('name') or ''
+                        url = a.get('browser_download_url') or a.get('download_url') or a.get('url')
+                        if name == 'SeaLoader_Windows_x64.zip':
+                            asset_url = url if (url and url.startswith('http')) else (f"{server}{url}" if url else None)
+                            break
+            except Exception:
+                pass
+
+            if not asset_url:
+                # Fallback to conventional download URL
+                asset_url = f"{server}/{owner_repo}/releases/download/{latest_tag}/SeaLoader_Windows_x64.zip"
+
+            # Download zip
+            resp = requests.get(asset_url, timeout=60, stream=True)
+            resp.raise_for_status()
+            buf = io.BytesIO(resp.content)
+
+            # Extract SeaLoader.exe from zip to temp
+            tmpdir = tempfile.mkdtemp(prefix='sealoader_update_')
+            with zipfile.ZipFile(buf) as zf:
+                target_member = None
+                for m in zf.infolist():
+                    if m.filename.endswith('SeaLoader.exe') and not m.is_dir():
+                        target_member = m
+                        break
+                if not target_member:
+                    messagebox.showerror("SeaLoader", "Update package missing SeaLoader.exe")
+                    return
+                new_exe_path = os.path.join(tmpdir, 'SeaLoader.exe')
+                with zf.open(target_member) as src, open(new_exe_path, 'wb') as dst:
+                    dst.write(src.read())
+
+            # Determine current exe path
+            if not getattr(sys, 'frozen', False):
+                messagebox.showinfo("SeaLoader", "Auto-install is only available in the packaged EXE.")
+                return
+            current_exe = sys.executable
+
+            # Create updater PowerShell script
+            ps_path = os.path.join(tmpdir, 'sealoader_updater.ps1')
+            pid_val = os.getpid()
+            target_val = current_exe.replace("'", "''")
+            source_val = new_exe_path.replace("'", "''")
+            ps = """
+$ErrorActionPreference = 'Stop'
+$pidToWait = {pid}
+$target = '{target}'.Replace("'","''")
+$source = '{source}'.Replace("'","''")
+while (Get-Process -Id $pidToWait -ErrorAction SilentlyContinue) {{ Start-Sleep -Milliseconds 200 }}
+Move-Item -Force -LiteralPath $source -Destination $target
+Start-Process -FilePath $target
+Remove-Item -LiteralPath $PSCommandPath -Force
+""".format(pid=pid_val, target=target_val, source=source_val)
+            with open(ps_path, 'w', encoding='utf-8') as f:
+                f.write(ps)
+
+            # Launch updater and exit
+            subprocess.Popen(["powershell", "-ExecutionPolicy", "Bypass", "-NoProfile", "-File", ps_path], close_fds=True)
+            self.after(200, self.destroy)
+        except Exception as exc:
+            messagebox.showerror("SeaLoader", f"Auto-install failed: {exc}")
+
 
 def main() -> None:
     ini_path = DEFAULT_INI_PATH

sealoader_version.py

@@ -0,0 +1 @@
+__version__ = "0.0.0-dev"

steam_required_ids.py

@@ -136,6 +136,45 @@ def extract_required_item_ids(url: str) -> List[str]:
     return sorted(found_ids, key=int)
 
 
+def extract_required_item_ids_for_id(pub_id: str) -> List[str]:
+    """Fetch required items for a specific Workshop item ID, including itself."""
+    page_url = f"https://steamcommunity.com/sharedfiles/filedetails/?id={pub_id}"
+    html = fetch_page(page_url)
+    found_ids = extract_required_item_ids_from_html(html)
+    if pub_id:
+        found_ids.add(pub_id)
+    return sorted(found_ids, key=int)
+
+
+def expand_required_ids_recursive(initial_ids: List[str], max_pages: int = 200) -> List[str]:
+    """Expand a set of Workshop IDs by following 'Required items' recursively.
+
+    - Starts from initial_ids
+    - For each id, fetches its page and collects its required items
+    - Continues breadth-first until no new IDs are found or max_pages is reached
+    """
+    queue: List[str] = [i for i in initial_ids if i and i.isdigit()]
+    visited: Set[str] = set()
+    all_ids: Set[str] = set(queue)
+
+    while queue and len(visited) < max_pages:
+        current = queue.pop(0)
+        if current in visited:
+            continue
+        visited.add(current)
+        try:
+            deps = extract_required_item_ids_for_id(current)
+        except Exception:
+            deps = [current]
+        for dep in deps:
+            if dep not in all_ids:
+                all_ids.add(dep)
+                if dep not in visited:
+                    queue.append(dep)
+
+    return sorted(all_ids, key=int)
+
+
 def resolve_workshop_names(ids: List[str], timeout: int = 20) -> Dict[str, str]:
     """Resolve Workshop IDs to human-readable titles using Steam API, with HTML fallback.