Experimental Ports – Arma 3

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
(Page cleanup)
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Please visit [http://dev.arma3.com/ports this '''overview page'''] to learn more about our experimental client ports to Linux and Mac, including the limitations and F.A.Q.
{{TOC|side}}
 
Please visit {{Link|http://dev.arma3.com/ports|this '''overview page'''}} to learn more about our experimental client ports to '''Mac''' and options for '''Linux''', including the limitations and F.A.Q.


== Installation ==
== Installation ==
# Check the [http://dev.arma3.com/ports limitations overview] to decide whether you find them acceptable.
# Check the [http://dev.arma3.com/ports minimal requirements] to determine whether your system is able to run the ports.
# Download and install the Steam client, create an account and purchase the [http://store.steampowered.com/app/107410/ Windows retail version of Arma 3].
# Install the game (it will automatically download the data for Mac or Linux, depending on the platform you are installing from).
# Play!
== Known Issues ==
* <s>Potential Out Of Memory client crashes/freezes when playing for longer periods of time - the ports are limited to 768 MB of VRAM on Linux and 512 MB on Mac.</s>


* <s>Being a 32-bit process, Arma 3 has 4 GB of memory available to it. However, unlike Direct3D, OpenGL stores texture data in the game's address space. Using more VRAM would fill the available memory much more quickly, leading to more frequent crashes.</s>
# Check the {{Link|http://dev.arma3.com/ports|limitations overview}} to decide whether you find them acceptable.
* Lower FPS after long gameplay - this may hint at an incoming OOM crash. Restarting the game cleans the memory.
# Check the {{Link|http://dev.arma3.com/ports|minimal requirements}} to determine whether your system is able to run {{arma3}} on other platforms than Windows.
* Lag and desync under heavy multiplayer load
* Problem with different languages and diacritics - only English works properly. Non-ASCII characters are not supported.
* Low FPS on OS X - running the OS and the native display resolution eat up a lot of computing power.
* AMD Mesa drivers can cause graphical glitches, such as white blinking vegetation LODs.
* Occasional Alt + Tab crashes
* Aspect ratio changing CTD - changing the aspect ratio in-game can cause issues and/or CTDs.
* Joystick, gaming devices - Xbox 360 controllers should work plug-and-play on Linux and Mac, but it's not always possible to remap their buttons in-game. Joysticks, Xbox One gamepads and other game controllers need user alterations of the SDLGamepad.config file located in the Arma directory on Linux.
* The VP wrapper can lower Arma 3’s performance by up to 30 percent on several systems, but the performance drop should not exceed 10 percent on a vast majority of systems.
* Video options have some limitations dependent on the system’s computing power. It can disable your option to set up High or Ultra quality levels on less powerful machines.
* Some keys (e.g. "Alt") are designated for something else in the system (on Mint for example), so you may need to re-map your keyboard settings.
* The shader cache file can become corrupted during some crashes. Deleting "~/.local/share/bohemiainteractive/arma3/eONprecompiledShaders.dat" fixes the problem.
* Drivers on AMD cards - AMDGPU-PRO Beta and MESA drivers - are in development and are prone to cause unexpected issues from time to time.
* Potential sound issues (e.g. static and stuttering)
* Arma 3 Server running on Linux may suffer from BattlEye client not updating properly. Try restarting the server to trigger the update.
* Issues with shared memory management in PulseAudio drivers in some community missions.
* DLC content errors after update 1.64: deleting the contents of the Steam/depotcache folder and a subsequent data verification in Steam should help.
* Legacy versions (e.g. 1.64 and 1.68) work on older OS X (10.9.5) as they don't use Metal 2.0 yet.
* Steam overlay on Linux/Mac platforms may lead to crashes or other major issues.
* If you get a Steam Library error when starting a dedicated server, try starting it using this command ''LD_LIBRARY_PATH=~/.steam/bin32/ ~/.steam/bin32/steam-runtime/run.sh ./arma3 -server -config=server.cfg''
* Apple AudioToolbox crashes might sometimes happen.
* ATOC might cause rendering issues with AMD cards using MESA drivers.
* User on distributions using the Wayland display server may find that the following issues occur (read on for a way to disable it and restore the functionality).
** Cannot select any resolutions other than the highest one your monitor supports.
** After restoring a minimized game window, it will have an empty space where the title bar should normally be.
* Any issues fixed since the [https://dev.arma3.com/post/spotrep-00073 1.76] Windows version
=== Disabling Wayland ===
Disabling Wayland protocol / display driver and switching back to X Server:
# Open /etc/gdm/custom.conf for editing
# Uncomment the line WaylandEnable=false
# Reboot   


== Distros ==
Supported Linux distributions are:
* Ubuntu 16.04 64-bit and later LTS versions
* Mint 18 64-bit and later LTS versions
* Fedora 25 and later LTS versions
* SteamOS 2.87 and later stable versions
<s>32bit Linux systems are considered too unstable due to crashes in MP, although it may be possible to play Arma 3 on them.</s>
The Arma 3 ports are now 64-bit processes, so no further testing was done on 32-bit systems and Arma 3 ports will not run on them.
We support only default desktop environments such as Cinnamon on Mint and Unity on Ubuntu. It should be possible to run the game on Debian and Gentoo, but it was not the part of the QA process, therefore we cannot guarantee support.
There are community tests of Arma 3 on other Linux distributions such as Arch Linux. You can find more information on [https://forums.bistudio.com/forum/196-arma-3-ports/ the forums] and [http://feedback.arma3.com/ Feedback Tracker] regarding issues on unsupported distros.
== Linux Graphics Drivers Updates ==
=== NVIDIA ===
A quick 'how-to' on updating NVIDIA drivers on Ubuntu and Mint systems:
# Open Terminal
# Enter "sudo add-apt-repository ppa:graphics-drivers/ppa"
# Enter "sudo apt-get update"
# Enter "sudo apt-get install nvidia-375"
Your drivers should now be updated after restarting.
Check https://launchpad.net/~graphics-drivers/+archive/ubuntu/ppa for newer drivers.
A quick 'how-to' on updating NVIDIA drivers on Fedora systems:
# Enable both (free & paid) RPM Fusion Repositories [https://rpmfusion.org/Configuration here]
# Open Terminal
# Enter "xorg-x11-drv-nvidia akmod-nvidia "kernel-devel-uname-r == $(uname -r)"" and install everything the package requires
# If you're on a 64-bit system, enter "sudo dnf install install xorg-x11-drv-nvidia-libs.i686" after the previous operation finishes
# Reboot (you may find that the boot process takes longer than usual; this is normal the first time)
=== AMD ===
Ubuntu 16.04 and all distros with Xorg1.18 or higher, need the AMDGPU-PRO beta driver (for newest GPUs) or Oibaf MESA drivers (recommended). Installing AMDGPU-PRO: http://support.amd.com/en-us/download/linux. Oibaf driver info can be found [https://launchpad.net/~oibaf/+archive/ubuntu/graphics-drivers here].
Fedora 24 or higher ships with its own MESA driver.
In addition, Fedora 25 with AMD GPUs need to disable the Wayland display driver and re-enable X Server for the game to work correctly.
Installing MESA drivers for AMD:
# Open Terminal
# Type in and execute: "sudo add-apt-repository ppa:oibaf/graphics-drivers"
# Type in and execute: "sudo apt-get update"
# Type in and execute: "sudo apt-get install synaptic"
# Type in and execute: "synaptic - launches synaptic manager"
# In the manager click on "mark all updates" and apply
# Reboot
In the case Steam is not working with MESA this may help :
#  Open Terminal
#  Type in and execute: "gedit .bashrc"
#  Add line "export LD_PRELOAD='/usr/$LIB/libstdc++.so.6' DIAPLAY=:0"
#  Save and exit
#  Steam should now launch by typing "steam" into Terminal
== Joysticks & Gamepads==
Unfortunately, Steam’s standard only supports standard Xbox and Windows XInput gamepad schemes, which means that more sophisticated schemes present in Arma 3, and using DirectInput and allowing reconfiguration of gamepads and joysticks in-game, had to be turned off in the ports. It is possible to reconfigure them by modifying the mapping text, but it’s not intuitive. Alternatively you can try to remap your keybinding using third-party software (e.g. AntiMicro).
== Dedicated Servers ==
=== Mac ===
=== Mac ===
# Run the Steam client (if do not start the normal game first, it will not let you launch after the Dedicated Server is on).
# Run Arma 3 and wait for the game to get to the main menu.
# Run Terminal.
# Change the current directory to the path where the ''Arma3.app'' is (e.g. ''"cd ~/Library/Application\ Support/Steam/SteamApps/common/Arma\ 3/"'').
# Run the Dedicated Server by command: ''"./ArmA3.app/Contents/MacOS/ArmA3 --args -server -config=Server.cfg"''.
=== Linux ===
==== Method 1 ====
# Launch Arma 3 via Steam normally (if you want to run server and client on the same PC).
# Find your Arma 3 installation folder by using your right mouse button to click on the game name in Steam's library and go to the Properties click on Local files tab, then click on Browse local files button to open the file browser at that location. You should also put the server.cfg file there. Default installation folder is: "~/.steam/steam/steamapps/common/Arma 3".
# Open Terminal and type in: "cd 'your Arma 3 path'" and then press Enter. It should change to your game folder.
# Type in and execute: "export LD_LIBRARY_PATH="/home/user/.steam/ubuntu12_32""
# Type in and execute: "./arma3 -server -config=server.cfg"
Your Dedicated Server should run alongside the normal game now.
Note - you can skip #4 by entering "export LD_LIBRARY_PATH="/home/user/.steam/ubuntu12_32" directly into the ~/.bashrc file.
==== Method 2 ====
[[Arma_3_Dedicated_Server#Instructions_.28Linux_o.2Fs.29]]
== Fedora Firewall  ==
There may be an issue with connections on Arma 3’s server on Fedora caused by a firewall. For disabling this you may use this:
https://docs.fedoraproject.org/en-US/Fedora/19/html/Security_Guide/sec-Disabling_firewalld.html.


Keep in mind this will open your firewall completely, and opening ports just for Arma 3 is advised (default ports are: 2302-2305 UDP)
Please see the [[Arma 3: Play on Mac]] article for both non-native and native solutions.
 
 
== Cross-Platform Windows Compatibility  ==
Please visit [http://dev.arma3.com/ports this '''overview page'''] to learn more about our experimental client ports to Linux and Mac, including the limitations and F.A.Q.
 
 
== Installation ==
# Check the [http://dev.arma3.com/ports limitations overview] to decide whether you find them acceptable.
# Check the [http://dev.arma3.com/ports minimal requirements] to determine whether your system is able to run the ports.
# Download and install the Steam client, create an account and purchase the [http://store.steampowered.com/app/107410/ Windows retail version of Arma 3].
# Install the game (it will automatically download the data for Mac or Linux, depending on the platform you are installing from).
# Play!
 
 
== Known Issues ==
* <s>Potential Out Of Memory client crashes/freezes when playing for longer periods of time - the ports are limited to 768 MB of VRAM on Linux and 512 MB on Mac.</s>
 
* <s>Being a 32-bit process, Arma 3 has 4 GB of memory available to it. However, unlike Direct3D, OpenGL stores texture data in the game's address space. Using more VRAM would fill the available memory much more quickly, leading to more frequent crashes.</s>
* Lower FPS after long gameplay - this may hint at an incoming OOM crash. Restarting the game cleans the memory.
* Lag and desync under heavy multiplayer load
* Problem with different languages and diacritics - only English works properly. Non-ASCII characters are not supported.
* Low FPS on OS X - running the OS and the native display resolution eat up a lot of computing power.
* AMD Mesa drivers can cause graphical glitches, such as white blinking vegetation LODs.
* Occasional Alt + Tab crashes
* Aspect ratio changing CTD - changing the aspect ratio in-game can cause issues and/or CTDs.
* Joystick, gaming devices - Xbox 360 controllers should work plug-and-play on Linux and Mac, but it's not always possible to remap their buttons in-game. Joysticks, Xbox One gamepads and other game controllers need user alterations of the SDLGamepad.config file located in the Arma directory on Linux.
* The VP wrapper can lower Arma 3’s performance by up to 30 percent on several systems, but the performance drop should not exceed 10 percent on a vast majority of systems.
* Video options have some limitations dependent on the system’s computing power. It can disable your option to set up High or Ultra quality levels on less powerful machines.
* Some keys (e.g. "Alt") are designated for something else in the system (on Mint for example), so you may need to re-map your keyboard settings.
* The shader cache file can become corrupted during some crashes. Deleting "~/.local/share/bohemiainteractive/arma3/eONprecompiledShaders.dat" fixes the problem.
* Drivers on AMD cards - AMDGPU-PRO Beta and MESA drivers - are in development and are prone to cause unexpected issues from time to time.
* Potential sound issues (e.g. static and stuttering)
* Arma 3 Server running on Linux may suffer from BattlEye client not updating properly. Try restarting the server to trigger the update.
* Issues with shared memory management in PulseAudio drivers in some community missions.
* DLC content errors after update 1.64: deleting the contents of the Steam/depotcache folder and a subsequent data verification in Steam should help.
* Legacy versions (e.g. 1.64 and 1.68) work on older OS X (10.9.5) as they don't use Metal 2.0 yet.
* Steam overlay on Linux/Mac platforms may lead to crashes or other major issues.
* If you get a Steam Library error when starting a dedicated server, try starting it using this command ''LD_LIBRARY_PATH=~/.steam/bin32/ ~/.steam/bin32/steam-runtime/run.sh ./arma3 -server -config=server.cfg''
* Apple AudioToolbox crashes might sometimes happen.
* ATOC might cause rendering issues with AMD cards using MESA drivers.
* Any issues fixed since the [https://dev.arma3.com/post/spotrep-00067 1.70] Windows version
* User on distributions using Wayland display server may find that following issues occur. Read further down below for a way how to disable it and restore the functionality.
** Cannot select any resolutions, other than the highest one your monitor supports.
** After restoring a minimized game window, it will have an empty space where title bar should normally be
 
== Disabling Wayland ==
Disabling Wayland protocol / display driver and switching back to X Server:
# Open /etc/gdm/custom.conf for editing
# Uncomment the line WaylandEnable=false
# Reboot   
 
== Distros ==
Supported Linux distributions are:
* Ubuntu 16.04 64-bit and later LTS versions
* Mint 18 64-bit and later LTS versions
* Fedora 25 and later LTS versions
* SteamOS 2.87 and later stable versions
 
<s>32bit Linux systems are considered too unstable due to crashes in MP, although it may be possible to play Arma 3 on them.</s>
The Arma 3 ports are now 64-bit processes, so no further testing was done on 32-bit systems and Arma 3 ports will not run on them.
 
We support only default desktop environments such as Cinnamon on Mint and Unity on Ubuntu. It should be possible to run the game on Debian and Gentoo, but it was not the part of the QA process, therefore we cannot guarantee support.
 
There are community tests of Arma 3 on other Linux distributions such as Arch Linux. You can find more information on [https://forums.bistudio.com/forum/196-arma-3-ports/ the forums] and [http://feedback.arma3.com/ Feedback Tracker] regarding issues on unsupported distros.
 
== Linux Graphics Drivers Updates ==
=== NVIDIA ===
A quick 'how-to' on updating NVIDIA drivers on Ubuntu and Mint systems:
# Open Terminal
# Enter "sudo add-apt-repository ppa:graphics-drivers/ppa"
# Enter "sudo apt-get update"
# Enter "sudo apt-get install nvidia-375"
Your drivers should now be updated after restarting.
 
Check https://launchpad.net/~graphics-drivers/+archive/ubuntu/ppa for newer drivers.
 
A quick 'how-to' on updating NVIDIA drivers on Fedora systems:
# Enable both (free & paid) RPM Fusion Repositories [https://rpmfusion.org/Configuration here]
# Open Terminal
# Enter "xorg-x11-drv-nvidia akmod-nvidia "kernel-devel-uname-r == $(uname -r)"" and install everything the package requires
# If you're on a 64-bit system, enter "sudo dnf install install xorg-x11-drv-nvidia-libs.i686" after the previous operation finishes
# Reboot (you may find that the boot process takes longer than usual; this is normal the first time)
 
=== AMD ===
Ubuntu 16.04 and all distros with Xorg1.18 or higher, need the AMDGPU-PRO beta driver (for newest GPUs) or Oibaf MESA drivers (recommended). Installing AMDGPU-PRO: http://support.amd.com/en-us/download/linux. Oibaf driver info can be found [https://launchpad.net/~oibaf/+archive/ubuntu/graphics-drivers here].
Fedora 24 or higher ships with its own MESA driver.
 
In addition, Fedora 25 with AMD GPUs need to disable the Wayland display driver and re-enable X Server for the game to work correctly.
 
Installing MESA drivers for AMD:
# Open Terminal
# Type in and execute: "sudo add-apt-repository ppa:oibaf/graphics-drivers"
# Type in and execute: "sudo apt-get update"
# Type in and execute: "sudo apt-get install synaptic"
# Type in and execute: "synaptic - launches synaptic manager"
# In the manager click on "mark all updates" and apply
# Reboot
 
In the case Steam is not working with MESA this may help :
#  Open Terminal
#  Type in and execute: "gedit .bashrc"
#  Add line "export LD_PRELOAD='/usr/$LIB/libstdc++.so.6' DIAPLAY=:0"
#  Save and exit
#  Steam should now launch by typing "steam" into Terminal
 
== Joysticks & Gamepads==
Unfortunately, Steam’s standard only supports standard Xbox and Windows XInput gamepad schemes, which means that more sophisticated schemes present in Arma 3, and using DirectInput and allowing reconfiguration of gamepads and joysticks in-game, had to be turned off in the ports. It is possible to reconfigure them by modifying the mapping text, but it’s not intuitive. Alternatively you can try to remap your keybinding using third-party software (e.g. AntiMicro).
 
 
== Dedicated Servers ==
=== Mac ===
# Run the Steam client (if do not start the normal game first, it will not let you launch after the Dedicated Server is on).
# Run Arma 3 and wait for the game to get to the main menu.
# Run Terminal.
# Change the current directory to the path where the ''Arma3.app'' is (e.g. ''"cd ~/Library/Application\ Support/Steam/SteamApps/common/Arma\ 3/"'').
# Run the Dedicated Server by command: ''"./ArmA3.app/Contents/MacOS/ArmA3 --args -server -config=Server.cfg"''.


=== Linux ===
=== Linux ===
==== Method 1 ====
# Launch Arma 3 via Steam normally (if you want to run server and client on the same PC).
# Find your Arma 3 installation folder by using your right mouse button to click on the game name in Steam's library and go to the Properties click on Local files tab, then click on Browse local files button to open the file browser at that location. You should also put the server.cfg file there. Default installation folder is: "~/.steam/steam/steamapps/common/Arma 3".
# Open Terminal and type in: "cd 'your Arma 3 path'" and then press Enter. It should change to your game folder.
# Type in and execute: "export LD_LIBRARY_PATH="/home/user/.steam/ubuntu12_32""
# Type in and execute: "./arma3 -server -config=server.cfg"
Your Dedicated Server should run alongside the normal game now.
Note - you can skip #4 by entering "export LD_LIBRARY_PATH="/home/user/.steam/ubuntu12_32" directly into the ~/.bashrc file.
==== Method 2 ====
[[Arma_3_Dedicated_Server#Instructions_.28Linux_o.2Fs.29]]


Please see the [[Arma 3: Play on Linux]] article for a Proton-based solution.


== Fedora Firewall  ==
There may be an issue with connections on Arma 3’s server on Fedora caused by a firewall. For disabling this you may use this:
https://docs.fedoraproject.org/en-US/Fedora/19/html/Security_Guide/sec-Disabling_firewalld.html.


Keep in mind this will open your firewall completely, and opening ports just for Arma 3 is advised (default ports are: 2302-2305 UDP)
== Joysticks & Gamepads ==


Unfortunately, Steam’s standard only supports standard Xbox and Windows XInput gamepad schemes, which means that more sophisticated schemes present in {{arma3}}, and using DirectInput and allowing reconfiguration of gamepads and joysticks in-game, had to be turned off in the ports.
It is possible to reconfigure them by modifying the mapping text, but it is not intuitive. Alternatively you can try to remap your keybinding using third-party software (e.g. AntiMicro).


== Cross-Platform Windows Compatibility  ==
The Linux / Mac ports presently use the current Arma 3 [https://dev.arma3.com/post/spotrep-00073 version 1.76]. Ported Arma 3 can currently access servers only with this version (green in the server list).
It is to be expected that the versions will once again diverge, as soon as the next Arma 3 update (1.78) will be released. When that happens, players on the Windows platform, who wish to keep playing with players on the ports version, must use the legacyports beta branch, as described below.


1.76 version installation on Windows:
{{GameCategory|arma3}}
#Open the Properties of Arma 3 in the Steam library
#Open the Betas tab
#Enter access code: Arma3LegacyPorts. This should unlock the legacyports - Legacy Build (1.76 - ports).
#Download and play

Latest revision as of 15:56, 20 June 2023

Please visit this overview page to learn more about our experimental client ports to Mac and options for Linux, including the limitations and F.A.Q.

Installation

  1. Check the limitations overview to decide whether you find them acceptable.
  2. Check the minimal requirements to determine whether your system is able to run Arma 3 on other platforms than Windows.

Mac

Please see the Arma 3: Play on Mac article for both non-native and native solutions.

Linux

Please see the Arma 3: Play on Linux article for a Proton-based solution.


Joysticks & Gamepads

Unfortunately, Steam’s standard only supports standard Xbox and Windows XInput gamepad schemes, which means that more sophisticated schemes present in Arma 3, and using DirectInput and allowing reconfiguration of gamepads and joysticks in-game, had to be turned off in the ports. It is possible to reconfigure them by modifying the mapping text, but it is not intuitive. Alternatively you can try to remap your keybinding using third-party software (e.g. AntiMicro).