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: | ||
==== Earlier history ==== | ==== Earlier history ==== | ||
Back before 2021, Vintage Story worked on Macs, but successive changes in access to mouse and other hardware features in macOS updates then broke it for a while... until from game version 1.18.8, Vintage Story became again generally compatible with most types of hardware running macOS. macOS was not "officially supported" prior to game version 1.19 but it was unofficially supported: the (official!) downloads page offered a macOS build and the game worked reasonably well on a Mac if some additional steps were taken as detailed in the [[#Versions_prior_to_1.19.0:_set_up_using_Homebrew|final section below]]. Since game version 1.19.0, installation on macOS was simplified and those additional steps became no longer necessary, and Vintage Story now works well on a Mac - at least, equally well as the Windows and Linux versions! | |||
== Game data folder == | == Game data folder == | ||
| Line 16: | Line 16: | ||
== Retina displays == | == Retina displays == | ||
Most modern Macs have very high resolution Retina displays, and the desktop resolution is downscaled so that text and graphics do not look too tiny. For example, a Macbook Air can have an actual hardware display resolution of 2560 x 1600, but the desktop resolution by default will be 1680 x 1050. | |||
On a fresh installation of the game on macOS, Vintage Story will make an initial guess at a reasonable scaling factor for the in-game GUI, including the main menu and the Settings menu. From game version 1.19.2 this guess is reasonably good, but if it seems wrong the normal solution is to go to the in-game Settings / Interface menu and change it; the Settings menu can be accessed either from the Main Menu or in-game from the Pause menu. | On a fresh installation of the game on macOS, Vintage Story will make an initial guess at a reasonable scaling factor for the in-game GUI, including the main menu and the Settings menu. From game version 1.19.2 this guess is reasonably good, but if it seems wrong the normal solution is to go to the in-game Settings / Interface menu and change it; the Settings menu can be accessed either from the Main Menu or in-game from the Pause menu. | ||
Occasionally (especially with game versions 1.19. | Occasionally (especially with game versions prior to 1.19.2) the GUI scaling might initially be so large on some Retina displays that it causes the Settings menu Interface tab to be off-screen, making it impossible to adjust the GUI scaling in-game. To fix this problem, exit the game, find the [[Installing_the_game_on_MacOS#Game_data_folder|data folder]], and edit the <code>clientsettings.json</code> file in a decent text editor. Search for the <code>"guiScale": </code> setting and set it to a lower value, like 1.0 or 0.75. (You need a text editor which can edit a plain text file, such as ''Notepad++'', ''Brackets'', or ''Sublime Text''. Do not use the macOS in-built TextEdit, that one writes in rtf format which can really mess things up!) | ||
== Asian fonts == | |||
If you want to play the game on a Mac with your in-game language set to Chinese (Simplified), Chinese (Traditional), Japanese, Korean or Thai ... or possibly other future languages still to come ... then you may experience invisible text (empty boxes instead of language characters) on first starting the game in those languages. | |||
The solution is to edit the <code>clientsettings.json</code> file (see tips above) to include appropriate font choices for your preferred language. Look for two lines similar to this in the clientsettings file, and edit them to use appropriate font names - choose the names of fonts available on your Mac for your preferred language. (Note, the game may have already set these to different font names, it is attempting to choose fonts which are good for these languages but you may not have these fonts installed on a Mac.)<code> | |||
"defaultFontName": "sans-serif", | |||
"decorativeFontName": "Lora",</code> | |||
== Installation on macOS with Intel silicon == | == Installation on macOS with Intel silicon == | ||
