flatpak guide: replacing flatpak version with 20.0

[god_ferny]

first time writing a guide so this might be sloppy but i will continue to edit it with updated information and a cleaner layout

first things first download the flatpak vintage story image from the flatpak repo: the offical link

next navigate to the flatpak install folder

default on debain based systems

/var/lib/flatpak 

the navigate to the vintage story files

/app/at.vinstagestory.VintageStory

now we need to find the actual game files, which is very hidden and kinda annoying to get to so here is MY full path

/var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra

now you could delete the outdated vs files by running

BE CAREFUL WITH RM -RF WITH AS SUDO IT CAN IRREVERSIBLY DELETE THINGS WITHOUT WARNING

sudo rm -rf /var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra/vintagestory

then extracting the client tar in its place (thank you @Salzor)

sudo tar -xvzf /path/to/vs_client_linux-x64_*.tar.gz -C /var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra/

you can get the zip from the downloads portal and this guide should work for any version of VS

remeber to change "/path/to/vs_client/" to the path of your downloaded tar usually located in "~/Downloads/"

make sure your game is now installed to

/var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra/

 

 

 

done! now the vintage story flatpak shortcut should open v1.20.0-rc.1 or any other verison, this doesn't need to be a 20.0 specific guide

 

here is a simple shell script to do everything automatically, to use it simple just create a .sh file and paste this in, then chmod +x name.sh

my github to the script for anyone who wants to download it directly

#! /bin/bash
#Defined Vars

REMOTE_FILE_URL="https://cdn.vintagestory.at/gamefiles/unstable/vs_client_linux-x64_1.20.0-rc.6.tar.gz"  # URL of the remote file
REMOTE_FILE_DOWNLOAD="/home/$USER/Downloads/vs_client.tar.gz"      # Local path to save the file
VS_FLATPAK_DIR="var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra/vintagestory/"


if [ -d "$VS_FLATPAK_DIR" ]; then
        echo "please input your password when asked to delete the required files, make sure you backup everything vs related"

        echo "deleting vs data"
        sudo rm -rf VS_FLATPAK_DIR

        wget "$REMOTE_FILE_URL" -O "$REMOTE_FILE_DOWNLOAD"

        echo "now extracting the tar in its place"
        sudo tar -xvzf /home/$USER/Downloads/vs_client.tar.gz -C /var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra/

        echo "vs should now be installed! enjoy~"
else
        echo "vs is not installed via flatpak"
fi

 

 

rm table

r - recursive
f - force without asking

tar table

x - extract files from an archive 
v - verbosely list files processed 
z - filter the archive through gzip
f - use archive file or device ARCHIVE 
C - change to directory DIR

Edited December 24, 2024 by god_ferny
adding helper script

[er3shkigal]

I'm just dropping by to note this worked for me. Thank you again, god_ferny!

[Deadeye_Rob]

Sadly this wont work on my Steamdeck. The Flatpak files reside within the /root file tree. As a consequence, it is locked as read only until I can obtain Linux console god powers.

[god_ferny]

1 minute ago, Deadeye_Rob said:

Sadly this wont work on my Steamdeck. The Flatpak files reside within the /root file tree. As a consequence, it is locked as read only until I can obtain Linux console god powers.

setting up sudo on a steam deck is incredibly easy. infact this is the method i used on my deck and main pc. i would suggest doing a quick google search on how to use sudo on a deck 

[Salzor]

Hi,

thank you. Works for me too.

You could add the commad to extract the files into the game folder.

sudo tar -xvzf /path/to/vs_client_linux-x64_*.tar.gz -C /var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra/

options:

x - extract files from an archive 
v - verbosely list files processed 
z - filter the archive through gzip
f - use archive file or device ARCHIVE 
C - change to directory DIR 

Edited December 22, 2024 by Salzor

[god_ferny]

Just now, Salzor said:

Hi,

thank you. Works for me too.

You could add the commad to extract the files into the game folder.

sudo tar -xvzf /path/to/vs_client_linux-x64_*.tar.gz -C /var/lib/flatpak/app/at.vintagestory.VintageStory/current/active/files/extra/

 

thank you! i’ll add it to the guide as soon as i’m home tonight! 

[Andrei Panitkov]

Works with vs 1.20-rc5 on nixos. Thank you!

[god_ferny]

16 minutes ago, Andrei Panitkov said:

Works with vs 1.20-rc5 on nixos. Thank you!

np! enjoy!