Installing the game on MacOS: Difference between revisions

From Vintage Story Wiki
Line 5: Line 5:
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.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.


To install Vintage Story, in the [https://account.vintagestory.at/ Client Area] click on [https://account.vintagestory.at/#otherversions (Show all available downloads and mirrors of Vintage Story)] and select the '''Mac OS App'''.  You can choose between Stable and Unstable tabs.  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].
To install Vintage Story, in the [https://account.vintagestory.at/ Client Area] select and download 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?  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? For the full options 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.


Known issues generally:
Known issues generally:
* rarely on some MacOS setups, the sky was colored red not its correct blue color, in 1.18 game versions. This has been fixed in all 1.19 releases \o/
* rarely on some MacOS setups, the sky was colored red not its correct blue color, in 1.18 game versions. This has been fixed in all 1.19 releases \o/
* if an external secondary monitor is used with a laptop, the game window resolution may be locked to the resolution of the primary screen; in 1.19 versions it might be possible to fix this by trying different windowed/fullscreen modes such as windowed borderless
* if an external monitor with high resolution is used with a MacBook, the game window resolution may not fill the full screen on the monitor; a solution is to manually edit both info.plist files found in the vintagestory.app folder, to add the following text: <code><key>NSHighResolutionCapable</key><false/></code>
* if an external trackpad or external mouse is used alongside the primary system mouse, there were previous reports that the external controller was not effective; there have been no recent reports and it is possible this has been resolved by game version 1.18.8.
* if an external trackpad or external mouse is used alongside the primary system mouse, there were past reports that the external controller was not effective; there have been no recent reports and it is possible this has been resolved by game version 1.18.8.
 


== Installation on MacOS with Apple silicon ==
== Installation on MacOS with Apple silicon ==