#!/bin/sh # Purpose {{{ ## Try to centralize all game's save in order to : ## easily backup all save ## easily restore it ## be able to access it from anywhere ## … all you can do with a Nextcloud (share, versionning,…) ## ## 1. Move save directories of a list of known games from Steam's userdata, ## common or compatdata directories to a remote directory (Nextcloud, remote ## mount,…). ## Then create a symlink in userdata, common or compatdata Steam directory to ## the remote game directory. ## ## 2. If a directory doesn't exist, check if a remote one is ## available and symlink it. ## ## 3. List userdata subdirectories without symlinks. ## ## KISS : Only manage save directories from Steam's directories. For other ## paths ($XDG_DATA_HOME,…) check other scripts. # }}} # Vars {{{ debug=1 ## Steam steam_id="112595584" steam_userdata=".steam/steam/userdata/${steam_id}" steam_compatdata=".steam/steam/steamapps/compatdata" steam_common=".steam/steam/steamapps/common" ## List of Steam saves in userdata to backup {{{ ### 550 − Left 4 Dead 2 − https://www.pcgamingwiki.com/wiki/Left_4_Dead_2 ### 760 − Steam Screenshots − https://steamdb.info/app/760/ ### 35140 − Batman: Arkham Asylum − https://www.pcgamingwiki.com/wiki/Batman:_Arkham_Asylum ### 35700 − Trine Enchanted Edition − https://pcgamingwiki.com/wiki/Trine_Enchanted_Edition ### 35720 − Trine 2 Complete Story − https://pcgamingwiki.com/wiki/Trine_2 ### 55230 − Saints Row: The Third − https://pcgamingwiki.com/wiki/Saints_Row:_The_Third ### 107100 − Bastion − https://www.pcgamingwiki.com/wiki/Bastion ### 113020 − Monaco − https://www.pcgamingwiki.com/wiki/Monaco:_What%27s_Yours_Is_Mine ### 200260 − Batman: Arkham City − https://www.pcgamingwiki.com/wiki/Batman:_Arkham_City ### 204360 − Castle Crashers − https://pcgamingwiki.com/wiki/Castle_Crashers ### 206420 − Saints Row IV − https://pcgamingwiki.com/wiki/Saints_Row_IV ### 207140 − SpeedRunners − https://www.pcgamingwiki.com/wiki/SpeedRunners ### 209000 − Batman: Arkham Origins − https://www.pcgamingwiki.com/wiki/Batman:_Arkham_Origins ### 214490 − Alien: Isolation − https://www.pcgamingwiki.com/wiki/Alien:_Isolation ### 218820 − Mercenary Kings − https://pcgamingwiki.com/wiki/Mercenary_Kings ### 220440 − DmC: Devil May Cry − https://www.pcgamingwiki.com/wiki/DmC:_Devil_May_Cry ### 224760 − Fez − https://www.pcgamingwiki.com/wiki/Fez ### 230270 − N++ − https://www.pcgamingwiki.com/wiki/N%2B%2B ### 242760 − The Forest − https://www.pcgamingwiki.com/wiki/The_Forest ### 247080 − Crypt of the Necrodancer − https://pcgamingwiki.com/wiki/Crypt_of_the_Necrodancer ### 255870 − PixelJunk Shooter − https://pcgamingwiki.com/wiki/PixelJunk_Shooter ### 269210 − Hero Siege − https://www.pcgamingwiki.com/wiki/Hero_Siege#Save_game_data_location ### 293780 − Crawl − https://www.pcgamingwiki.com/wiki/Crawl ### 312530 − Duck Game − https://pcgamingwiki.com/wiki/Duck_Game ### 312670 − Strange Brigade − https://www.pcgamingwiki.com/wiki/Strange_Brigade ### 330020 − Children of Morta − https://www.pcgamingwiki.com/wiki/Children_of_Morta ### 359840 − Shift Happens − https://pcgamingwiki.com/wiki/Shift_Happens ### 477160 − Human: Fall Flat − https://www.pcgamingwiki.com/wiki/Human:_Fall_Flat ### 534550 − Guacamelee! 2 − https://www.pcgamingwiki.com/wiki/Guacamelee!_2 ### 572890 − Pikuniku − https://www.pcgamingwiki.com/wiki/Pikuniku ### 690640 − Trine 4 − https://pcgamingwiki.com/wiki/Trine_4:_The_Nightmare_Prince steam_userdata_games="550 760 35140 35700 35720 55230 107100 113020 200260 204360 206420 207140 209000 214490 218820 224760 230270 220440 247080 242760 255870 269210 293780 312530 312670 359840 477160 534550 572890 690640" ## }}} ## Pattern of Steam saves in common to backup {{{ ### Add the directory name of the game and the directory|file name to backup ### separated by a slash. ### To be able to manage white space in directory name, the field separator is %. ### eg. GAME NAME/data.save%other game/*.sav ### 620 − Portal 2 − https://pcgamingwiki.com/wiki/Portal_2 (solo only, multiplayer is on Steam cloud) ### 113020 − Monaco − https://www.pcgamingwiki.com/wiki/Monaco:_What%27s_Yours_Is_Mine ### 251470 − TowerFall Ascension − https://pcgamingwiki.com/wiki/TowerFall_Ascension (not managed cause no substree, check $XDG_DATA_HOME) ### 274190 − Broforce − https://pcgamingwiki.com/wiki/Broforce ### 300580 − Galak-Z The Void − https://www.pcgamingwiki.com/wiki/Galak-Z:_The_Dimensional steam_common_games_pattern="Portal 2/*.sav%Monaco/*.xml%Broforce/*.sav%Galak-Z/*.dat" # }}} ## Pattern of Steam saves in compatdata to backup {{{ ### Compatdata contains directories for games using Steam play so it's too big ### to be fully moved to a remote storage. ### Add the game id and the directory|file name to backup separated by a slash. ### And, to be able to manage white space in pattern name, the field separator is %. ### eg. GAME_ID/savedata.xml%GAME_ID42/user.bin ### 213670 − South Park: The Stick of Truth − https://pcgamingwiki.com/wiki/South_Park:_The_Stick_of_Truth ### 242760 − The Forest − https://www.pcgamingwiki.com/wiki/The_Forest ### 312610 − Metal Slug X − https://pcgamingwiki.com/wiki/Metal_Slug_X ### 312670 − Strange Brigade − https://www.pcgamingwiki.com/wiki/Strange_Brigade ### 322210 − Guns, Gore & Cannoli − https://www.pcgamingwiki.com/wiki/Guns,_Gore_%26_Cannoli ### 359840 − Shift Happens − https://pcgamingwiki.com/wiki/Shift_Happens (don't work yet) ### 379720 − Doom (2016) − https://www.pcgamingwiki.com/wiki/Doom_(2016) ### 387290 − Ori and the Blind Forest: Definitive Edition − https://www.pcgamingwiki.com/wiki/Ori_and_the_Blind_Forest:_Definitive_Edition ### 414340 − Hellblade: Senua's Sacrifice − https://www.pcgamingwiki.com/wiki/Hellblade:_Senua%27s_Sacrifice ### 471810 − Death Squared − https://www.pcgamingwiki.com/wiki/Death_Squared ### 480490 − Prey (2017) − https://pcgamingwiki.com/wiki/Prey_(2017) (don't work yet) ### 548430 − Deep Rock Galactic − https://www.pcgamingwiki.com/wiki/Deep_Rock_Galactic ### 686200 − Door Kickers: Action Squad − https://pcgamingwiki.com/wiki/Door_Kickers:_Action_Squad ### 1104660 − MO: Astray − https://pcgamingwiki.com/wiki/MO:_Astray steam_compatdata_games_pattern="213670/save%242760/TheForest%312610/UserDefault.xml%312670/PC_ProfileSaves%322210/AdvancedPlayerPrefs.txt%379720/GAME-AUTOSAVE0%387290/saveFile0.sav%414340/SaveGames%471810/ds_save.dat%548430/Saved%686200/userdata.bin%1104660/Unity" # }}} ## Ids without backups in userdata {{{ ### 7 − Unknown ### 49520 − Borderlands 2 − https://pcgamingwiki.com/wiki/Borderlands_2 ### 219150 − Hotline Miami − https://pcgamingwiki.com/wiki/Hotline_Miami ### 232090 − Killing Floor 2 − https://www.pcgamingwiki.com/wiki/Killing_Floor_2 ### 236090 − Dust: An Elysian Tail − https://www.pcgamingwiki.com/wiki/Dust:_An_Elysian_Tail ### 241100 − Steam Controller Configs − https://steamdb.info/app/241100/ ### 261640 − Borderlands: The Pre-Sequel − https://www.pcgamingwiki.com/wiki/Borderlands:_The_Pre-Sequel ### 242680 − Nuclear Throne − https://pcgamingwiki.com/wiki/Nuclear_Throne ### 251470 − TowerFall Ascension − https://pcgamingwiki.com/wiki/TowerFall_Ascension ### 255870 − PixelJunk Shooter − https://pcgamingwiki.com/wiki/PixelJunk_Shooter ### 268990 − The Dishwasher: Vampire Smile − https://pcgamingwiki.com/wiki/The_Dishwasher:_Vampire_Smile ### 274190 − Broforce − https://pcgamingwiki.com/wiki/Broforce ### 295790 − Never Alone − https://pcgamingwiki.com/wiki/Never_Alone ### 300580 − Galak-Z The Void − https://www.pcgamingwiki.com/wiki/Galak-Z:_The_Dimensional ### 311690 − Enter the Gungeon − unity3d − https://www.pcgamingwiki.com/wiki/Enter_the_Gungeon ### 322210 − Guns, Gore & Cannoli − https://www.pcgamingwiki.com/wiki/Guns,_Gore_%26_Cannoli ### 323850 − Move or Die − https://www.pcgamingwiki.com/wiki/Move_or_Die ### 379720 − Doom (2016) − https://www.pcgamingwiki.com/wiki/Doom_(2016) ### 386940 − Ultimate Chicken Horse − https://www.pcgamingwiki.com/wiki/Ultimate_Chicken_Horse ### 387290 − Ori and the Blind Forest: Definitive Edition − https://www.pcgamingwiki.com/wiki/Ori_and_the_Blind_Forest:_Definitive_Edition ### 414340 − Hellblade: Senua's Sacrifice − https://www.pcgamingwiki.com/wiki/Hellblade:_Senua%27s_Sacrifice ### 416600 − Full Metal Furies − https://pcgamingwiki.com/wiki/Full_Metal_Furies ### 445980 − Wizard of Legend − https://www.pcgamingwiki.com/wiki/Wizard_of_Legend ### 460790 − Bayonetta − https://www.pcgamingwiki.com/wiki/Bayonetta ### 471810 − Death Squared − https://www.pcgamingwiki.com/wiki/Death_Squared ### 474210 − Butcher − https://pcgamingwiki.com/wiki/Butcher ### 504230 − Celeste − https://www.pcgamingwiki.com/wiki/Celeste ### 512900 − Streets of Rogue − https://www.pcgamingwiki.com/wiki/Streets_of_Rogue ### 548430 − Deep Rock Galactic − https://www.pcgamingwiki.com/wiki/Deep_Rock_Galactic ### 554600 − Learn Japanese To Survive! Katakana War − https://www.pcgamingwiki.com/wiki/Learn_Japanese_To_Survive!_Katakana_War ### 697660 − Jump Gunners − https://pcgamingwiki.com/wiki/Jump_Gunners ### 728880 − Overcooked! 2 − https://pcgamingwiki.com/wiki/Overcooked!_2 ### 750920 − Shadow of the Tomb Raider − https://www.pcgamingwiki.com/wiki/Shadow_of_the_Tomb_Raider ### 892970 − Valheim − https://www.pcgamingwiki.com/wiki/Valheim ### 1104660 − MO: Astray − https://pcgamingwiki.com/wiki/MO:_Astray ignore_pattern_steam_id="(7|620|49520|55230|213670|219150|232090|236090|261640|241100|242680|251470|255870|268990|274190|295790|300580|311690|322210|323850|379720|386940|387290|414340|416600|445980|460790|471810|474210|504230|480490|512900|548430|554600|686200|697660|728880|750920|892970|1104660|config|inventorymsgcache|ugc|ugcmsgcache|\.)$" ## }}} remote_dir="${HOME}/Nextcloud/games/linux.sgl.script" local_unmanaged_games_list="/tmp/unmanaged_games_list" # }}} # Functions {{{ # Move one Steam save game dir {{{ move_steam_game_dir() { _game_id="${1}" _steam_dir="${2}" _local_game_path="${HOME}/${_steam_dir}/${_game_id}" _remote_game_path="${remote_dir}/${_steam_dir}/${_game_id}" ## If a remote directory doesn't already exists for this game if [ ! -d "${_remote_game_path}" ]; then ### Ensure to create tree directories on remote storage mkdir -p -- "$(dirname "${_remote_game_path}")" ### Move data to remote storage mv -- "${_local_game_path}" "${_remote_game_path}" [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Move Steam game − The data of ${_game_id} − ${_local_game_path} moved to remote storage." ### Then ask to create a symbolic link to local storage symlink_steam_game_dir "${_game_id}" "${_steam_dir}" else printf '\e[1;35m%-6s\e[m\n' "Move Steam game − ${_game_id} already have data on remote storage : ${_remote_game_path}. Abort to avoid to override data." exit 5 fi } # }}} # Symlink one Steam save game dir from remote to local {{{ symlink_steam_game_dir() { _game_id="${1}" _steam_dir="${2}" _local_game_path="${HOME}/${_steam_dir}/${_game_id}" _remote_game_path="${remote_dir}/${_steam_dir}/${_game_id}" if [ -d "${_remote_game_path}" ]; then ln -s -- "${_remote_game_path}" "${_local_game_path}" [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Symlink Steam game — Symlink remote data of ${_game_id} to local storage." else [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Symlink Steam game — ${_game_id} doesn't have remote data." fi } # }}} # }}} # Tests {{{ ## Ensure remote dir exist {{{ if [ ! -d "${remote_dir}" ]; then printf '\e[1;35m%-6s\e[m\n' "The directory for save game doesn't exists : ${remote_dir}" exit 1 fi ## }}} ## Ensure Steam directories exist {{{ for steam_dir in "${steam_userdata}" "${steam_common}" "${steam_compatdata}"; do local_steam_path="${HOME}/${steam_dir}" if [ ! -d "${local_steam_path}" ]; then printf '\e[1;35m%-6s\e[m\n' "The Steam directory − ${steam_dir} for your ID (${steam_id}) doesn't exists yet… Should it must be create (for restoration,…) [Y/n] ?" read -r create_local_steam_userdata if [ "${create_local_steam_userdata}" = "" ] || [ "${create_local_steam_userdata}" = "Y" ] || [ "${create_local_steam_userdata}" = "y" ]; then mkdir -p -- "${local_steam_path}" else printf '\e[1;35m%-6s\e[m\n' "Steam directory (${steam_dir}) doesn't exists, abort script." exit 2 fi fi done ## }}} # }}} [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Run save game script for Steam." # Manage Steam userdata save game {{{ for game_id in ${steam_userdata_games}; do local_game_path="${HOME}/${steam_userdata}/${game_id}" local_game_path_type="$(file "${local_game_path}" | cut -d' ' -f2)" case ${local_game_path_type} in ## Data is already a symlink "symbolic") link_name="$(file "${local_game_path}" | sed 's;.* symbolic link to \(.*\);\1;')" [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam userdata for loop — The data of ${game_id} are already symlinked to ${link_name} . Skip." ;; ## Data is still a directory "directory") move_steam_game_dir "${game_id}" "${steam_userdata}" ;; ## Data doesn't exist "cannot") [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam userdata for loop — The data of ${game_id} − ${local_game_path} doesn't exist. Skip." symlink_steam_game_dir "${game_id}" "${steam_userdata}" ;; ## Data can't be managed *) printf '\e[1;35m%-6s\e[m\n' "Data of ${game_id} (userdata) − ${local_game_path} are not managed. Type: ${local_game_path_type}. Abort" exit 3 ;; esac done # }}} # Manage Steam common save game {{{ IFS="%" for game_pattern in ${steam_common_games_pattern}; do ## Separate the game_name and the directory|file to backup|symlink game_name="$(echo "${game_pattern}" | cut -d"/" -f1)" save_pattern="$(echo "${game_pattern}" | cut -d"/" -f2)" ## If the game is installed if [ -d "${HOME}/${steam_common}/${game_name}" ]; then ### Follow symbolic links but avoid links to dosdevices and keep only one result temp_local_save_path="$(find -L "${HOME}/${steam_common}/${game_name}" -iname "${save_pattern}" -print -quit)" local_save_path="$(dirname "${temp_local_save_path}")" local_save_path_type="$(ls -ld "${local_save_path}" | sed 's/\(^.\).*/\1/')" ## Path independent from local or remote base directory steam_dir="$(printf "%s" "${local_save_path}" | sed -e "s;${HOME}/;;")" ## Print vars {{{ #if [ "${debug}" -eq "0" ]; then #printf '\e[1;35m%-6s\e[m\n' "DEBUG : game name : ${game_name}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : save pattern : ${save_pattern}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : temp local save path : ${temp_local_save_path}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : local save path : ${local_save_path}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : local save type : ${local_save_path_type}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : steam dir : ${steam_dir}" #fi ## }}} case ${local_save_path_type} in ## Data is already a symlink "symbolic"|"symboliclink"|"l") link_name="$(file "${local_save_path}" | sed 's;.* symbolic link to \(.*\);\1;')" [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam common for loop — The data of ${game_name} are already symlinked to ${link_name} . Skip." ;; ## Data is still a directory, try to move it "directory"|"d") move_steam_game_dir "$(basename "${steam_dir}")" "$(dirname "${steam_dir}")" ;; ## Data doesn't exist "cannot") [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam common for loop — The data of ${game_name} − ${local_save_path} doesn't exist. Skip." ### TODO : Try to symlink ;; ## Data can't be managed *) printf '\e[1;35m%-6s\e[m\n' "Data of ${game_name} (common) − ${local_save_path} are not managed. Type: ${local_save_path_type}. Abort." exit 3 ;; esac else ## The game is not present on the system [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam common for loop — ${game_name} doesn't seems to be installed on the system, check the path : ${HOME}/${steam_common}/${game_name} . Skip." fi done # }}} # Manage Steam compatdata save game {{{ IFS="%" for game_pattern in ${steam_compatdata_games_pattern}; do ## Separate the game_id and the directory|file to backup|symlink game_id="$(echo "${game_pattern}" | cut -d"/" -f1)" save_pattern="$(echo "${game_pattern}" | cut -d"/" -f2)" ## If the game is installed if [ -d "${HOME}/${steam_compatdata}/${game_id}" ]; then ### Follow symbolic links but avoid links to dosdevices and keep only one result temp_local_save_path="$(find -L "${HOME}/${steam_compatdata}/${game_id}" -ipath "*dosdevices*" -prune -o -iname "${save_pattern}" | grep -v "dosdevices" | head -n 1)" ### Verify if the previous command successfully return an existing path if [ ! -e "${temp_local_save_path}" ]; then printf '\e[1;35m%-6s\e[m\n' "Data of ${game_id} (compatdata) − Can't find the path to ${save_pattern} pattern. Result of find : ${temp_local_save_path} . Abort." exit 3 fi local_save_path="$(dirname "${temp_local_save_path}")" local_save_path_type="$(ls -ld "${local_save_path}" | sed 's/\(^.\).*/\1/')" ## Path independent from local or remote base directory steam_dir="$(printf "%s" "${local_save_path}" | sed -e "s;${HOME}/;;")" ## Print vars {{{ #if [ "${debug}" -eq "0" ]; then #printf '\e[1;35m%-6s\e[m\n' "DEBUG : game ID : ${game_id}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : save pattern : ${save_pattern}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : temp local save path : ${temp_local_save_path}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : local save path : ${local_save_path}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : local save type : ${local_save_path_type}" #printf '\e[1;35m%-6s\e[m\n' "DEBUG : steam dir : ${steam_dir}" #fi ## }}} case ${local_save_path_type} in ## Data is already a symlink "symbolic"|"symboliclink"|"l") link_name="$(file "${local_save_path}" | sed 's;.* symbolic link to \(.*\);\1;')" [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam compatdata for loop — The data of ${game_id} are already symlinked to ${link_name} . Skip." ;; ## Data is still a directory, try to move it "directory"|"d") [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Data of ${game_id} (compatdata) − Try to move ${local_save_path} to remote share." move_steam_game_dir "$(basename "${steam_dir}")" "$(dirname "${steam_dir}")" ;; ## Data doesn't exist "cannot") [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam compatdata for loop — The data of ${game_id} − ${local_save_path} doesn't exist. Skip." ### TODO : Try to symlink ;; ## Data can't be managed *) printf '\e[1;35m%-6s\e[m\n' "Data of ${game_id} (compatdata) − ${local_save_path} are not managed. Type: ${local_save_path_type}. Abort." exit 3 ;; esac else ## The game is not present on the system [ "${debug}" -eq "0" ] && printf '\e[1;35m%-6s\e[m\n' "DEBUG : Steam compatdata for loop — ${game_id} doesn't seems to be installed on the system. Skip." fi done # }}} # List userdata unmanage game id {{{ cd -- "${HOME}/${steam_userdata}" || exit 1 rm -f -- "${local_unmanaged_games_list}" find . -maxdepth 1 -type d | grep -vE "${ignore_pattern_steam_id}" > "${local_unmanaged_games_list}" if [ -s "${local_unmanaged_games_list}" ]; then printf '\e[1;35m%-6s\e[m\n' "List of unmanaged directories :" cat "${local_unmanaged_games_list}" fi rm -f -- "${local_unmanaged_games_list}" cd -- - > /dev/null || exit 1 # }}} exit 0