How to Install and Play Battlerite on Mac

Last updated on December 16, 2017.

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.

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 WS9WineStaging2.16 (the images show 2.12 but use the later version) 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 and/or Mono, 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:


If you get a “No new executables found!” error and you’re on High Sierra, it may be due a bug in Wineskin’s GPU detection. Launch again, select Set Screen Options, uncheck the Auto Detect GPU for Direct 3D option, then try again.

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).

Getting SteamWebHelper.exe Errors?

At some point, Steam updated and stopped being compatible with Wineskin. This may be fixed in the future when Wineskin updates its software, but for now, there is a workaround you have to use.

Right-click on Steam, then select Show Package Contents. You should be able to see a file called Launch it and click Advanced. Go to Configuration, look for the EXE Flags field, and enter -applaunch 504370, then click the X to exit. It will save, no need to do anything else. Now just launch the Steam like normal and it should work.

Note that you will still get the steamwebhelper.exe message, but Steam should open and then launch straight into Battlerite. If you don’t have Battlerite yet, it will ask if you want to install it. Thanks for the tip in the comments, Lord and Savior!

Is the Game Running Slow?

Some people have noted that Battlerite installs correctly but runs extremely slow. It may take several minutes to load when you launch it, and the frame rate might be abysmal. If that’s the case for you, try these potential solutions.

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.

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

You can also change this setting without actually opening the game client:

  1. Go to the Applications folder, right-click on Steam, and select Show Package Contents.
  2. Navigate to drive_c > users > [username] > Application Data > Battlerite and open the file called Graphics.json in a text editor like TextEdit.
  3. Change “UseCustomFpsLimit” to 1 and change “FpsLimit” to 30. If you don’t see them, then you can add them in yourself, but make sure you add a comma (,) at the end of the line except for the very last setting.
  4. Here’s what mine looks like:
      "Audience": 0,
      "Bloom": 0,
      "FpsLimit": 30,
      "FXAA": 0,
      "ResolutionX": 960,
      "ResolutionY": 540,
      "Shadows": 0,
      "SoftParticles": 0,
      "UseCustomFpsLimit": 1,
      "VSync": 1

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 (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.

Is the Game Crashing When Loading a Match?

Some players report a crashing client when loading into a match, even the Tutorial and Playground modes. To fix this, make sure you’re running the latest WineStaging engine and uncheck all of the graphic options in game, especially Shadows, then try again.

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!


He is the lead writer at Battlecrank. You can find him on the Battlecrank Discord.

Discuss This Article

128 Comments on "How to Install and Play Battlerite on Mac"

Sort by:   newest | oldest

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).


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??


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


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?


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


same for me :/