====== Running GOG Jagged Alliance 2 v1.13 on Mac OS X 10.10.5+ ======

Freshly installed GOG version of Jagged Alliance 2 has poor performance, especially after applying 1.13 patch. This is a short how-to to increase performance of game and fix some bugs.


===== Downloading vanilla Jagged Alliance 2 =====

  - Download Mac version from GOG.com
  - Run the game for the first time


===== Installing v1.13 mod =====

  - Download **both** //Current official Release// and //Current official Update// files from [[http://ja2v113.pbworks.com/w/page/4218334/Downloads|Official v1.13 mod page]]
  - Move both downloaded *.exe files to ''Jagged Alliance 2.app/Contents/Resources/game/Jagged Alliance 2.app/Contents/Resources/drive_c/Program Files/GOG.com/Jagged Alliance 2/''
  - Open ''Jagged Alliance 2.app/Wineskin.app''
  - Choose ''Advanced''→''Tools''→''Utilities''→''Command Line Shell''
  - Type ''cd ..\..\Program Files\GOG.com\Jagged Alliance 2\''
  - Run both exe files (''JA2_113_FullRelease_English_7435.exe'' and ''JA2_113_UpdateForRelease7435_English_7609.exe'')
  - Run ''zPatch.bat''


===== Updating Wineskin engine =====

  - Download latest **Wineskin Winery** from [[http://wineskin.urgesoftware.com/tiki-index.php?page=Downloads|Official Wineskin page]]
  - Run ''Wineskin Winery.app''
  - Update wrapper to newest version, add new (latest) engine and exit
  - Open ''Jagged Alliance 2.app/Wineskin.app'' again
  - Choose ''Advanced''→''Tools''→''Wrapper Tools''→''Change Engine used'' and select newest engine
  - Wait for rebuild and exit Wineskin


===== Fixing flickering =====

Now with new update of Wineskin engine, game will at last run smoothly, but will flicker hardly. To stop it:
  - Open ''Jagged Alliance 2.app/Wineskin.app'' for the last time :)
  - Choose ''Advanced''→''Tools''→''Utilities''→''Winetricks''
  - Expand ''settings'' tree and enable (tick) ''ddr=gdi'' option
  - Run the script
  - Done!


===== Enabling ''alt'', ''end'' and ''delete'' key =====

For some reason, ''Option'' key is not working at all in Jagged Alliance 2 under Mac OS X. Instead, ''cmd'' key works as ''alt'', so if there is a game shortcut that requires pressing ''Alt + X'', you actually need to press ''Cmd + X''.

This causes some shortcuts to be unusable, because they are reserved for Mac OS X. **Specifically, cheat for scrolling through item list (by using ''Alt + W'') does not work, because ''Cmd + W'' is reserved by system to function as keyboard shortcut to close window.** To force mapping of ''Option'' key to ''Alt'' key, do the following:
  - Open Terminal
  - Go to (''cd'') ''Jagged Alliance 2.app/Contents/Resources/game/Jagged Alliance 2.app/Contents/Frameworks''
  - Type ''touch .Xmodmap'' (will create .Xmodmap file)
  - Type ''open -e .Xmodmap''
  - Paste these lines into file:<code>
keycode 66 = Alt_L Meta_L
keycode 69 = Alt_R Meta_R
clear mod1
add mod1 = Alt_L Alt_R</code>
  - //(optional)// If you also want to map ''Backspace'' key to ''Delete'' key (so you don't have to press ''Fn + Backspace'' to imitate it) and key left to Backspace to ''End'' key (so you don't have to press ''Fn + right arrow'' to imitate it), add also these lines:<code>
clear Mod2
clear control
keycode 59 = Delete
keycode 32 = End
add control = Delete
add control = End</code>
  - //(optional)// In case some of the keys will not function properly, keycodes are probably different on your system. You can find out proper keycodes by running ''xev -event keyboard'' in terminal and pressing needed keys. Complete hotkey names-list is avaliable on [[http://wiki.linuxquestions.org/wiki/List_of_Keysyms_Recognised_by_Xmodmap|Xmodmap keysyms list]]
  - Save file and play :-)


===== (Re)sources =====
  * [[http://www.columbia.edu/~em36/winekeymap.html|This article]] helped me a lot.


~~socialite~~
{{tag>os-x howto games fresh-install}}

===== Comments =====

~~DISQUS~~