#!/usr/bin/env bash
#
# deckport install helper — StarCraft + Brood War
# status: needs-test · engine: other · type: proton
#
# Generated from starcraft.toml on the deckport recipe site.
# Recipes describe how to CONFIGURE a game — never where to obtain it.
#
# Community guides for this game:
#   - Official Blizzard Free Download Page: https://starcraft.com/en-us/articles/20674424
#   - PCGamingWiki — StarCraft: https://www.pcgamingwiki.com/wiki/StarCraft
#   - GamingOnLinux — Install Battle.net on SteamOS / Steam Deck (WoW & StarCraft): https://www.gamingonlinux.com/guides/view/how-to-install-battle-net-on-linux-steamos-and-steam-deck-for-world-of-warcraft-and-starcraft/
#   - GamingOnLinux — GE-Proton 9-23 Battle.net launcher fix: https://www.gamingonlinux.com/2025/01/ge-proton-9-23-released-with-a-battlenet-fix-for-linux-steam-deck/
#
# ON YOUR STEAM DECK (Desktop Mode), with STEAM CLOSED:
#   1. Copy the game's whole folder into ~/Games/
#   2. Put the importer in your home folder:  ~/deckport.py
#   3. Run:  bash starcraft.deckport.sh
#
set -euo pipefail

GAMES_DIR="${GAMES_DIR:-$HOME/Games}"
IMPORTER="${IMPORTER:-$HOME/deckport.py}"
TAG="${TAG:-Ported Games}"

GAME_TITLE="StarCraft + Brood War"
BINARY="Battle.net Launcher.exe"
GAME_TYPE="proton"
REQUIRES=()

say()  { printf '  %s\n' "$*"; }
die()  { printf 'error: %s\n' "$*" >&2; exit 1; }

printf '\n=== deckport: %s ===\n' "$GAME_TITLE"

[ -d "$GAMES_DIR" ] || die "drop directory $GAMES_DIR not found — create it and copy the game folder in"
[ -f "$IMPORTER" ]  || die "importer not found at $IMPORTER — copy deckport.py to your home folder"

# Refuse to clobber shortcuts.vdf while Steam is running (it rewrites on exit).
if pgrep -x steam >/dev/null 2>&1; then
  die "Steam is running — close it fully first, then re-run this script"
fi

# Locate the folder that holds the game binary.
GAME_DIR=""
if [ -n "$BINARY" ]; then
  GAME_DIR="$(find "$GAMES_DIR" -maxdepth 4 -name "$BINARY" -printf '%h\n' 2>/dev/null | head -n1 || true)"
fi
[ -n "$GAME_DIR" ] || die "could not find '$BINARY' under $GAMES_DIR — copy the game folder there first"
say "found game folder: $GAME_DIR"

# Required data files must sit beside the binary.
for f in "${REQUIRES[@]:-}"; do
  [ -z "$f" ] && continue
  if [ -e "$GAME_DIR/$f" ]; then say "ok: $f present"
  else die "missing required file: $f (must sit beside the binary)"; fi
done

# Write this game's recipe to a temp folder and hand it to the importer with
# --recipes, so it applies the PINNED binary, launch options and Proton version
# (not just auto-detect). Cleaned up on exit. Needs Python 3.11+ for TOML; if
# that's missing the importer says so and still registers the shortcut.
RECIPE_DIR="$(mktemp -d)"
trap 'rm -rf "$RECIPE_DIR"' EXIT
cat > "$RECIPE_DIR/starcraft.toml" <<'DECKPORT_RECIPE_TOML'
[game]
title = "StarCraft + Brood War"
slug = "starcraft"
type = "proton"
engine = "other"
aliases = ["StarCraft", "StarCraft Brood War", "StarCraft 1", "SC1"]
steam_appid = ""

[launch]
binary = "Battle.net Launcher.exe"
launch_options = ""
requires_files = []

[proton]
version = "GE-Proton"
winetricks = []

[meta]
status = "needs-test"
DECKPORT_RECIPE_TOML

say "registering with Steam (applying recipe)…"
python3 "$IMPORTER" --games-dir "$GAMES_DIR" --recipes "$RECIPE_DIR" --tag "$TAG"

say "Proton applied automatically: GE-Proton"
say "NOTE: this needs a GE-Proton build installed — add one via ProtonUp-Qt if the game won't launch."

printf '\nDone. Reopen Steam / return to Game Mode — look under "%s".\n\n' "$TAG"