Instructions on how to install Magic the Gathering Arena on macOS with Retina support.

installing_MTGA_on_macOS_with_Retina_support.md

Installing MTGA on macOS using Wine, and making it look pretty!

The following instructions are heavily inspired by /u/uhohohdear. I modified uhohohdear's instructions and then added support for Retina/HiDPI displays and instructions about how to update MTGA.

IMPORTANT UPDATE: This will no longer work if you upgrade to macOS Catalina, as Wine and Wineskin are 32-bit. I'll update this Gist with 64-bit versions when they become available.

We're back in business!

It appears that the workarounds no longer work. A few people with Macs using Nvidia graphics cards are having success, but Macs with Intel and AMD GPUs crash regularly. At this time, the best way to play Arena on Mac is via Boot Camp or GeForce Now.

WOTC just released a new executable that should work with these original directions. I updated the download link below. I haven't tested this yet, so let me know how it goes!

As of July 25, 2019, this method no longer works. I have a workaround posted here.

Dependencies

0. Your macOS/OS X version must be 10.8 or greater
1. Your Mac must support OpenGL 4.0 or greater (you can find out whether it does here)
2. You must download the Magic the Gathering Arena Windows executable
3. You must download a custom Wineskin wrapper [mirror]

Note: If you're like me, you may not trust unofficial Wineskin wrappers. Unfortunately, the Wineskin project is way behind and only supports Wine 2.x. We need at least Wine 3.0 to run MTGA. If Wineskin ever gets around to updating, you can get the official download here.

Installing MTGA

0. Drag the custom Wineskin wrapper to your /Applications/ folder.
1. Right click/Control click the Wineskin wrapper (MTGArena.app) and select "Open"

Note: If you have a newer Mac, you may need to click "Screen Options" and then uncheck "Auto Detect GPU Info for Direct3D" and check "Use Mac Driver instead of X11". If you complete installation of MTGA and are getting DirectX 11 errors, come back to this step and give these toggles a try.

2. Click "Install Software"
3. Click "Choose Setup Executable"
4. Navigate to and select the Magic the Gathering Arena Windows executable you previously downloaded
5. For some reason, the text is broken for the installation prompts (it's fine in game!). To install, click the lower right rectangle and, on the next screen, click the "Accept and Install" button. (You can actually read the text with the new installer!)
6. Wait for MTGA to install and ignore any warnings (hopefully you won't have any!). When complete, click "Finish"

Note: The installer never successfully closes for me. So, either manually close Wine in the macOS menu bar or force quit Wine.

7. Back in Wineskin, a "Choose Executable" window should be available. Select "MTGA.exe" and not the "MTGAInstaller" msi file.

You can now click "Quit" and start playing MTGA! If you'd like to add Retina support, carry on.

Adding Retina/HiDPI Support

0. In Wineskin, click "Advanced" and then select "Tools"
1. Click "Registry Editor (regedit)"
2. Navigate to HKEY_CURRENT_USER -> Software -> Wine -> Mac Driver (if Mac Driver doesn't exist, navigate to HKEY_CURRENT_USER -> Software -> Wine and then use Edit -> New -> Key to create a new key named Mac Driver)
3. Select Edit -> New -> String Value from the menu and name it RetinaMode
4. Double click RetinaMode, set its value to y, and click "OK"
5. Close the Registry Editor and then click "Config Utility (winecfg)" in Wineskin's Advanced -> Tools menu
6. Click on the "Graphics" tab, enter the correct dpi under "Screen resoution", and click "OK".

Note: You can find your screen's dpi on Apple Support or via DPI Love.

You can now close Wineskin and start playing MTGA in high resolution!

FAQS

I'm getting a DirectX 11 error and it's making me sad.

Repeat steps 0 and 1 under "Installing MTGA" and trying unchecking "Auto Detect GPU Info for Direct3D" and checking "Use Mac Driver instead of X11". If you're still having problems, use TextEdit to create a plaintext file (use shift+command+T to toggle between rich text and plaintext) with the following information:

REGEDIT4
[HKEY_CURRENT_USER\Software\Wine\Direct3D]
"DirectDrawRenderer"="opengl"
"UseGLSL"="enabled"
"MaxVersionGL"=dword:00030003

Save this file as d3d.reg. Go to /Applications/ then right click/control click the Wineskin wrapper (MTGArena.app) and select "Show Package Contents". Open "Wineskin.app". In Wineskin, click "Advanced", select "Tools", and then click "Registry Editor (regedit)". From the "Registry" menu, choose "Import Registry File..." and select the d3d.reg file you just created. Close regedit, exit Wineskin, and try running MTGArena again.

I'm playing MTGA in windowed mode and, after switching to another program, it stops responding.

Everything is fine. Just grab the MTGA window and wiggle it a little bit. Everything should be back to normal.

I tried to launch MTGA and I get some error that crashes the program!

This is a common issue with running MTGA in Wine. Close the program and wait a few seconds. It should work fine on the second attempt. ¯\_(ツ)_/¯

If this really bugs you, here's a fix so that MTGA will launch perfectly every time:

0. Right/control-click the Wineskin wrapper (MTGArena.app) and select "Show Package Contents"
1. Navigate to Contents/MacOS
2. Rename "WineskinLauncer" to "WineskinLauncher.bin"
3. Create a new plaintext file in Content/MacOS and save it as "WineskinLauncher"

Note: If you're using TextEdit, make sure you've turned off the option to add a .txt file extension.

4. Paste the following inside of the new WineskinLauncher file:

#!/bin/sh

dir=$(dirname "$(dirname "$0")")
rm -f "$dir/Resources/drive_c/Program Files/Wizards of the Coast/MTGA/MTGA_Data/Logs/PerfLogRecord.dat" >/dev/null 2>&1
exec "$dir"/MacOS/WineskinLauncher.bin $@

5. In Terminal, run chmod 755 /Applications/MTGArena.app/Contents/MacOS/WineskinLauncher

Thanks to abcbarryn for pointing me toward this fix.

There's an Arena update and nothing works anymore!

Yeah. It's annoying. This appears to work:

0. Right/control-click the Wineskin wrapper (MTGArena.app) and select "Show Package Contents"
1. Double click "Wineskin"
2. Click "Advanced"
3. Click "Tools"
4. Click "Rebuild Wrapper"
5. Wait
6. Click "Install Software"
7. Click "Choose Setup Executable"
8. Navigate to and select the Magic the Gathering Arena Windows executable you previously downloaded
9. Install as normal.

Note: You will need to follow the directions to re-enable retina mode and, probably, change the Screen Options.

@TheRojam while that’s true for newer MacBook/Mac Pro systems it can be “viable” for some people.

Some comments here said MTGA didn’t work from then using CrossOver19 so the only other alternative is using a VM/Bootcamp

GeForce Now is out of beta now. I tried it and was really impressed (I know not everyone here loves it). It runs smoothly and for the first time I was able to set the graphics detail on high and see too many animations I was missing before. For example seeing the full Questing Beast animation - awesome.

Now that it is out of beta, full access costs money - however the free version lets you play for an hour (assume that is per day). Hopefully the real Mac client will be out before long, but according to the AMA (it was a popular question) the devs said it is taking awhile because it has to be 64-bit for Catalina.

Hi, im getting

/Applications/MTGArena.app/Contents/Frameworks/wswine.bundle/bin/wine: line 2: /Applications/MTGArena.app/Contents/Frameworks/wswine.bundle/bin/MTGArena289047192Wine: Bad CPU type in executable

I am guessing that is what happens on Mac OS 10.15 thanks to Apple dropping support for 32 bit executables. Thanks Apple. Not.

Some comments here said MTGA didn’t work from then using CrossOver19 so the only other alternative is using a VM/Bootcamp

@Gcene you're fully right, i used CrossOver for MtG Arena. But didn't work anymore now. Thats said.

---

I am guessing that is what happens on Mac OS 10.15 thanks to Apple dropping support for 32 bit executables. Thanks Apple. Not.

@abcbarryn that it is whats happend. but think about it. 32bit is a bad manner to compile, run/execute things. in my opionion this also means putting an end to obsolete practices. apple did this. even its hard to not use those things anymore, i think it was right.

If enough people request MTGA support in CrossOver CodeWeavers will try to get it working.

That or everyone bombard asking for a clean wine32on64 patch set, then other wine versions can be built to work on Catalina.

Currently digging through 1052 commit differences between Wine-4.12.1 > CrossOver-19 is not fun (minis the easy 90)

I think 32Bit support should have been dropped long ago, having it remain has kept developers lazy it’s been 10 years since 64Bit became standard.

Most of the developers dropping macOS is due to this laziness, the majority of commercial game engines already support macOS with OpenGL or Metal rendering.

Unfortunately, I just got info that CrossOver may still not have the fix for version 20 :(

Thank you for writing us. As it turns out MTGA does not install or run in crossover presently.
https://www.codeweavers.com/compatibility/crossover/magic-the-gathering-arena
This is a known issue on the mac platform to which we have not been able to resolve as of yet. I cannot promise that this will be resolved in crossover 20, as a patches to address the problem did not work. As of now the bug is still being worked on.

Hi guys, I'm on mojave and followed all the instructions + the d3d.reg + the retina registry stuff. Things work for me, in terms of collection page, opening packs, even drafting but I crash whenever I try to enter a battle. Getting that unity error pop up page.

From the other comments, it seems like using a newer version of wine might be the answer but how do I do that exactly? Also does that mean I have to completely reinstall/redownload mtga?

Also when I try to update wrapper in "Advanced -> Tools", I get this error: There is an error with the installation of your Master Wrapper. Please update your Wrapper in Wineskin Winery (a manual install of a wrapper for Wineskin Winery will work too)

I have been having some problems with it crashing some times when entering a battle. If I immediately relaunch the game, it reconnects and continues into the battle though. This has been occurring since the most recent update.

Wineskin (by doh123) is no longer updated, I’ve posted this numerous times now.

To use a newer wine version, you could repackaged a winehq release, modify the Engine Build Script and install a newer version of bison and mingw.
Then compile one from source.

I’ve posted multiple times I run an updated project that provides Wine-2.0 to the current Wine-5.x releases.\

That or just directly use a winehq release via terminal

Wineskin (by doh123) is no longer updated, I’ve posted this numerous times now.

To use a newer wine version, you could repackaged a winehq release, modify the Engine Build Script and install a newer version of bison and mingw.
Then compile one from source.

I’ve posted multiple times I run an updated project that provides Wine-2.0 to the current Wine-5.x releases.\

That or just directly use a winehq release via terminal

Hi Gcenx,
can you explain us what are steps to "repackage" , "modify the Engine Build Script" etc?
Thanks in advance.

I haven’t done that manually in over 2 years, there’s a gist I forked that does the engine repacking but I don’t use that anyway as I built that functionality directly into my own project “Unofficial Wineskin” and PortingKit also shares that same code.

There’s no point explaining how to edit EngineBase when it really needs an entire overhaul to be viable.

Looks like the "always crash when heading into a game, but maybe not on the first game" problems might be related to pets. Judging by the comments here, the constant crashing started when pets were introduced, the crash timing (and the possibility of not crashing; maybe neither player has a pet?) seems to match pet data getting loaded, and after I got a pet of my own (using Geforce Now), not a single game has successfully started without a crash. Also, after getting into the game through reconnecting, all pets are invisible (their sound can be heard though, and if they have some kind of flair around them, that's visible). You can't see the pets in the store or in the profile either. ( https://imgur.com/a/tsclUoA )

So I'm about 95% convinced that the crashing must be caused by the pets, but I'm completely at a loss about what could be done to fix it.

Well, yesterday the official client was released for macOS. So the days of emulating and going crazy are finally over, happy gaming to every mac MTGA players!

An official client is always preferred but this gist might still be useful for some people who own Mac systems that can’t use the latest OS.

At this point, if you are running Mac OS X 10.9 or later you probably should download the official client from:

https://www.epicgames.com/store/en-US/product/mtg-arena/home