first commit

skel_unix/modman.command

@@ -0,0 +1,55 @@
+#!/bin/sh
+
+# Get the script's name.
+me=$(basename "$0");
+
+# Get the absolute path to this script's folder.
+if echo "$0" | awk '{exit(!/^\//);}'; then
+  maindir=$(dirname "$0");
+else
+  maindir=$PWD/$(dirname "$0");
+fi
+
+
+# Spawn a terminal if this is headless (or piped) and not on an ssh socket.
+# The terminal will run another instance of this script with ${ingui}=1.
+if [ ! \( -t 0 -o -S /dev/stdin \) ]; then
+  if [ "${ingui}" = "1" ]; then
+    echo "This is a nested instance. The terminal must have spawned.";
+    echo "Yet the 'Am I  headless' test couldn't detect the terminal!?";
+    exit
+  fi
+
+  echo "Double-clicked? You need a terminal!";
+  export ingui=1;
+
+  if command -v x-terminal-emulator >/dev/null; then
+    # Linux.
+    x-terminal-emulator -e "$0";
+
+  elif command -v osascript >/dev/null; then
+    # OSX.
+    # *.command files normally get their own terminal there,
+    # but better safe than sorry.
+    # - - -
+    osascript <<EOF
+tell application "Terminal"
+  activate
+  do script "export ingui=1;cd \"${maindir}\";\"./${me}\";exit"
+end tell
+EOF
+    # - - -
+  fi
+  exit;
+fi
+
+# Finally, the payload.
+cd "${maindir}"
+# - - -
+java -jar modman.jar
+# - - -
+
+if [ "${ingui}" = "1" ]; then
+  read -p "Press enter to continue" dummyvar
+fi
+exit;

skel_unix/readme_for_unixlike.txt

@@ -0,0 +1,83 @@
+Slipstream Mod Manager
+http://
+
+
+About
+
+  Slipstream is the successor to Grognak's Mod Manager (GMM), a
+  program designed to make it easy to install multiple mods at the
+  same time.
+
+
+Requirements
+
+  Java 1.6 or higher.
+    http://www.oracle.com/technetwork/java/javase/downloads/index.html
+
+  FTL (1.01-1.03.3, Windows/OSX/Linux, Steam/GOG/Standalone).
+    http://www.ftlgame.com/
+
+
+Setup
+
+  Extract the files from this archive anywhere.
+
+  On the first run, you may be prompted to locate your
+  FTL resources. Specifically "data.dat" in the "resources\"
+  directory under your FTL install.
+
+  In most cases, this should be located automatically.
+
+
+Usage
+
+  To add a mod (an *.ftl file):
+    Put it in the Slipstream/mods/ folder.
+
+  To start the mod manager:
+    Double-click modman.jar.
+
+  To install mods:
+    Tick checkboxes to select the mods you want to install.
+    Mods at the top get clobbered by ones below. Drag names to reorder.
+    Click the "Patch" button.
+    (Any unselected mods will be omitted/uninstalled.)
+
+  To uninstall all mods:
+    Click "Patch" with none selected.
+
+  Before upgrading Slipstream:
+    Uninstall all mods, so the next version will see a clean game.
+
+  If you upgrade FTL:
+    Delete the outdated files in Slipstream/backup/
+    If you don't, the game's resources will get corrupted.
+
+
+Troubleshooting
+
+* If you get "java.lang.UnsupportedClassVersionError" on startup...
+    You need a newer version of Java.
+
+* If you get permission errors...
+    Make sure that your resource.dat and data.dat files are not read-only.
+
+* If the game shows exclamation marks for everything...
+    See the suggestion below for replacing corrupt resources.
+
+* If text in-game is shrunken and moved to the top of the screen...
+    FTL was upgraded, but Slipstream modded with backups from the old FTL.
+    When upgrading FTL in the future, delete what's in SMM/backup/ first.
+    See the suggestion below for replacing corrupt resources.
+
+* If FTL's resources are corrupt...
+    Delete the files in SMM/backup/
+    Steam users:
+      Delete FTL's resource directory:
+        Linux: "[~/.local/share or $XDG_DATA_HOME]/Steam/SteamApps/common/FTL Faster Than Light/data/resources"
+        Mac: "~/Library/Application Support/Steam/SteamApps/common/FTL Faster Than Light/FTL.app"
+      Start Steam and "verify game cache".
+        https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335
+      Run FTL, which will cause steam to copy fresh resources from its cache.
+    Standalone users:
+      Reinstall FTL.