Play on Mac – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Small tweak to launch options)
m (Note on whitespaces in paths)
 
(11 intermediate revisions by 2 users not shown)
Line 16: Line 16:
#* Select ''Launch experimental Apple silicon native version'' for the experimental native version.
#* Select ''Launch experimental Apple silicon native version'' for the experimental native version.
# Click Play!
# Click Play!
{{Feature|informative|
In some cases Steam client has difficulties downloading the game or an update on Mac.
A solution may be to go into ''Settings'' > ''Privacy & Security'' > ''App Management'', and to allow Steam client permission to modify executables.
}}




Line 33: Line 39:
* '''Keep in mind that you need to start your path with {{hl|C:}}'''
* '''Keep in mind that you need to start your path with {{hl|C:}}'''
: Launch Options Example: -mod{{=}}C:/Users/macuser/Desktop/rhs
: Launch Options Example: -mod{{=}}C:/Users/macuser/Desktop/rhs
}}
{{Feature|important|
* Having whitespaces in your path may cause issues with parsing the launch options. You can use escape characters in this case.
* Launch Options Example: -mod{{=}}\"C:/Users/UserName/Library/Application\ Support/Steam/steamapps/workshop/content/107410/123456789\"
}}
}}


Most mods will work out of the box for {{arma3}} on Mac (this may change in case the Windows version of the game gets updated, but the Mac port does not yet, since mods may rely on new platform features).
Most mods will work out of the box for {{arma3}} on Mac (this may change in case the Windows version of the game gets updated, but the Mac port does not yet, since mods may rely on new platform features).
{{Feature|informative|
See {{Link|https://github.com/muttleyxd/arma3-unix-launcher|Muttley's {{arma3}} Unix Launcher}} for an alternative launcher that can be used to manage mods and launch options.
It can be installed from the project's "Releases" page or in one's respective package repository.
}}


=== Steam ===
=== Steam ===
Line 46: Line 61:
# Copy the mod folder inside the game folder (in our example: 450814997)<br><!-- -->It is recommended to rename the copied folder to a simpler name (example: mod1)
# Copy the mod folder inside the game folder (in our example: 450814997)<br><!-- -->It is recommended to rename the copied folder to a simpler name (example: mod1)
# Open Steam and go to its properties once again.
# Open Steam and go to its properties once again.
# Find {{hl|Launch Options}} in the General tab and enter: {{hl|-mod{{=}}<directoryName or directoryFullPath>}}
# Find {{hl|Launch Options}} in the General tab and enter: {{hl|-mod{{=}}<directoryName or directoryFullPath>}} (separate multiple mods by a semi-colon '';'')
#* Example 1: {{hl|-mod{{=}}mod1}}
#* Example 1: {{hl|-mod{{=}}mod1}}
#* Example2: {{hl|-mod{{=}}C:/Users/macuser/Desktop/mod1}}
#* Example2: {{hl|-mod{{=}}C:/Users/macuser/Desktop/mod1}}
Line 70: Line 85:
# The new custom-made Application should have now been created - close the Script Editor and open the created Application.
# The new custom-made Application should have now been created - close the Script Editor and open the created Application.
# Hit OK on the dialog that appeared; the game should launch with the mod(s) loaded.
# Hit OK on the dialog that appeared; the game should launch with the mod(s) loaded.
== DLCs and CDLCs ==
Here is a useful list of startup parameters to quickly access (C)DLCs:
{| class="wikitable" style="min-width: 30em"
! DLC
! Command Line
|-
| {{Link|Arma 3 Contact}}
| {{hl|1= -mod=contact}}
|-
! CDLC
! Command Line
|-
| {{Link|Global Mobilization}}
| {{hl|1= -mod=gm}}
|-
| {{Link|S.O.G. Prairie Fire}}
| {{hl|1= -mod=vn}}
|-
| {{Link|CSLA Iron Curtain}}
| {{hl|1= -mod=csla}}
|-
| {{Link|Western Sahara}}
| {{hl|1= -mod=ws}}
|-
| {{Link|Spearhead 1944}}
| {{hl|1= -mod=spe}}
|-
| {{Link|Reaction Forces}}
| {{hl|1= -mod=rf}}
|}




Line 78: Line 126:
# Run Terminal.
# Run Terminal.
# Change the current directory to the path where the '''Arma3.app''' is - e.g. {{hl|cd ~/Library/Application\ Support/Steam/SteamApps/common/Arma\ 3/}}.
# Change the current directory to the path where the '''Arma3.app''' is - e.g. {{hl|cd ~/Library/Application\ Support/Steam/SteamApps/common/Arma\ 3/}}.
# Run the Dedicated Server by command: {{hl|./Arma3.app/Contents/MacOS/Arma3 --args -server -config=Server.cfg}}.
# Run the Dedicated Server by command: {{hl|1= ./Arma3.app/Contents/MacOS/Arma3 --args -server -config=Server.cfg}}.




== Cross-Platform Windows Compatibility ==
== Cross-Platform Windows Compatibility ==


The Mac ports presently use the current {{arma3}} {{Link|https://dev.arma3.com/post/spotrep-00109|version 2.12}}.
For now, the version of the Mac ports and primary Windows version should be compatible, at least until further Windows version updates. When that happens, players on the Windows platform wishing to keep playing with players on the ports version must use the ''legacyports'' beta branch, as described below.
For now, the version of the Mac ports and primary Windows version should be compatible, at least until further Windows version updates.
When that happens, players on the Windows platform wishing to keep playing with players on the ports version must use the ''legacyports'' beta branch, as described below.


2.12 version installation on Windows:
How to revert back to the compatible branch on Windows (not currently necessary):
# Open the ''Properties...'' of {{arma3}} in the Steam library.
# Open the ''Properties...'' of {{arma3}} in the Steam library
# Open the ''Betas'' tab.
# Open the ''Betas'' tab
# Enter access code: ''Arma3LegacyPorts''. This should unlock ''legacyports - Legacy Build (2.12 - ports)''.
# Enter access code: ''Arma3LegacyPorts''. This should unlock ''legacyports - Legacy Build (2.16 - ports)''
# Download and play together.
# Download and play together.




[[Category:Arma 3: Tutorials]]
{{GameCategory|arma3|Tutorials}}

Latest revision as of 10:57, 27 November 2024

This article covers the basic setup and troubleshooting of Arma 3 on Mac.


Setup

  1. Download and install the Steam client, create an account and purchase the retail version of Arma 3.
  2. Install the game (it will automatically download the data for Mac, depending on the platform you are installing from).
  3. The launch options will offer a choice of the default non-native version, and the more experimental native version.
    • Select Play Arma 3 for the default non-native version.
    • Select Launch experimental Apple silicon native version for the experimental native version.
  4. Click Play!


In some cases Steam client has difficulties downloading the game or an update on Mac. A solution may be to go into Settings > Privacy & Security > App Management, and to allow Steam client permission to modify executables.


BattlEye

Only the non-native version supports BattlEye anti-cheat.


Mods

In order to launch Arma 3 with mods, they must be downloaded from the Steam Workshop or another source. The mod directory should be moved into the game directory, then loaded using the game's Steam launch options. There also exists a way to launch the game with mods via Terminal, or by making an Alias with the help of the Apple Script Editor.

  • Moving the folder will stop the mod from updating via Steam Workshop. If you want the Workshop to update the mods, you must write the whole path to the original folder.
  • Keep in mind that you need to start your path with C:
Launch Options Example: -mod=C:/Users/macuser/Desktop/rhs
  • Having whitespaces in your path may cause issues with parsing the launch options. You can use escape characters in this case.
  • Launch Options Example: -mod=\"C:/Users/UserName/Library/Application\ Support/Steam/steamapps/workshop/content/107410/123456789\"

Most mods will work out of the box for Arma 3 on Mac (this may change in case the Windows version of the game gets updated, but the Mac port does not yet, since mods may rely on new platform features).

See Muttley's Arma 3 Unix Launcher for an alternative launcher that can be used to manage mods and launch options. It can be installed from the project's "Releases" page or in one's respective package repository.

Steam

  1. Subscribe to and download the mod from the Steam Workshop.
  2. Locate the folder with mods. Default path: /Users/macuser/Library/Application Support/Steam/steamapps/workshop/content
  3. Look for folders with number IDs. Those should be the mods.
  4. Open the game folder. Default path: /Users/macuser/Library/Application Support/Steam/steamapps/common/Arma 3
    You can locate the game folder quickly by using Steam. Press Right Mouse Button on Arma 3 → Properties → Local files → Browse
  5. Copy the mod folder inside the game folder (in our example: 450814997)
    It is recommended to rename the copied folder to a simpler name (example: mod1)
  6. Open Steam and go to its properties once again.
  7. Find Launch Options in the General tab and enter: -mod=<directoryName or directoryFullPath> (separate multiple mods by a semi-colon ;)
    • Example 1: -mod=mod1
    • Example2: -mod=C:/Users/macuser/Desktop/mod1
  8. Close the properties and launch the game; the game should launch with the mod(s) loaded.

Terminal

  1. Open the Terminal.
  2. Write the following command: open -a Arma3 --args -mod=<directoryName or directoryFullPath> -p default -no-remote
    • Example 1: open -a Arma3 --args -mod=rhs -p default -no-remote
    • Example 2: open -a Arma3 --args -mod=C:/Users/macuser/Desktop/rhs -p default -no-remote
  3. Press Enter to confirm the command.
  4. Press OK on the dialog that appeared; the game should launch with the selected mod(s) loaded.

Apple Script Editor

  1. Open Script Editor.
  2. Write command: do shell script "open -a Arma3 --args -mod=<directoryName or directoryFullPath> -p default -no-remote"
    • Example 1: do shell script "open -a Arma3 --args -mod=rhs -p default -no-remote"
    • Example 2: do shell script "open -a Arma3 --args -mod=C:/Users/macuser/Desktop/rhs -p default -no-remote"
  3. Go to File → Export.
  4. Name the file and choose where it will be created (e.g the desktop) - change the File Format to Application and click Save.
  5. The new custom-made Application should have now been created - close the Script Editor and open the created Application.
  6. Hit OK on the dialog that appeared; the game should launch with the mod(s) loaded.


DLCs and CDLCs

Here is a useful list of startup parameters to quickly access (C)DLCs:

DLC Command Line
Arma 3 Contact -mod=contact
CDLC Command Line
Global Mobilization -mod=gm
S.O.G. Prairie Fire -mod=vn
CSLA Iron Curtain -mod=csla
Western Sahara -mod=ws
Spearhead 1944 -mod=spe
Reaction Forces -mod=rf


Dedicated Server

  1. Run the Steam client (if you do not start the normal game first, it will not let you launch after the Dedicated Server is on).
  2. Run Arma 3 and wait for the game to get to the main menu.
  3. Run Terminal.
  4. Change the current directory to the path where the Arma3.app is - e.g. cd ~/Library/Application\ Support/Steam/SteamApps/common/Arma\ 3/.
  5. Run the Dedicated Server by command: ./Arma3.app/Contents/MacOS/Arma3 --args -server -config=Server.cfg.


Cross-Platform Windows Compatibility

For now, the version of the Mac ports and primary Windows version should be compatible, at least until further Windows version updates. When that happens, players on the Windows platform wishing to keep playing with players on the ports version must use the legacyports beta branch, as described below.

How to revert back to the compatible branch on Windows (not currently necessary):

  1. Open the Properties... of Arma 3 in the Steam library
  2. Open the Betas tab
  3. Enter access code: Arma3LegacyPorts. This should unlock legacyports - Legacy Build (2.16 - ports)
  4. Download and play together.