MacOS

From Multi Theft Auto: Wiki
[[|link=]] Warning: This page is intended for developers. If you are here looking for instructions to install the client on macOS, please read this page!

This page is incomplete, and is still being updated by developers. If you are here to learn how to run MTA on OS X, you only need to read the first section "Making Your Own Wrapper".

Contact User:qaisjp if you need any help with anything on this page.

User Experience

This section outlines what our automated version will do.

A .dmg file will be distributed. EULAs can be embedded within .dmg files.

This file will contain a link to the Applications folder and the Multi Theft Auto application. The user is expected to transfer the application to the applications directory before running.

The application will:

  • confirm we are not running from an img file
  • check if there is currently a valid GTA:SA directory
    • if not, prompt for a directory.
    • Wineskin does not support symbolic links. Once the directory has been chosen, we copy the gta_sa.exe file over and directory junction the rest of the files.
  • start Multi Theft Auto for us automatically

Making Your Own Wrapper

This section is written like a tutorial for public consumption, but is intended to serve as working documentation to aid the automated version in development. It is recommended that you read through this entire section (including the "Tips" section at the bottom) before following the tutorial, if you wish to build your own Wineskin wrapper. You do not need to read any other sections.

Grabbing the Winery

Now we have generated an empty wrapper, we need to add GTA, install MTA, and configure some other settings.

Running San Andreas

Firstly, we will test out Grand Theft Auto: San Andreas. For the sake of this tutorial we will assume that you already have a folder containing your GTA:SA files (copied over from a Windows installation). You may need a no-cd version of the exe.

Running Multi Theft Auto

Now we need to install Multi Theft Auto.

  • Some font files are required for MTA to run. Copy the font files (.ttf) from here and extract them to `drive_c/windows/fonts` (inside our wrapper). You may have to create the fonts folder yourself if it does not exist.
  • Download the installer from the homepage.
  • Open Wineskin.app (inside our wrapper) and select "Install Software", and then select "Choose Setup Executable".
  • Navigate to the .exe installer (that should be inside your Downloads folder) and allow Wineskin to load it.
  • Proceed with the installer as usual. Do not change the Destination Folder for where MTA will be installed.
  • The installer may encounter errors Unable to install Microsoft Visual Studio 20xx redistributable. It is okay to ignore these.
  • Deselect Run MTA when you have finished installing.
  • Press "Advanced" on the Wineskin window, and now browse to the Multi Theft Auto.exe file.
  • Perform a Test Run, and hopefully Multi Theft Auto should run!

Tips

  • You can use the keybind Cmd+Opt+A at any time to switch between windowed & fullscreen. You may need to use this if you cmd+tab out of the app, and the app ends up moving to windowed mode.
  • If you are asked at any time to install Gecko or Mono, simply press yes.
  • If you receive the message "Warning: Could not detect anti-virus product" when starting MTA, simply check the box saying "I will not install an anti-virus", and press OK. This message occurs because MTA cannot detect OS X antiviruses.