#!/usr/bin/env bash
#
# deckport install helper — Black & White
# status: needs-test · engine: other · type: proton
#
# Generated from black-and-white.toml on the deckport recipe site.
# Recipes describe how to CONFIGURE a game — never where to obtain it.
#
# Community guides for this game:
#   - PCGamingWiki — Black & White: https://www.pcgamingwiki.com/wiki/Black_%26_White
#   - SteamDeckHQ — Classics on Steam Deck #1 (UT3 / Black & White): https://steamdeckhq.com/news/unreal-tournament-3-black-white-steam-deck/
#   - openblack/bw1-patches — compatibility & widescreen patches: https://github.com/openblack/bw1-patches
#   - Black & White Community (bwgame.net) — unofficial patch & Win10 guide: https://www.bwgame.net/threads/running-black-white-on-windows-10.7916/
#
# 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 black-and-white.deckport.sh
#
set -euo pipefail

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

GAME_TITLE="Black & White"
BINARY="runblack.exe"
GAME_TYPE="proton"
REQUIRES=("runblack.exe" "data\\CreatureMesh.bwm")

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/black-and-white.toml" <<'DECKPORT_RECIPE_TOML'
[game]
title = "Black & White"
slug = "black-and-white"
type = "proton"
engine = "other"
aliases = ["Black and White", "B&W", "Black & White: Creature Isle"]
steam_appid = ""

[launch]
binary = "runblack.exe"
launch_options = ""
requires_files = ["runblack.exe", "data\\CreatureMesh.bwm"]

[proton]
version = "Proton Experimental"
winetricks = ["d3dx9", "vcrun2005"]

[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: Proton Experimental"
say "winetricks this game expects: d3dx9, vcrun2005"

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