Recommended Settings
Check out the recommended graphics settings for the best balance of performance and visuals.

 

XIV on Mac Visual Setup Guide

 

 

Q: On a newly set-up Mac, the game fails to launch or hangs on "Starting Game..."

Try forcing an install of Rosetta:


/usr/sbin/softwareupdate --install-rosetta --agree-to-license

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:

ipv4 dns screen

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:

ipv6 setting

5) Click OK, and try launching the game again.

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". Ensure "Bugfix for non-scaling mode" is selected. Restart the game and it should now be rendering at Retina quality.

This setting is available on all Macs, but an M1 Max/Ultra or high-end AMD card (e.g Radeon Pro W6800X) is required in order to maintain 60FPS.

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: My game is freezing or has broken lighting and a "Currently busy" message appears in the bottom left?

XIV on Mac includes a very large state cache file to help reduce stuttering caused by shader compilation. If you see the "DXVK-macOS: Currently busy" message when starting the game, please remain on the title screen and do not log in to your character until this message disappears. This should not take longer than 5 minutes, and compilation on subsequent launches should not take longer than a few seconds.

Major macOS or XIV on Mac updates may require the cache to be rebuilt, but this will be handled in a similar manner.

If you are still experiencing problems, please try going to the Tools -> Troubleshooting menu to clear your cache and try again.

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 Keychain, 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: 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 using the contact information found here.

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.

Q: How do I find the launcher settings menu?

With the launcher selected, in your top menu, click "XIV on Mac", and then "Preferences". Here you will find the FFXIV settings, Dalamud, Wine, Social and DXVK settings.

Settings

Q: Where do I find my XIV on Mac install folder?

The install folder can now 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 folder, FFXIV Config, Dalamud, Wine Prefix, Logs, etc.

Install Folder

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 thread in the XIV on Mac Discord. We will be able to analyze your logs and better assist you.

Q: How can I improve performance on my Mac with an AMD GPU?

Due to a lack of Metal driver updates for legacy (Intel-based) Macs, users on some 500 series and lower end 5000/6000 AMD graphics cards may experience inconsistent frame pacing or stuttering.

To work around this, you can place a special configuration file within XIV on Mac's install folder which will modify some internal settings to improve performance. Follow these steps:

  1. Download this config: dxvk.conf
  2. Open XIV on Mac launcher, focus the launcher window and press "CMD+I"
  3. Open the "wineprefix" folder in the Finder window that appears.
  4. Navigate into the "drive_c" folder, and place the downloaded "dxvk.conf" file inside.
  5. Restart the game and launcher to apply the settings.

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.

black screen

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.

HBAO Settings