Installing the game on Linux: Difference between revisions

* A [https://flathub.org/apps/at.vintagestory.VintageStory Flatpak package] (for Fedora, Linux Mint, Manjaro, PopOS!, Red Hat, CentOS, elementary OS, SteamOS etc.) If not already installed, you can [https://flatpak.org/setup/ install Flatpak] itself as well.

If you install the game using any of these methods, you can start it by clicking the <code>Vintage Story</code> menu entry in your desktop environment's application launcher.

'''Disclaimer:''' Packages above are maintained by volunteers to the open-source community. Anego Studios can't held responsible if they don't work as intended or don't work at all. In addition, the game itself may not be always up to date with the latest stable version that's released officially.

Vintage Story client relies on three main components: .NET, OpenAL and OpenGL.

* Ubuntu ([https://packages.ubuntu.com/search?keywords=dotnet dotnet-runtime-7.0])

Microsoft also maintains official packages for [https://packages.microsoft.com/ several Linux distributions]. You can also install .NET on these systems, by adding Microsoft's repository to your package manager. This process can differ depending on the distribution and packaging system, so follow the official [https://learn.microsoft.com/en-us/dotnet/core/install/linux Install .NET on Linux] article from Microsoft website.

Finally, you can try installing .NET by using Microsoft's install script or simply manually install the downloaded binary. To do this, follow the official [https://learn.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual Install .NET on Linux by using an install script or by extracting binaries] article.

OpenAL is a cross-platform audio library, needed for the game sounds in Vintage Story. You may have it installed already, as standard or for another game or application.

If you don't have it already, OpenAL library should be already present in your distribution's package repository. Look for <code>openal</code>, <code>libopenal</code>, <code>libopenal-dev</code> or anything that provides required <code>libopenal.so</code> library.

OpenGL is a 3D graphics library and your system probably already support it via a video driver, provided by <code>mesa</code> or <code>nvidia</code> package.

If you have any issues, the Forum thread on [https://www.vintagestory.at/forums/topic/520-linux-distrosconfigurations-under-which-vs-is-known-to-run/ working linux setups] might help you considerably.  Please do share your own experiences there. You might also want to use the [https://www.vintagestory.at/forums/topic/10479-linux-beginner-guide-mesa_glthread-boost-your-performance-today/ mesa_glthread optimization], which works well for some players.  

However, many users have reported problems with the game with OpenGL threading enabled.

OpenGL threading optimization is enabled by default in some configurations and can lead to the following problems:

* Mouse cursor not registering clicks properly

* Hanging, freezing, etc.

To disable OpenGL threading, you will need to create a <code>mesa_glthread</code> environment variable and set it to <code>false</code>. You can easily test it, by launching the command line, navigating to the directory where Vintage Story resides and running the <code>mesa_glthread=false ./Vintagestory</code> command. If you don't want to use the command, look up how to make Linux environment variables permanent and restart the system.

If you installed the game using Flatpak instead, try launching it with the command: <code>flatpak run --env=mesa_glthread=false at.vintagestory.VintageStory vintagestory</code>. You can make it permanent by typing: <code>flatpak override --env=mesa_glthread=false at.vintagestory.VintageStory</code>

<!--T:25-->

Some players have reported needing to run <code>sudo ./Vintagestory</code> to launch the game the first time: this may depend on how it was installed.

<!--T:27-->