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 Winery.app Version 1.7.zip) and drag-and-drop the Wineskin Winery.app file to your Applications folder.

2. Launch Wineskin Winery

Go to your Applications folder, right-click on Wineskin Winery.app, 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):

install-battlerite-mac-1

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

install-battlerite-mac-2

Click OK and allow it to download:

install-battlerite-mac-3

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

install-battlerite-mac-4

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

install-battlerite-mac-5

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.

install-battlerite-mac-6

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

4. Install Steam in Wineskin

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

install-battlerite-mac-7

On the next page, click Choose Setup Executable:

install-battlerite-mac-8

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

install-battlerite-mac-9

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:

install-battlerite-mac-10

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:

install-battlerite-mac-set

When Steam runs, log in as usual:

install-battlerite-mac-11

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-battlerite-mac-12

Install it. Done!

To launch Steam again next time, just go to your Applications folder and launch Steam Windows.app (or use the faster method, which is to bring up Spotlight using Ctrl + Space and launch Steam Windows.app 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 Windows.app, then right-click on it and select Show Package Contents. Then right-click on Wineskin.app 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!

Zanetski

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.

31 Comments

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

    1. Thanks Mengster, I really appreciate that. πŸ˜€ I have several posts in the pipeline, one guide-type post every Tuesday with lighter content on Fridays and the occasional Sunday. That’s so cool that this site has been helping you and your friend! Grats on G11, I know you’ll make it to G12 soon.

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

    1. Hey PapY. I looked through the Wineskin Winery forums and it seems like Sierra isn’t supported yet. Other people are crashing with other applications too right now. You could try PlayOnMac (not sure if it’ll work, never tried it myself) or just use Wine on its own (more advanced, haven’t tried that myself either).

      The other option is to run in a VM with Parallels or VirtualBox, but I only recommend that if your system is powerful or else game performance may suffer. Hope you find a way to play!

      1. Thank you for your response. I already tried play on mac but it didn’t work either. I think I’ll just wait for Wineskin to be compatible with Sierra.

        1. It worked for me after i unticked “shadows” in graphic options ingame! Im not using sierra tho, but i had the same problem in el capitan

        2. Oh nice, a graphical issue like that would make sense. Thanks for chiming in, Tacoboy!

        3. You can try the pure wine-staging. It worked for me on Sierra. However there is a huge performance drop between Sierra and Mavericks. I’ve lost something like 30% of the FPS on the migration.

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

    1. Hey Brett. I’m not sure if this will work, but try it!

      Go to Applications and find Steam Windows.app, then right-click on it and select Show Package Contents. Then right-click on Wineskin.app 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.

      Hope that helps!

    2. I just added another possible solution to the post:

      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.

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

    1. Hey bread. I’m not sure if this will work, but try it!

      Go to Applications and find Steam Windows.app, then right-click on it and select Show Package Contents. Then right-click on Wineskin.app 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.

      Hope that helps!

    2. I just added another possible solution to the post:

      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.

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

    1. Hey Thighknee. Wish I could help but I’ve never run into that issue, sorry! Hopefully another reader will be able to help you out. πŸ™

  6. IT WORKS !

    thx for the help ;D

    1. Hey, so glad it worked for you Zed! πŸ˜€

  7. Why do you have to use the “WS9WineCX15.0.1”-engine? Why not the latest version?

    1. Honestly you don’t have to. Wine engines are complex so it’s totally possible for an older engine to perform better for certain games — and it’s possible that WS9WineCX15.0.1 is a suboptimal engine to use. I mentioned it because it was the latest CX engine at the time when I wrote the post. (CX denotes Crossover engine, which tends to perform better for modern games but not always.)

      So if there’s a later version, try it and see how well it works. If it’s good, great! Keep it. Otherwise, experiment with older engines — and if CX engines seem to be crappy, try some of the non-CX engines.

  8. Hi, Thaks for the post.

    I just have a problem: I tried it a first time, and it worked, but i can’t lauch steam again after i quit wineskin. When i lauch steamwindows.app like you say, I just got the initial window “install software / set screen option / advanced / quit”. What am I supposed to do?
    My only option is to install steam and battlerite each time I want to play.

    Thanks for your help.

    1. That is very weird behavior, I’ve never had that happen to me before. Are you on El Capitan or Sierra? The best I can suggest is to try another Wine engine — if there’s a newer one available then try that one, but if that still doesn’t work, try using an older version. That’s the downside of using Wine: when it doesn’t work, you have to do a bit of trial-and-error. Sorry I couldn’t be more helpful! Let me know if that works though.

  9. So I got the game running very well. It was running slow but I turned on vertical sync and then everything went smooth. However, when I’m playing the game, the screen flashes static occasionally. It’s a small price to pay for it playing great on my Mac but I was wondering if there could be any solutions.

    1. Sorry hajrudin. When I play on Mac, I get the same problem — Steam window flashes and Battlerite sometimes flashes. Not all the time, but here and there. I wish I had a solution but I haven’t been able to figure it out yet. If anyone is reading this and has any suggestions, please comment!

      1. Thanks for the guide though πŸ™‚

  10. Im running the WS9WineCX15.0.1 engine and it works well in 30fps lock. But the game graphics starts to flash a bit and act glitchy when i change to 60fps. The framerate is fine but i would rather play without the graphic glitch :). Does anyone have a fix for this?

    1. Hey let me know if you find a fix for that. I get the same thing, it seems. πŸ˜›

  11. Hi, ty for the tricks ! i played like 4-5 hours then crashed. now i can’t instal again steam, it’s still blocked on the update download πŸ™ Any idea ? i tryed to redo all the process but everytime same problem…

    1. Hey Cross, sorry to hear that. I’m not sure what the problem could be, I’ve never had that happen. Maybe try it again with a different Wine engine? I wish I had more insight but I’m not really a Wine guru. πŸ™

  12. Error when I try to install Battlerite through Steam Windows … (No Internet connection) …I’m running OS X Yosemite.

    1. I haven’t run into that problem before. You may want to try asking in the Wineskin support forums. Sorry Carlos!

Leave a Reply

Your email address will not be published. Required fields are marked *