Installing the game on Linux/en: Difference between revisions

From Vintage Story Wiki
Updating to match new version of source page
(Updating to match new version of source page)
Tags: Mobile edit Mobile web edit
(Updating to match new version of source page)
Line 43: Line 43:
Assuming that you already downloaded and extracted the Vintage Story for Linux, navigate to the game folder and run <code>run.sh</code> or <code>Vintagestory</code> directly.
Assuming that you already downloaded and extracted the Vintage Story for Linux, navigate to the game folder and run <code>run.sh</code> or <code>Vintagestory</code> directly.


The game files also contain a script, <code>install.sh</code> that is intended to install the game in <code>~/ApplicationData/vintagestory/</code> and create a shortcut on your desktop.  Apparently this install script doesn't work for everyone, so you may need to take these steps manually, or create the target install folder before running the script (may be a permissions issue?)  For more details please refer to the Forum thread linked below.
The game files also contain a script, <code>install.sh</code> that is intended to install the game in <code>~/.local/share/vintagestory/</code> (prior to 1.19.2 <code>~/ApplicationData/vintagestory/</code>) and create a shortcut on your desktop as well as adds support for moddb 1 click install and connect via URL (<code>vintagestoryjoin://ip:port</code>).  Apparently this install script doesn't work for everyone, so you may need to take these steps manually, or create the target install folder before running the script (may be a permissions issue?)  For more details please refer to the Forum thread linked below.


==Updating the game==
==Updating the game==


Linux users normally update the game by extracting game binary files from the tar.gz downloaded from vintagestory.at.  That should work fine, except that it is a good idea to extract those files into an '''empty folder''' where possible.  If that is not possible for some reason, then we '''strongly recommend''' that you at least delete the <code>/assets/</code> folder from your previous Vintage Story installation.  If you simply extract the archive into an existing game installation folder without deleting <code>/assets/</code>, some previous asset files will remain, leading to minor issues - e.g. unintended blocks or items in the game, duplicated guides in the Handbook Guides tab.
 
To update the game you can run the <code>install.sh</code> from any location, it will move the old installation to a backup location and after that move the new files to the default installation directory and reinstall the desktop entries. At the end, it will ask you if you want to delete the old installation files.
 
You can also update the game by extracting game binary files from the tar.gz downloaded from vintagestory.at.  That should work fine, except that it is a good idea to extract those files into an '''empty folder''' where possible.  If that is not possible for some reason, then we '''strongly recommend''' that you at least delete the <code>/assets/</code> folder from your previous Vintage Story installation.  If you simply extract the archive into an existing game installation folder without deleting <code>/assets/</code>, some previous asset files will remain, leading to minor issues - e.g. unintended blocks or items in the game, duplicated guides in the Handbook Guides tab.


(To make things more complicated, some of the downloads with sizes around 50MB contain all the game files except for music.  In that case, you shouldn't delete the whole of the <code>/assets/</code> folder because you would lose the music you already have: instead delete everything in <code>/assets/</code> except for the subfolders <code>/assets/game/music</code> and <code>/assets/survival/music</code> - keep those subfolders.)
(To make things more complicated, some of the downloads with sizes around 50MB contain all the game files except for music.  In that case, you shouldn't delete the whole of the <code>/assets/</code> folder because you would lose the music you already have: instead delete everything in <code>/assets/</code> except for the subfolders <code>/assets/game/music</code> and <code>/assets/survival/music</code> - keep those subfolders.)
43,178

edits