Installing the game on MacOS: Difference between revisions

From Vintage Story Wiki
Line 3: Line 3:
Since game version 1.18.8, Vintage Story is generally compatible with most types of hardware running MacOS, subject to certain issues experienced on some setups.  See separate section below for MacOS with Apple silicon, such as recent (late 2023) M1 Mac.
Since game version 1.18.8, Vintage Story is generally compatible with most types of hardware running MacOS, subject to certain issues experienced on some setups.  See separate section below for MacOS with Apple silicon, such as recent (late 2023) M1 Mac.


It is necessary first to install .NET 7 runtime, any recent version, for example 7.0.14.  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.14''', MacOS version, x64 version.
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.  With you Mac password give it permission to install and it should automatically install.


To install Vintage Story, in the [https://account.vintagestory.at/ Client Area] select the '''Mac OS App'''.  Download that and make sure you can access its folder <code>~/Downloads/vintagestory.app/</code>, you may want to create a shortcut to the folder.  If you run into difficulty, ask for help on Discord or on a [https://www.vintagestory.at/forums/topic/11017-mac-users-does-the-net7-build-work-for-you/ suitable Forum thread].
Then to install Vintage Story, in the [https://account.vintagestory.at/ Client Area] select the '''Mac OS App'''.  Download that and make sure you can access its folder <code>~/Downloads/vintagestory.app/</code>, you may want to create a shortcut to the folder.  If you run into difficulty, ask for help on Discord or on a [https://www.vintagestory.at/forums/topic/11017-mac-users-does-the-net7-build-work-for-you/ suitable Forum thread].


Which game version to download?  To see all versions click on [https://account.vintagestory.at/#otherversions (Show all available downloads and mirrors of Vintage Story)] and you can choose between Stable and Unstable tabs.  At the time of writing (January 2024) we recommend the latest 1.19 version (1.19.0-rc.6) under the Unstable tab.  Although that one is tagged Unstable meaning that it may have some minor new issues with newly added features, generally it fixes numerous things since 1.18.15, including the sky color issue mentioned below.  However, if you want to play multiplayer on a server which is still running game version 1.18.15 (for example) then you would need to install Vintage Story version 1.18.15 of course.
Which game version to download?  To see all versions click on [https://account.vintagestory.at/#otherversions (Show all available downloads and mirrors of Vintage Story)] and you can choose between Stable and Unstable tabs.  At the time of writing (January 2024) we recommend the latest 1.19 version (1.19.0-rc.6) under the Unstable tab.  Although that one is tagged Unstable meaning that it may have some minor new issues with newly added features, generally it fixes numerous things since 1.18.15, including the sky color issue mentioned below.  However, if you want to play multiplayer on a server which is still running game version 1.18.15 (for example) then you would need to install Vintage Story version 1.18.15 of course.
Confirmedusers, editor
348

edits