Installing the game on MacOS: Difference between revisions

From Vintage Story Wiki
Line 17: Line 17:
All or 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.
All or 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. On Retina displays, the game can sometimes guess wrong and choose an initial GUI scaling which is uncomfortably large, it might even cause some of the Settings menu tabs and buttons to be off-screen making it difficult to adjust the GUI scaling to something better.  If you are unable to change the GUI scaling in the in-game Settings / Interface menu, then to fix this problem, exit the game, go to the [[Installing_the_game_on_MacOS#Game_data_folder|data folder]], and edit the <code>clientsettings.json</code> file in a decent text editor such as ''Notepad++'', ''Brackets'', or ''Sublime Text'' (but not TextEdit, that one writes in rtf format which will mess things up)!  Search for the `"guiScale": ` setting and set it to a lower value, like 1.0 or 0.75.
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. On Retina displays, the game can sometimes guess wrong and choose an initial GUI scaling which is uncomfortably large. The normal solution is to go to the in-game Settings / Interface menu and change it; the Settings menu can be accessed from the Main Menu or in-game from the Pause menu.
 
But on some Mac displays, the initial GUI scaling might even be so large that it causes the Settings menu Interface tab to be off-screen, making it difficult to adjust the GUI scaling to something better.  If you are unable to change the GUI scaling in the Interface menu, then 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 TextEdit, that one writes in rtf format which can mess things up!)


== Installation on macOS with Intel silicon ==
== Installation on macOS with Intel silicon ==
Confirmedusers, editor
348

edits