Skip to content

Instantly share code, notes, and snippets.

@yocontra
Last active June 9, 2023 18:28
Show Gist options
  • Save yocontra/554f541f7fa93c12499e0829439860eb to your computer and use it in GitHub Desktop.
Save yocontra/554f541f7fa93c12499e0829439860eb to your computer and use it in GitHub Desktop.
Age of Empires II HD - For Mac OSX

AOE2HD - For Mac OSX

Estimated time: 10 minutes

Purchase

Installing PortingKit

  • Click this
  • Open the PortingKit.dmg file when it finishes downloading
  • Drag the Porting Kit.app file onto the Applications folder in the window that opens
  • Wait until the file is fully copied, close the menu that opened, and you can delete the PortingKit.dmg file
  • Open Finder, click "Applications" in the left sidebar, and look for the Porting Kit item
  • Click "Open" (you only need to do this the first time)
  • Click through the installation process (yes, agree, continue, continue, etc.)

Installing Game

  • Copy and paste this into your browser address bar, then press enter: pkid://385
    • If asked to choose an application, select "Porting Kit" and "Always use this application"
  • Click continue, yes, next, install, etc. to get through the prompts
  • After the install is completed, click the play icon next to "Age of Empires 2 HD" in the left sidebar.
  • After Steam has finished updating (it updates often!) you can sign in.
  • Once signed in, go to your Steam Library tab and go to Age of Empires II in the left sidebar.
  • Click "Install", then next, continue, finish, etc. to get through the prompts
  • Once the game is finished downloading and installing on Steam, click "Play" to launch the game.
  • You will see a launcher pop up with 3 wooden boards with no text on the left - click the first one to launch the game.
  • In the future, you just open Porting Kit to start the game.
  • Congratulations on installing AOE2HD on a Mac!

Known Issues

  • When starting a multiplayer game, the loading screen may get stuck - you will hear the game music but still see the loading screen. If this happens, CMD-Tab to move the window to the background, then click to open the window back up.

Enhancements (optional)

Updating

In the event of an update, the game will break and you won't be able to see other games.

  • Right click the game in Steam and select "Properties"
  • Go to the "Local Files" tab and click "Verify integrity of game files"
  • Once finished, complete the step where you rename the file again

@Kingarthur10bc
Copy link

Hi there I saw this message after playing the game successfully for a week, not sure what to do! Any others had this problem?

Screen Shot 2020-04-18 at 14 29 17

@Liberator49
Copy link

Please help,

i have done all the steps above and have installed the game successfully, when i run the game a box pops up saying
'program error'
'The program (unidentified) has encountered a serious problem and needs to close. we are sorry for there inconvienience'

anyone had this?
I've tried the steps again and no joy.

@alobassmann
Copy link

Please help,

i have done all the steps above and have installed the game successfully, when i run the game a box pops up saying
'program error'
'The program (unidentified) has encountered a serious problem and needs to close. we are sorry for there inconvienience'

anyone had this?
I've tried the steps again and no joy.

I am having the same issue. Any work arounds?

@QueenCeline5
Copy link

Please help,

i have done all the steps above and have installed the game successfully, when i run the game a box pops up saying
'program error'
'The program (unidentified) has encountered a serious problem and needs to close. we are sorry for there inconvienience'

anyone had this?
I've tried the steps again and no joy.

Hi! I received the same error, but even before I got to being able to run the game. I ended up installing Steam version 4.21 instead of the latest one. With that version, the rest of the steps worked and I am successfully able to play. Maybe try that?

@yocontra
Copy link
Author

yocontra commented Aug 4, 2020

It looks like PlayOnMac is updated for Catalina now - I will work on updating the guide and post again when it has been published.

@QueenCeline5
Copy link

It looks like PlayOnMac is updated for Catalina now - I will work on updating the guide and post again when it has been published.

Hi Contra!

That would be AWESOME! Then my sister can play :) Thanks for putting so much work into this. We appreciate it.

@yogie89
Copy link

yogie89 commented Aug 19, 2020

hi @contra, is the guide rules same like before for catalina support?

@yocontra
Copy link
Author

@yogie89 I have tried getting this working on Catalina - PlayOnMac does work on Catalina now, however there are some caveats: it only supports one version of wine, and it happens to be a version that steam does not work on easily. I'm still working on figuring out how to get steam to work on that specific version of wine and will update the instructions when I have it working. I did update the instructions a few days ago with newer PlayOnMac instructions and some steam instructions that may possibly work, so YMMV.

@Ajayvikram10
Copy link

I am on the mini steam. When I right-click on AoE to update the properties, no window pops up. Any ideas >

@PaulsBecks
Copy link

It's the same for me. @Ajayvikram10 did you find a solution?

@yocontra
Copy link
Author

Hey everyone - still no dice w/ PlayOnMac. Made multiple attempts today and still as broken as it was a year ago.

I've updated the README to encourage users to install VMware Fusion 12+ if they want to play the game - I think longterm this is going to make the most sense given how flaky all of this other stuff is.

@tomglynch
Copy link

@Ajayvikram10 @PaulsBecks @contra I got it working on Catalina and I believe also Big Sur (on a friends computer). I followed @rayana's gist from above: https://gist.github.com/rayana/43f8439cb89ca0336b94dd0b1adb4eee, but also follow these tips:

extra tips (things that may differ from the guide):

  • Install PlayOnMac and AOE2
  • control double click thing doesnt work, don't worry about it.
  • make these the arguments: wine steam.exe -no-browser +open steam://open/minigameslist
  • in 'configure wine', do windows 7 not windows XP

@nathanjansen
Copy link

@tomglynch worked! Thanks you very much :D

@falkst9
Copy link

falkst9 commented Apr 2, 2021

I am on the mini steam. When I right-click on AoE to update the properties, no window pops up. Any ideas >

It was the same for me, so i just started the game and skipped the other steps.. works like a charm although I have no idea why

System notes:
macOS High Sierra
Version 10.13.6

@falkst9
Copy link

falkst9 commented Apr 2, 2021

Also many thanks to contra and rayana for putting in all the work

@tristanubaldi
Copy link

I found another solution : Porting Kit (https://portingkit.com/download). After 3 days looking for a solution with playonmac for nothing, Porting Kit allowed me to play AoEII after a few minutes, it's the best solution. I hope it work also for you !

@nathanjansen
Copy link

I found another solution : Porting Kit (https://portingkit.com/download). After 3 days looking for a solution with playonmac for nothing, Porting Kit allowed me to play AoEII after a few minutes, it's the best solution. I hope it work also for you !

I tried this and now I am running AOE DE on my macbook :)
Besides a few stutters it actually performs really well. Thank you very much for sharing!

@ludragoon
Copy link

I am on the mini steam. When I right-click on AoE to update the properties, no window pops up. Any ideas >

It was the same for me, so i just started the game and skipped the other steps.. works like a charm although I have no idea why

System notes:
macOS High Sierra
Version 10.13.6

I get to this stage too and no dice. I don't get a pop up either when I right-click properties in the mini-steam, and I tried launching the game with no success, I get the error:
Screenshot 2021-06-28 at 22 05 44
I am using a Mabook Air Big Sur 11.4, any suggestions please?

@digitalcleavage
Copy link

I found another solution : Porting Kit (https://portingkit.com/download). After 3 days looking for a solution with playonmac for nothing, Porting Kit allowed me to play AoEII after a few minutes, it's the best solution. I hope it work also for you !

Thank you SOOOOOOO much for mentioning Porting Kit! I tried to get PlayOnMac to work for hours and Porting Kit had me playing AOE2HD in <10 minutes. Amazing... thank you again and again!!!

@yocontra
Copy link
Author

yocontra commented Jul 9, 2021

Hey everyone - I've updated the gist with working instructions using Porting Kit. Enjoy!

@ludragoon
Copy link

thank you Contra, this worked! Appreciate all the support.

Hey everyone - I've updated the gist with working instructions using Porting Kit. Enjoy!

@moneyfloyd
Copy link

I have followed all the instructions with downloading Porting Kit, but when I get into Steam I don't have the option to Install AOE2? Can anyone offer any kind of help or suggestions?

@digitalcleavage
Copy link

digitalcleavage commented Jul 18, 2021 via email

@moneyfloyd
Copy link

Did you buy AOE2?

On Sun, Jul 18, 2021 at 5:01 PM moneyfloyd @.> wrote: @.* commented on this gist. ------------------------------ I have followed all the instructions with downloading Porting Kit, but when I get into Steam I don't have the option to Install AOE2? Can anyone offer any kind of help or suggestions? — You are receiving this because you commented. Reply to this email directly, view it on GitHub https://gist.github.com/554f541f7fa93c12499e0829439860eb#gistcomment-3817337, or unsubscribe https://github.com/notifications/unsubscribe-auth/APN5XHWPSERFRY6ZTRXHEJ3TYM6JJANCNFSM4HHWRCVA .

Ahhh yes, I accidentally downloaded DE instead of HD edition. I'm now in but having problem with it "validating subscriptions" whatever that means.

@Marvin9
Copy link

Marvin9 commented Aug 3, 2021

Thanks @contra 🙏🏻 Worked smoothly on Mac m1.

@chuntley4090
Copy link

im getting stuck on the wrapper configure where it says "installing winetrick d3dx9" and it doesnt complete

@thefunkyskull
Copy link

Thank you

@GravelKicker
Copy link

Works perfectly!

@contra will this same process work for AOE 4 coming out 10/28/21?

@yocontra
Copy link
Author

@GravelKicker Likely yes you could install it in the same Steam instance

@Joker-King-666
Copy link

please hlep me
截屏2022-11-28 12 23 50
Steam awayls balck

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment