Installing the game on MacOS: Difference between revisions

From Vintage Story Wiki
Line 1: Line 1:
== Installation on macOS with Intel silicon ==
== Installation on macOS with Intel silicon ==


Since game version 1.18.8, Vintage Story is generally compatible with most types of hardware running MacOS.   This section describes set up on macOS with Intel Pentium or Xeon CPUs - that's most pre-2022 Macs. See separate section below for macOS with Apple silicon, such as recent M1, M2 or M3 machines.
Since game version 1.18.8, Vintage Story is generally compatible with most types of hardware running macOS. macOS was not "officially supported" but in fact the game worked on a Mac, at least if some additional steps were taken.  Since game version 1.19.0-rc.8, installation on macOS has been greatly simplified and the additional steps are no longer necessary, and Vintage Story is close once again to officially supporting macOS


It is necessary first to install .NET 7 runtime, any recent version, for example 7.0.15.  Download this from https://dotnet.microsoft.com/en-us/download/dotnet/7.0  You do not need the SDK.  You need the runtime, for example '''.NET Runtime 7.0.15''', MacOS version, x64 version.  [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-7.0.15-macos-x64-installer Direct download link]  With your Mac password give it permission to install and it should automatically install.
This section describes set up on macOS with Intel Pentium or Xeon CPUs - that's most pre-2022 Macs.  See separate section below for macOS with Apple silicon, such as recent M1, M2 or M3 machines.
 
It is necessary first to install .NET 7 runtime, any recent version, for example 7.0.15.  Download it from https://dotnet.microsoft.com/en-us/download/dotnet/7.0  You do not need the SDK.  You need the Runtime, for example '''.NET Runtime 7.0.15''', MacOS version, x64 version.  [https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-7.0.15-macos-x64-installer Direct download link]  With your Mac password give it permission to install and it should automatically install.


Then to install Vintage Story, in the [https://account.vintagestory.at/ Client Area] select the '''Mac OS App'''.  Download that, then when it has finished, in your Downloads folder, double-click the file you downloaded (normally ending with .tar) to Unarchive it.  This creates <code>vintagestory.app</code> in your Downloads folder.  If you want, you can drag <code>vintagestory.app</code> to your Applications folder or anywhere else on your Mac, and you can now delete the .tar download file.
Then to install Vintage Story, in the [https://account.vintagestory.at/ Client Area] select the '''Mac OS App'''.  Download that, then when it has finished, in your Downloads folder, double-click the file you downloaded (normally ending with .tar) to Unarchive it.  This creates <code>vintagestory.app</code> in your Downloads folder.  If you want, you can drag <code>vintagestory.app</code> to your Applications folder or anywhere else on your Mac, and you can now delete the .tar download file.
Confirmedusers, editor
348

edits