Installing the game on Linux: Difference between revisions

From Vintage Story Wiki
Line 34: Line 34:
==Troubleshooting==
==Troubleshooting==


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


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


For other 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.
For other 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.

Revision as of 08:57, 12 June 2021

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 only, 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.

  • 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.

The game files also contain a small script, install.sh that is intended to install the game in ~/ApplicationData/vintagestory/ and creates a shortcut on your desktop. Apparently it doesn't work for everyone, so you may need to take these steps manually.

Troubleshooting

Some players have reported needing to run sudo mono Vintagestory.exe to launch the game: 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.

For other issues, the Forum thread on working linux setups might help you.