Confirmedusers, editor
348
edits
Installing the game on MacOS: Difference between revisions
From Vintage Story Wiki
no edit summary
No edit summary |
|||
| Line 26: | Line 26: | ||
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. | 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> | 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",</code> | |||
:::<code>"decorativeFontName": "Lora",</code> | |||
==Known issues generally on macOS:== | |||
===Known current issues=== | |||
* (minor!) in game version 1.19.1, in the Settings / Graphics menu, for some players the brown menu background was too small in size so that some settings extend slightly beyond it (may be fixed in 1.19.2+, needs verification...) | |||
* Asian language fonts may require manual configuration, see above | |||
* 1-click mod install from websites does not currently work on macOS, but mods can be installed in the normal way by downloading them and drag and drop to the <code>VintagestoryData/Mods</code> folder | |||
===Issues in older game versions=== | |||
* prior to game version 1.19.2, on Apple silicon (M1/M2/M3) only, the hotbar and other HUD elements became (temporarily) invisible while knapping stone, clayforming clay, or smithing on the anvil | |||
* prior to game version 1.19.2, for some Retina displays, the GUI scaling originally chosen by the game on a clean installation was too large, potentially needing a manual edit to clientsettings.json to fix it | |||
* prior to game version 1.19.0 (actually technically the immediately prior release candidate 1.19.0-rc.8), all macOS versions required additional manual installation steps, see details in separate section below | |||
* prior to game version 1.19.0-rc.7, if an external monitor with high resolution was used with a MacBook, the game window resolution did 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>; this fix is included in all stable 1.19 releases | |||
* 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.18.8, if an external trackpad or external mouse was 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 | |||
* in older game versions prior to 1.17 and older macOS, crash on startup (NSInvalidArgumentException) could be fixed by disabling AutoHide on your menu bar | |||
* in older game versions (1.15-1.17) and older macOS, it was usually necessary to add <code>sh</code> to Input monitoring setting, in order to fix mouse issues. | |||
== Installation on macOS with Intel silicon == | == Installation on macOS with Intel silicon == | ||
| Line 43: | Line 59: | ||
To run the game the first time after downloading it, 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 two 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. | To run the game the first time after downloading it, 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 two 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. | ||
== Installation on MacOS with Apple silicon == | == Installation on MacOS with Apple silicon == | ||
