Skip to content

Commit

Permalink
Amend macOS instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
Gymnasiast committed Jul 27, 2024
1 parent e8dff07 commit 00f3593
Showing 1 changed file with 67 additions and 9 deletions.
76 changes: 67 additions & 9 deletions installing/installing-on-macos.rst
Original file line number Diff line number Diff line change
@@ -1,11 +1,6 @@
Installing OpenRCT2 on macOS
============================

Installing OpenRCT2 itself
--------------------------

To install OpenRCT2 on macOS, go to https://openrct2.io/ and download either the latest release or a development build. The builds are packages in a ZIP file. Extract it, then drag OpenRCT2.app to Applications.

Getting the RCT2 files (required)
---------------------------------

Expand All @@ -27,11 +22,74 @@ Then, get this utility called Extractor: https://macsourceports.com/utility/extr

Once this is done, you can now start OpenRCT2. A file picker will open, direct to the directory where you extracted that GOG installer (hint: this directory will contain the rct2.exe file) and OpenRCT2 should now work.

Other methods
^^^^^^^^^^^^^
Steam
^^^^^
Launch Steam with the console enabled::

/Applications/Steam.app/Contents/MacOS/steam_osx -console

You should now see additional tab in the top menu called CONSOLE. Open it, and enter the following command::

download_depot 285330 285331

If you also own RCT1 Deluxe on Steam and want those assets as well, you could enter this command. You don’t have to wait for the first download to finish before entering the second one.
::

download_depot 285310 285311

Once the download is complete, the console will display something along the lines of::

Depot download complete : /Users/<username>/Library/Application Support/Steam/steamapps/content/app_285330/depot_285331

The game won’t show up in the ‘installed’ list - this is normal.

From a CD (Wine)
^^^^^^^^^^^^^^^^

You can use WINE - a reimplementation of the Windows API - to run the installer. Using a wrapper such as `PlayOnMac <https://www.playonmac.com/>`_ is recommended to make the process easier. Follow the wizard the wrapper provides, pointing it to the installer at the appropriate point. It does not matter if RCT2 actually runs, as we'll be using the OpenRCT2 application.

After installing, you need to copy the files of RCT2 to an easy-to-find location. In PlayOnMac, this can be done by highlighting the installed game, clicking “Open folder” and copying the contents of that folder somewhere. Remember the location, as OpenRCT2 will ask for it later on.

From a CD (unshield)
^^^^^^^^^^^^^^^^^^^^

If using Wine is not option, you can use the unshield tool. This tool can be installed via `MacPorts <https://www.macports.org/>`_::

If you don't have a Windows machine at hand, you can extract the files from a RollerCoaster Tycoon 2 installation disc or from Steam. You can read how to do this on this page: https://github.com/OpenRCT2/OpenRCT2/wiki/Installation-on-Linux-and-macOS
sudo port install unshield

or `Brew <https://brew.sh/>`_::

brew install unshield

Now, extract the contents of the CD (substituting EXTRACTDIR and INSTALLER-LOCATION)::

unshield -g Minimum -d "$EXTRACTDIR" x "$INSTALLER-LOCATION/data1.hdr"
cp -R "$INSTALLER-LOCATION/Data/" "$EXTRACTDIR/Minimum/Data"
mv "$EXTRACTDIR/Minimum" "$EXTRACTDIR/RCT2"
If you have CDs for Wacky Worlds and/or Time Twister, repeat this step with the CDs in question.

Getting the RCT1 files (optional)
---------------------------------

Optionally, you can also add the RCT1 files. Extracting these works much the same as extracting RCT2. Using these files requires linking OpenRCT2 to it. The instructions to do so are linked at the end of this article.

Installing OpenRCT2 itself
--------------------------

To install OpenRCT2 on macOS, go to https://openrct2.io/ and download either the latest release or a development build. The builds are packages in a ZIP file. Extract it, then drag OpenRCT2.app to Applications.

Running OpenRCT2
----------------
Once you installed OpenRCT2 and copied the necessary RCT2, you can attempt to run it. Most likely, macOS will not run the application, as it does not recognise it. You can whitelist the application by opening System Preferences, navigating to “Security & Privacy” and clicking “Open Anyway”.

Once you installed OpenRCT2 and copied the necessary RCT2 files, you can attempt to run it. Most likely, macOS will not run the application, as it does not recognise it. You can whitelist the application by opening System Preferences, navigating to “Security & Privacy” and clicking “Open Anyway”.

Other options
-------------

You have now set up the basic install. Depending on your situation, there is one more possibility to improve your install.

.. toctree::
:titlesonly:

linking-to-rct1

0 comments on commit 00f3593

Please sign in to comment.