Play on Mac – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
(Add dedicated server)
m (Mac 2.16 + RF CDLC)
 
(13 intermediate revisions by 2 users not shown)
Line 13: Line 13:
# Install the game (it will automatically download the data for Mac, depending on the platform you are installing from).
# Install the game (it will automatically download the data for Mac, depending on the platform you are installing from).
# The launch options will offer a choice of the default non-native version, and the more experimental native version.
# The launch options will offer a choice of the default non-native version, and the more experimental native version.
#* Select "Play {{arma3}}" for the default non-native version
#* Select ''Play {{arma3}}'' for the default non-native version.
#* Select "Launch experimental Apple Silicon 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.
}}




== BattlEye ==
== BattlEye ==


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




Line 35: Line 41:
}}
}}


Most mods will work out of the box for {{arma3}} on Mac.
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 ===


# Subscribe to and download the mod from the Steam Workshop.
# Subscribe to and download the mod from the [https://steamcommunity.com/app/107410/workshop/ Steam Workshop].
# Locate the folder with mods. Default path: {{hl|/Users/macuser/Library/Application Support/Steam/steamapps/workshop/content}}
# Locate the folder with mods. Default path: {{hl|/Users/macuser/Library/Application Support/Steam/steamapps/workshop/content}}
# Look for folders with number IDs. Those should be the mods.
# Look for folders with number IDs. Those should be the mods.
# Open the game folder. Default path: {{hl|/Users/macuser/Library/Application Support/Steam/steamapps/common/Arma 3}}<br><!--
# Open the game folder. Default path: {{hl|/Users/macuser/Library/Application Support/Steam/steamapps/common/Arma 3}}<br><!--
-->You can locate the game folder quickly by using Steam. Press {{Controls|RMB}} on {{arma3}} → Properties → Local files → Browse
-->You can locate the game folder quickly by using Steam. Press {{Controls|RMB}} on {{arma3}} → Properties → Local files → Browse
# Copy the mod folder inside the game folder (in our example: 450814997)<br><!--
# 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)
-->It is recommended to rename the copied folder to a simpler name (example: modname, etc)
# 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}}
# Close the properties and launch the game - the game should launch with the mod(s) loaded.
# Close the properties and launch the game; the game should launch with the mod(s) loaded.


=== Terminal ===
=== Terminal ===


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


=== Apple Script Editor ===
=== Apple Script Editor ===


# Open Script Editor
# Open Script Editor.
# Write command: {{hl|do shell script "open -a Arma3 --args -mod{{=}}<directoryName or directoryFullPath> -p default -no-remote"}}
# Write command: {{hl|do shell script "open -a Arma3 --args -mod{{=}}<directoryName or directoryFullPath> -p default -no-remote"}}
#* Example 1: {{hl|do shell script "open -a Arma3 --args -mod{{=}}rhs -p default -no-remote"}}
#* Example 1: {{hl|do shell script "open -a Arma3 --args -mod{{=}}rhs -p default -no-remote"}}
Line 70: Line 80:
# Name the file and choose where it will be created (e.g the desktop) - change the File Format to '''Application''' and click '''Save'''.
# Name the file and choose where it will be created (e.g the desktop) - change the File Format to '''Application''' and click '''Save'''.
# 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 79: Line 122:
# 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 ==
 
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):
# Open the ''Properties...'' of {{arma3}} in the Steam library
# Open the ''Betas'' tab
# Enter access code: ''Arma3LegacyPorts''. This should unlock ''legacyports - Legacy Build (2.16 - ports)''
# Download and play together.




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

Latest revision as of 15:19, 23 April 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

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.