XIV on Mac Visual Setup Guide
Q: Why do I get "Error starting FFXIV" with Dalamud enabled on a Mac with more than 64GB?
Since Dalamud moved to .NET 10, .NET reserves a block of memory that scales with your RAM. On 96 GB Macs this block uses up the low memory Dalamud needs for its hooks. Quit XIV on Mac, run this command in Terminal, then start the game again:
WINEPREFIX="$HOME/Library/Application Support/XIV on Mac/wineprefix" "/Applications/XIV on Mac.app/Contents/Resources/wine/bin/wine" reg add 'HKCU\Environment' /v DOTNET_GCRegionRange /t REG_SZ /d 4000000000 /f
- (by Claude with a moustache)
Q: How can I use an award-winning free trial with XIV on Mac?
Start by setting up a free trial account online either through the Square Enix site for Windows PC or Mac https://secure.square-enix.com/account/app/svc/ffxivregister?lng=en-us or through Steam on a windows computer or virtual machine https://store.steampowered.com/app/312060/FINAL_FANTASY_XIV_Online_Free_Trial/ (directions: https://support.na.square-enix.com/faqarticle.php?id=5382&la=1&kid=82837).
Once your free trial account is set up, open the XoM Settings to the General tab. Set the License to match the type selected during account setup and check the Free Trial box.
Q: How can I use a Steam account with XIV on Mac?
First, link your Steam account with Mogstation on a windows computer or virtual machine.
Here are guides to linking your Steam account with Mogstation:
https://support.na.square-enix.com/faqarticle.php?id=5382&la=1&kid=82837
https://progameguides.com/final-fantasy/how-to-link-your-final-fantasy-xiv-account-to-steam-account/
Then you simply select Steam license in the XoM launcher settings on the General tab under License.
Q: How can I install and run the game on an external drive using XIV on Mac?
If you haven't installed the game yet:
BEFORE installing the game, create a folder on the external drive called "ffxiv", then use Select Game Path (⇧⌘O) under File with XIV on Mac as the focus application to select that folder for install.
If you have already installed the game:
To move your previously installed game to an external drive, move ONLY the folder labeled “ffxiv” from the launcher directory (⌘I) to the external drive. Then use Select Game Path (⇧⌘O) in the XoM launcher to select that folder.
Q: How do I find the launcher settings menu?
With the launcher selected, in your top menu, click XIV on Mac, and then Settings. Here you will find General, Screen Capture, Graphics, Plugins(Dalamud), and Advanced settings.
Q: Where do I find my XIV on Mac install folder?
The install folder can be accessed easily from top menu by clicking File and Open Install Folder while the launcher is focused. The XIV on Mac install folder contains FFXIV game data in the "ffxiv" folder, FFXIV Config, Dalamud, Wine Prefix, Logs, etc.
Q: How can I obtain the Base32 secret required for Auto-OTP?
The Base32 secret is displayed when you set up OTP on your Square Enix account. However, if you set this up before using XIV on Mac, you might be able to obtain this from the TFA app you're using to generate one time codes.
For instance, 1Password will show you the OTP:// value you paired with, and you can find the Base32 part in that string.
If the Base32 value is no longer accessible, you can remove and re-add OTP on your Square Enix account to have a new Base32 secret generated.
XIV on Mac saves this value in the macOS Passwords app, which provides high security while allowing you to view this value yourself in the future. It is saved under the "secure.square-enix.com" entry.
Q: How can I clear saved login fields from XIV on Mac?
The entries will either be located in the newer Passwords app under Applications or they will be in the older Keychain Access app which can be found at /System/Library/CoreServices/Applications/Keychain Access. The entries will be under secure.square-enix.com.
If you have saved an OTP secret, there will be two entries. One will say “Your Username” in the Account field, the second will say “Your Username(OTP secret)” in the Account field. They may be in different apps.
To remove the saved info for username/password or OTP login fields, delete the entry for the password or OTP secret respectively.
Q: What keyboard shortcuts can I use with XIV on Mac?
To prevent auto-login, if enabled, hold SHIFT (⇧) when starting XoM.
With the LAUNCHER as the focus application:
Settings: ⌘,
Open Install Folder (this is where you will find logs!): ⌘I
Select Game Path: ⇧⌘O
Repair Game Files: ⌘R
With "Metal 3 Performance HUD" enabled in the Graphics tab of Settings for the Launcher AND with the GAME as the focus application:
Hide/Show the HUD: ⇧F9
Move the HUD between predetermined positions: ⇧F7
Q: How do I turn off Auto-Update for XIV on Mac?
If you've enabled the option to automatically install updates for the launcher, run this command in Terminal to turn them off.
defaults write dezent.XIV-on-Mac SUAutomaticallyUpdate 0
Q: My Mac gets very warm and the fans spin up while playing. Is this a problem?
This question is commonly asked by users switching from playing Final Fantasy XIV on a Windows laptop to XIV on Mac.
No, this is not a problem. Final Fantasy XIV is a demanding game that makes heavy use of the CPU, GPU, and memory. This will cause components to get warm and may result in fans turning on.
Apple laptops are built to run heavy loads continuously without any adverse effects, so you don't need to worry about heat. Ensure that your Mac is placed on a solid surface, such as a desk or tray, for best airflow.
If you would like to conserve battery life when unplugged, or are distracted by fan noise, you can limit the game to 60FPS or lower in XIV on Mac's preferences pane. Do not use the in-game FPS limiter as this does not work properly under Wine.
More information is also available at https://support.apple.com/en-au/HT202179 and https://support.apple.com/en-au/HT201640.
Q: On a newly set-up Mac, the game fails to launch or hangs on "Starting Game..."
Try forcing an install of Rosetta by running this command in Terminal.
/usr/sbin/softwareupdate --install-rosetta --agree-to-license
Q: How can I uninstall XIV on Mac?
Download the highly recommended app called App Cleaner which is the easiest way to uninstall any app and its associated files from your mac. Just drag the app into the App Cleaner window and it gathers all the files to delete. You will also need to empty the trash for the space to be cleared. https://freemacsoft.net/appcleaner/
Q: How can I play at full resolution on a Retina Display?
By default, XIV on Mac runs at a your desktop's scaled resolution. This generally falls between 800p to 1440p depending on your display and prioritises frame rate over visual quality.
To override this and play at full resolution, open XIV on Mac's preferences and untick "Enable macOS scaling". Restart the game and it should now be rendering at Retina quality.
This setting is available on all Macs, but a high-end mac is required in order to maintain 60FPS.
You may need to make changes to the HUD configuration so that text/icons as well as chat remain legible when rendering at a high resolution:
- System Configuration -> Display Settings -> High Resolution UI Settings -> 200% (WQHD)
- Character Configuration -> Log Window Settings -> Log Details -> General Font Size -> 20
- Character Configuration -> Log Window Settings -> General -> Chat Prompt Font Size -> 20
Q: Can I use Advanced Combat Tracker (ACT)?
XIV on Mac no longer supports Advanced Combat Tracker. IINACT is a Wine-friendly alternative that runs as a third-party Dalamud plugin.
Q: Switching sound outputs break Final Fantasy XIV's audio until a restart. How can I work around this?
This is caused by a bug in the game's engine, affecting Windows, macOS (official/XoM) and Linux (XLCore) clients.. Changing the system sound output will make audio stop working until the game is restarted.
One solution that works most of the time is to go to the Tools menu for XoM, click on Wine Configuration, select the Audio tab, and switch to your desired audio output.
You can work around this issue by using an app such as SoundSource or Sound Control. These apps work by routing all audio to a single virtual audio output, then redirecting that to your chosen output.
Q: How can I increase audio quality while playing Final Fantasy XIV with AirPods?
Any application which activates the microphone on AirPods (such as Discord calls) will drastically reduce audio quality, due to the bandwidth limitations of Bluetooth.
If your Mac has a built-in microphone, try setting this as the default instead of the microphone on the AirPods.
Q: Why is my game not loading?
Startup problems can be caused by a number of reasons, due to the complex nature of XIV on Mac's launch process.
The most common thing interfering with XIV on Mac is third party anti-virus software, which often deletes/damages/blocks access to critical Wine components required for Final Fantasy XIV to run. ISP or networking problems will also stop the game from working correctly if XIV on Mac can't connect to login servers. Unsupported Dalamud plug-ins or mods may also cause problems.
As errors of this nature can be hard to diagnose yourself, we recommend creating a support post in the XIV on Mac Discord. We will be able to analyze your logs and better assist you.
Q: Why do I get a prompt to install C++ on game startup?
If you encounter an error on startup asking for C++ redistributables to be installed, it means that XIV on Mac has failed to properly initialise Dalamud's core components. This can happen if you have manually configured any DLL overrides.
To resolve this issue, go to Tools -> Wine Configuration in the XIV on Mac menu bar. Select the "Libraries" tab in the window that appears. Then, ensure that there are no entries in the "Existing overrides" section:
After removing the entries, try starting the game to see if the issue is resolved.
Q: My game crashes with Dalamud enabled or Dalamud cannot download the plugin list?
This issue may occur for some users who have IPv6 enabled. There are a couple ways you can resolve this, detailed below. If you're unsure which to choose, try following the steps for "Configure only IPv4 DNS resolvers" first.
Configure only IPv4 DNS resolvers
1) Open System Settings.
2) Go to the Network tab, and click the "Details..." button on your currently active network connection.
3) Go to the DNS tab.
4) A list of DNS Servers will be displayed here. There may be several greyed-out entries here already - these are obtained from your router and can be ignored.
5) Click the "+" button to add a new DNS server. You can define any IPv4-based service you like, but if you are unsure, here are some safe choices:
CloudFlare DNS: 1.1.1.1 and 1.0.0.1
Google DNS: 8.8.8.8 and 8.8.4.4
Please choose only choose one provider and create entries for both IP addresses listed.
6) Once you're done, the list should look something like this:
7) Click OK, and try launching the game again.
Set IPv6 to Link-Local Only
1) Open System Settings.
2) Go to the Network tab, and click the "Details..." button on your currently active network connection.
3) Go to the TCP/IP tab.
4) Click the dropdown next to "Configure IPv6" and select "Link-Local Only". It should look like this:
5) Click OK, and try launching the game again.
Q: Why does my game have black textures?
If you are using a FFXIV Windows license, and run on Max in-game settings, you may experience black textures in game similar to the image below.
To fix this issue, press the "Escape" key, go to "System Configuration" and then "Graphic Settings" icon. Scroll down until you see "Screen Space Ambient Occulusion". You will then need to turn this down to "Strong", "Light", or "Off". HBAO+ settings will not work properly in MacOS.
Q: Where can I browse and download all versions of XIV on Mac?
All versions of XIV on Mac starting with 2.x are available at https://softwareupdate.xivmac.com/sites/default/files/update_data/.
Q: Is XIV on Mac safe?
Yes. We take special care to emulate the login flow and user agent of the official client so that the login servers are not able to tell that a third party launcher is in use.
Launcher Security
The XIV on Mac project and its various components are open source. You can view all our code on GitHub at https://github.com/marzent/XIV-on-Mac. Login credentials are only sent to FFXIV servers and never transmitted anywhere else.
All releases are signed by a Developer ID and notarised by Apple. You can read more about the app notarisation process on the Apple Developer page.
Furthermore, all updates are signed by a Sparkle EdDSA key to verify authenticity.
If you choose to save your credentials, XIV on Mac makes use of the macOS Keychain to securely store your password.
Platform Security
App downloads and updates are served by our updater service, softwareupdate.xivmac.com. This service might sometimes be used to proxy and cache downloads to certain external files to prevent users from being rate limited.
A separate service is used for centralised management of web content and app updates, content.xivmac.com. This service is only accessible to XIV on Mac staff and all accounts have time-based two-factor authentication enforced.
Both platforms described above run on a highly-available Kubernetes hosting cluster, with access to the administrative APIs only available through mutual TLS authentication. Additional hardening has been put in place on both the host and cluster networks through a combination of cloud firewalls and Calico NetworkPolicy configuration.
Update files are persisted to an S3-compatible service and encrypted both at rest and in transport.
As described above, all updates are signed using both an Apple Developer ID and Sparkle EdDSA signing key. An attacker would need to compromise both the signing key and hardened web platform in order to push an unauthorised update, making an attack of this nature extremely unlikely. Gaining access to either in isolation would not allow for new code to be accepted by clients.
In addition, XIV on Mac may reach out to the following external domains:
- github.com - used to download Anamnesis and GShade
- kamori.goats.dev - used to download and update Dalamud
- www.iinact.com - used to update IINACT
You can read more about Dalamud security here.
Responsible Disclosure
Think you've found a security vulnerability in XIV on Mac or one of our web properties? Please disclose it to us privately by emailing cybersecurity@xivmac.com.
False Positives
XIV on Mac makes use of Wine in order to run Final Fantasy XIV. As a result, some third party anti-virus applications may flag it as malware by mistake. This is an ongoing and well documented issue within the Wine community:
Some examples of third party anti-virus software include AVG, Avast, Bitdefender, Microsoft Defender ATP, and CleanMyMac. We will not be able to provide support if any third party anti-virus software is in use as it often damages app components, resulting in unexpected behaviour.
As described earlier, XIV on Mac app bundles are notarised by Apple, who check submitted apps for malicious content. macOS also includes a built-in, first party anti-virus that behaves correctly and does not false flag Wine based applications. Read more here.
Q: Does XIV on Mac accept donations/crowdfunding?
While we are incredibly grateful for your offers of support, we do not accept direct financial contributions. However, you can help us out by boosting our Discord server, assisting users in support channels or spreading the word. Donating to charity would be a nice gesture too!
Q: Where can I get general advice or help with Mac gaming?
Join our Discord! Although we are focused on Final Fantasy XIV, we try to help or provide feedback with all things Mac gaming (such as the Apple game porting toolkit) in the #general or #other-games channels!.