Confirmedusers, editor
348
edits
Installing the game on MacOS: Difference between revisions
From Vintage Story Wiki
→Installation on MacOS with Apple silicon
| Line 19: | Line 19: | ||
Apple's recently released Mac M1, M2 or M3 computers - all since June 2023 - use "Apple silicon" (based on ARM) for better performance, better graphics and lower power consumption. | Apple's recently released Mac M1, M2 or M3 computers - all since June 2023 - use "Apple silicon" (based on ARM) for better performance, better graphics and lower power consumption. | ||
''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, using <code>arch</code> as detailed below. The Vintage Story developers intend in future to release a native ARM64 version of the game, but this is dependent on some third-party libraries releasing ARM64 versions, which are not yet available. | ''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, using <code>arch</code> in Terminal to run some commands as detailed below. The Vintage Story developers intend in future to release a native ARM64 version of the game, but this is dependent on some third-party libraries releasing ARM64 versions, which are not yet available. | ||
The following step-by-step guide is offered by user Finn on [https://discord.com/channels/302152934249070593/1180622192027914310/1182672688527966400 Discord], originally based on a [https://www.vintagestory.at/forums/topic/11017-mac-users-does-the-net7-build-work-for-you/#comment-47058 forum post by Bohdan Vasylyshyn], reproduced here with thanks. Essentially, some of the steps described are necessary to install the .NET7 Runtime and to make Cairo work with Apple silicon, and you should only need to do this once. Cairo is a third-party code library which is used by Vintage Story for displaying all the in-game text and fonts, and it has to be present for the game to work. | The following step-by-step guide is offered by user Finn on [https://discord.com/channels/302152934249070593/1180622192027914310/1182672688527966400 Discord], originally based on a [https://www.vintagestory.at/forums/topic/11017-mac-users-does-the-net7-build-work-for-you/#comment-47058 forum post by Bohdan Vasylyshyn], reproduced here with thanks. Essentially, some of the steps described are necessary to install the .NET7 Runtime and to make Cairo work with Apple silicon, and you should only need to do this once. Cairo is a third-party code library which is used by Vintage Story for displaying all the in-game text and fonts, and it has to be present for the game to work. | ||
| Line 29: | Line 29: | ||
(You might need to tweak the filename here based on the version you've downloaded at step 2.) | (You might need to tweak the filename here based on the version you've downloaded at step 2.) | ||
: 4. Install Homebrew for x64 using these commands in Terminal: | : 4. Install Homebrew for x64 using these commands in Terminal: | ||
::: <code>cd ~/Downloads | ::: <code>cd ~/Downloads</code> | ||
mkdir homebrew | |||
curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C homebrew | ::: <code>mkdir homebrew</code> | ||
sudo mv homebrew /usr/local/homebrew | |||
export PATH=$HOME/bin:/usr/local/bin:$PATH</code> | ::: <code>curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C homebrew</code> | ||
::: <code>sudo mv homebrew /usr/local/homebrew</code> | |||
::: <code>export PATH=$HOME/bin:/usr/local/bin:$PATH</code> | |||
: 5. Install Cairo by typing the following in Terminal: | : 5. Install Cairo by typing the following in Terminal: | ||
::: <code>arch -x86_64 /usr/local/homebrew/bin/brew install cairo</code> | ::: <code>arch -x86_64 /usr/local/homebrew/bin/brew install cairo</code> | ||
| Line 40: | Line 44: | ||
::: <code>cd ~/Downloads/vintagestory.app/</code> | ::: <code>cd ~/Downloads/vintagestory.app/</code> | ||
: 8. Copy (symlink) the Cairo library into the game folder, basically inside 'vintagestory.app' | : 8. Copy (symlink) the Cairo library into the game folder, basically inside 'vintagestory.app' | ||
::: <code>ln -s /usr/local/homebrew/lib/libcairo.2.dylib libcairo.so.2.dylib | ::: <code>ln -s /usr/local/homebrew/lib/libcairo.2.dylib libcairo.so.2.dylib</code> | ||
ln -s /usr/local/homebrew/lib/libcairo.2.dylib libcairo.2.dylib</code> | ::: <code>ln -s /usr/local/homebrew/lib/libcairo.2.dylib libcairo.2.dylib</code> | ||
: 9. Run the game (you'll need to do this every time you want to play) | : 9. Run the game (you'll need to do this every time you want to play) | ||
::: <code>arch -x86_64 ./Vintagestory</code> | ::: <code>arch -x86_64 ./Vintagestory</code> | ||
Optionally, you can also place the Game file into your applications folder and start it from there. | Optionally, you can also place the Game file into your applications folder and start it from there. | ||
