Confirmedusers, editor
348
edits
Installing the game on MacOS: Difference between revisions
From Vintage Story Wiki
no edit summary
No edit summary |
|||
| Line 4: | Line 4: | ||
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 works very well and is close to being able to say again that it officially supports macOS. \o/ | 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 works very well and is close to being able to say again that it officially supports macOS. \o/ | ||
== Game data folder == | |||
On macOS the game data folder is at filepath: <code>/users/{your username}/.config/VintagestoryData</code>. This is a different location from Windows/Linux, the reason is that historically that was where .NET applications were advised to place their data on macOS, and it has been kept that way for backwards compatibility reasons. | |||
If you prefer to find the game data folder at some other location, the simplest solution is to create an alias for <code>/users/{your username}/.config/VintagestoryData</code> and then drag that alias to the new location. | |||
== Installation on macOS with Intel silicon == | == Installation on macOS with Intel silicon == | ||
| Line 17: | Line 23: | ||
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]. | 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 run the game the first time, you'll need to [https://www.howtogeek.com/205393/gatekeeper-101-why-your-mac-only-allows-apple-approved-software-by-default/ tell your Mac that it's OK] to run this app from an 'Unidentified developer'. If you simply double-click the app to run it, it will only give you options to move it to Bin or to Cancel, press Cancel. Instead, to tell your Mac it's OK, hold the Command key, click on vintagestory.app, and select Open. A box will appear asking 'Are you sure you want to open it?' Click the Open button (coloured white), and this security check will be satisfied. You only need to give this security approval once. | To run the game the first time, you'll need to [https://www.howtogeek.com/205393/gatekeeper-101-why-your-mac-only-allows-apple-approved-software-by-default/ tell your Mac that it's OK] to run this app from an 'Unidentified developer'. If you simply double-click the app to run it, it will only give you options to move it to Bin or to Cancel, so press Cancel. Instead, to tell your Mac it's OK, hold the Command key, click on vintagestory.app, and select Open. A box will appear asking 'Are you sure you want to open it?' Click the Open button (coloured white), and this security check will be satisfied. You only need to give this security approval once. | ||
===Known issues generally on macOS:=== | |||
====Known current issues==== | |||
* on Apple silicon (M1/M2/M3) only, the hotbar and other HUD elements may become (temporarily) invisible while knapping stone, clayforming clay, or smithing on the anvil, this issue is under investigation; look away at some other block (with a black block outline around it) to restore the HUD | |||
* in the Settings / Graphics menu, the brown menu background is too small in size so that some settings extend beyond it | |||
====Issues in older game versions==== | |||
* prior to game version 1.19.0-rc.8, macOS versions required additional manual installation steps, see details in separate section below | * prior to game version 1.19.0-rc.8, macOS versions required additional manual installation steps, see details in separate section below | ||
* in 1.18 game versions, on certain Mac hardware, the sky was colored red not its correct blue color. This has been fixed in all 1.19 releases \o/ | * in 1.18 game versions, on certain Mac hardware, the sky was colored red not its correct blue color. This has been fixed in all 1.19 releases \o/ | ||
* prior to game version 1.19.0-rc.7, 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 was to manually edit both ''info.plist'' files found in the vintagestory.app folder, to add the following text: <code><key>NSHighResolutionCapable</key><false/></code> | * prior to game version 1.19.0-rc.7, 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 was to manually edit both ''info.plist'' files found in the vintagestory.app folder, to add the following text: <code><key>NSHighResolutionCapable</key><false/></code> | ||
* prior to 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 from game version 1.18.8 | * prior to 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 from game version 1.18.8 | ||
== Installation on MacOS with Apple silicon == | == Installation on MacOS with Apple silicon == | ||
| Line 32: | Line 43: | ||
''Currently'' as of game version 1.19.0, Vintage Story does not run "natively" on Arm64 hardware, but the x64 build of the game (the same as for MacOS with Intel silicon) can be run successfully and with decent performance, 120fps has been reported. For most players, the x64 build should "just work" (TM), this is the magic of Rosetta. If for some reason Rosetta does not work you can use <code>arch</code> in Terminal to run the game as detailed below. The Vintage Story developers intend in future to release a native Arm64 version of the game, but no release date for this has been announced. | ''Currently'' as of game version 1.19.0, Vintage Story does not run "natively" on Arm64 hardware, but the x64 build of the game (the same as for MacOS with Intel silicon) can be run successfully and with decent performance, 120fps has been reported. For most players, the x64 build should "just work" (TM), this is the magic of Rosetta. If for some reason Rosetta does not work you can use <code>arch</code> in Terminal to run the game as detailed below. The Vintage Story developers intend in future to release a native Arm64 version of the game, but no release date for this has been announced. | ||
For installation, please follow exactly the same directions as for Intel Macs in the section above. You first need to download and install .NET 7 Runtime (macOS x64 version), see link above, if you do not already have that on your computer. Then download the macOS version of Vintage Story, version 1.19.0-rc.8 or later, and it should simply run from <code>vintagestory.app</code> as soon as you have Unarchived it and given it permission to Open. | |||
=== Manual installation of .NET 7 Runtime === | === Manual installation of .NET 7 Runtime === | ||
