How to Install and Play Battlerite on Mac in 4 Steps

Posted by Zanetski 31 comments

If you’re in the minority and prefer gaming on a Mac, then I have some good news and some bad news for you.

First the good news: Stunlock is definitely aware of the demand for Mac and Linux builds of Battlerite. And seeing as how the game is made using Unity, the process of porting and maintaining those builds should be relatively simple when the time comes.

But then the bad news: it’s not a high priority, nor should it be. Mac and Linux players make up a tiny fraction of the playerbase and Stunlock has much more important stuff to take care of, especially during Early Access:

As you’ve all noticed we only support Windows right now, but it isn’t impossible that we might expand upon this in the future and include support for other operating systems. It’s not on the horizon right now, but it’s something we definitely want to investigate further.

So I wouldn’t hold my breath. It may take several months, maybe even a couple of years, before we see those builds released. Until that time, you have two options: play on Windows or play through Wine.

I tried running Battlerite through Wine and it works surprisingly well. You may crash every once in a while depending on your setup, and you may run into some quirks like only being able to play in windowed mode, but it’s certainly playable.

Here’s what I did.

Installing Battlerite With Wineskin Winery

Wine lets you emulate Windows applications on Unix-based systems (including Mac and Linux). Wineskin Winery is an all-in-one tool that lets you create individual Wine wrappers, which are basically separate Wine environments that you can use to run individual games in. No need to know all the details though. Just follow these steps and you’ll be golden.

1a. Download the Windows installer for Steam

Remember, Wine emulates Windows software, so you’ll need the Windows version of the software itself — in this case, that’s Steam.

You can use this direct download link or you can just navigate to the Steam download page and grab the Windows version. Look for the “Also available for Windows” link right below the big download button.

1b. Download and install Wineskin Winery

Go to the Wineskin Winery download page and grab the latest version. Unzip the file (which should look like Wineskin Version and drag-and-drop the Wineskin file to your Applications folder.

2. Launch Wineskin Winery

Go to your Applications folder, right-click on Wineskin, and select Open. If you see a warning message about unknown or unidentified developers, don’t worry about it and click Open again.

3. Create a blank new wrapper

Before you can create a wrapper, you’ll need to download a “Wine engine” — basically a copy of a specific version of Wine that you’ll be using to emulate Windows. To do this, click the + icon here (ignore my pre-existing Installed Engines):


Using the search field or the dropdown menu, find WS9WineCX15.0.1 and then click Download and Install:


Click OK and allow it to download:


Next, select the engine in the Installed Engines list and then click on Create Blank New Wrapper:


When prompted to choose a name for the wrapper, you can name it whatever you want. I personally went with Steam because this wrapper is going to hold the Windows version of Steam:


Wait for the wrapper to generate (it may take a few minutes). If you’re prompted to install Gecko, click Install and wait a bit more. When it finishes, click View Wrapper in Finder. If you missed it, you can locate it manually by going to /Users/[username]/Applications/Wineskin.


Drag the Steam to your Applications folder and exit Wineskin Winery.

4. Install Steam in Wineskin

Go to your Applications folder and right-click on Steam (you did drag it there, right?) then select Show Package Contents. You should be able to see a file called — launch it and click Install Software:


On the next page, click Choose Setup Executable:


Navigate to wherever you stored the Steam installer that you downloaded in the first step. Select it and click Choose:


Run through the installation wizard using all of the default settings. Make sure to keep Run Steam checked at the end, finish the installation, and wait for Steam to update itself:


After installation, Wineskin may ask you to set the program’s executable file. If this happens, all you have to do is select Steam.exe from the dropdown:


When Steam runs, log in as usual:


Finally, go ahead and buy a game key for Battlerite Early Access (why Early Access is absolutely worth it) so that it shows up in your Steam library.


Install it. Done!

To launch Steam again next time, just go to your Applications folder and launch Steam (or use the faster method, which is to bring up Spotlight using Ctrl + Space and launch Steam that way).

Is the Game Running Slow?

Some people have noted that Battlerite installs correctly but runs extremely slow. If that’s the case for you, try these two things. They’re not guaranteed to work, but have worked for some.

Set a Custom FPS Limit

In the game client options, change the FPS Limit Mode to Custom. By default it’s set to Display, which tries to synchronize the frame rate with your screen refresh rate, but this doesn’t work through Wineskin. That’s why your FPS may be around 1. If you can’t change the FPS Limit Mode, first disable Vertical Sync.

Changing it to Custom will open up another option that you can change: FPS Limit. Feel free to experiment with different FPS values, but you’ll probably have best results by setting it to 30.

Set Virtual Desktop Mode

Go to Applications and find Steam, then right-click on it and select Show Package Contents. Then right-click on and select Open. You should see a few options — click on Set Screen Options.

A new window opens. At the top right, change Automatic to Override, which allows you to change the options on the left side. Change from Normal Windows to Virtual Desktop, and set the resolution to the resolution you want to run Battlerite. For example, 1280×720.

If that doesn’t work, try reinstalling with a different Wine engine (something other than WS9WineCX15.0.1, experiment and try a bunch). This may or may not help. Certain games perform better with different Wine engines on certain systems, but it’s a trial-and-error process.

If you run into any problems, feel free to post a comment about it. I’m not an expert with Mac or Wine but I’ll do my best to help you out. And if you have an easier method to get Battlerite working on Mac, let me know!


Written by Zanetski

Lead writer and editor for Battlecrank. When he isn't sinking hours into Battlerite itself, he's doing his best to help newbies. You can find him on Discord at Zanetski#5578.

Discuss This Article

Sort by:   newest | oldest | most voted
5 months 1 day ago

I don’t know why i read this entire article even though I don’t even have a mac…
I guess I’m just really craving more Battlerite content. Keep up the great work Zanetski, I read all of your articles and some of them have really helped me, especially the one with the orbs. I talked with my friend about it and we were both blown away at the insane value in orbs, and I’m pretty sure that awareness (along with us not wasting defensive cooldowns anymore) is what helped me get to Grade 11 (and still rising).

5 months 21 hours ago

Hi thank you for your post. I have a problem, I can launch the game but when I click “play” it crashes. I wonder if wine works on MacOS Sierra??

4 months 27 days ago

When running it on my Mac the game ran super slow… only registering <1 fps and loading everything SUPER slow. Any suggestions?

4 months 27 days ago

The game launches fine and im able to start the turotial with one not so minor issue, its extremely choppy (aka really low fps) is there any way i can fix this?

4 months 20 days ago

Sometimes Battlerite will crash and I will have to end up force-quitting the “Steam Windows” application. However when I attempt to re-open the “Steam Windows” application, it will pop up like it is about to open on the taskbar but then will fail to open and the icon will disappear. I have had to delete the “Steam Windows” application and repeat the entire download process after every crash.

does anyone know why the application will not open after a crash? Please help