Installing the game on Linux

From Vintage Story Wiki
Other languages:

Vintage Story uses the .NET Framework. On a Windows machine, .NET is integrated with the OS or at least easily installed. Although the .NET Framework was originally designed to target Windows platforms, it can also be run on other Operating Systems, specifically Linux, with some additional steps.


Installing mono

In order to play Vintage Story on Linux, you will need to use a utility called mono. This will allow you to run other .NET Framework applications too, and also create your own mods. Mono version 5 or later is needed.

  • When installing mono on Ubuntu/Debian/Raspbian/CentOS/Fedora, please refer to the instructions here.
  • When installing mono on Arch Linux or any Arch-based distro (Manjaro, Antergos, etc), refer to the instructions here.

Installing openal

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, install it using this command: apt-get install libopenal-dev Any issues with this, search up how to install OpenAL.

Launching the game

After installing mono (and perhaps also openal), you're ready to start the game.

  • Open a new terminal.
  • Navigate to the game folder.
  • Type mono Vintagestory.exe and hit enter.

Some people have reported that the game needs to be run from the game's install folder, the first time (when it accesses the login server) but can be run from a desktop script after that.

The game files also contain a script, install.sh that is intended to install the game in ~/ApplicationData/vintagestory/ 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.

Troubleshooting

If you have any issues, the Forum thread on working linux setups might help you considerably. Please do share your own experiences there.

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

If you cannot log in, try running sudo cert-sync /etc/ssl/certs/ca-certificates.crt or sudo cert-sync /etc/pki/tls/certs/ca-bundle.crt.

Some people report minor graphical issues which are platform and driver dependent. Vintage Story makes use of a large variety of GLSL shaders for its rendering effects including commonplace elements such as grass and leaf colors in different climates. Bugs in the GPU driver's implementation of GLSL may cause artifacts with some of these. The in-game Graphics settings give high level control over many of the effects, you can try different settings.

Retrieved from "https://wiki.vintagestory.at/index.php?title=Installing_the_game_on_Linux&oldid=18098"