Troubleshooting
A quick list of common fixes for standard issues
Last updated
Was this helpful?
A quick list of common fixes for standard issues
Last updated
Was this helpful?
You must have a Teamcraft account and be logged in to it to ensure that character linking works properly.
If you are playing FFXIV using the Chinese client: Please ensure that Teamcraft is pointed to the correct folder for your character data in Settings > Desktop > Inventory tracking, as this differs between the Global and China regions.
NordVPN: NordVPN cannot work with Teamcraft if the Threat Protection features are active.
Open NordVPN and click the gear in the top right to open settings. On the General tab, either disable Threat Protection, or add exceptions to it for ffxivteamcraft.com
, firestore.googleapis.com
, firebaseio.com
, etc.
Mudfish: Teamcraft will not work with the WFP feature enabled. Open Mudfish and navigate to Settings->Programs. The WFP feature should be disabled.
Mullvad: Mullvad's AdBlocker feature will break the connection to the Teamcraft database. Open Mullvad and disable the ad blocking feature. Mullvad's website has good alternatives that won't break Teamcraft.
If your VPN is based on L2TP: It should Just Work™ in Teamcraft.
BitDefender can cause Teamcraft to fail to install properly AND potentially lock down your FFXIV config files.
One way to keep it from complaining is by whitelisting
%LocalAppData%\ffxiv-teamcraft\app-X.X.X\FFXIV Teamcraft.exe
This is unfortunately only temporary, as the path to the EXE file changes with every update because of how Squirrel Installer works.
Another way to fix this permanently is, of course, to use another antivirus; BitDefender is triggered by Teamcraft's packet capture system because it calls the win32 api to inject a dll in the game process, which makes BitDefender react immediately.
It doesn't check what's injected or how it's used -- injection = trigger -- which is overzealous and not best practices on their part.
Sadly, certain countries appear to entirely block Firebase, our hosting solution for Teamcraft, so it may be the case that the only solution is to use a VPN to get around this.
Warning: This process will log you out of Teamcraft, so please ensure you know your password to log back in. This process may also delete any offline lists you happen to already have (but if the entire site fails to load, there is likely not much you can do about that).
Chrome: Click Site settings
, then click the Clear data
button near the top.
Firefox: Click Clear cookies and site data...
, then click Remove
in the prompt.
Edge: Click Cookies
, then click ffxivteamcraft.com
and click the Remove
button.
When you have selected to "Allow on device" or "Restore" (depending on the display and your version of Windows), be sure to also click the "Start actions" button below them! If you do not, the restoration of the file/the allowing of the setup on the device will not go through.
One way this can be fixed is by whitelisting Firestore. Go to Kaspersky and https://firestore.googleapis.com/*
and https://*.firebaseio.com/*
The first step here is to press the Update list to latest Teamcraft Version button at the top of the list page. A lot of issues will be resolved by this if the list was made in the past and certain features have changed. If this does not resolve your issue, see .
You may also wish to check the solutions for or .
Please investigate whether you may need to add exceptions to your /security software/antivirus/adblocker for the sites TC needs to work. You will wish to whitelist the following:
Download and Reinstall
At this point, you will likely need to make a bug report; this can be done on the in the #troubleshooting
channel.
For ease of reading, you will want to copy the template below into the #troubleshooting
channel of the , and fill in your information next to the >:
The instructions below are for Microsoft Defender/Windows Security/Windows Defender, the antivirus that is built into Windows and enabled by default on most PCs. If you are using a different antivirus solution, please review . The steps below may still be helpful in resolving this issue, however!
When attempting to download the setup, Chrome or Edge (or other Chromium-based browsers) may attempt to block the download, as they believe the file to be suspicious. This is normally a good thing, but in order to download Teamcraft while it is still misidentified as suspicious, you will want to follow (from HowToGeek) to TEMPORARILY disable the feature. Once it's disabled, try to download the file again. Once you have successfully installed Teamcraft and all is working, please re-enable that feature, as it is usually helpful in keeping you safe.
After downloading the setup, it's likely that Windows Security/Windows Defender, or perhaps your own antivirus, will immediately mark the file as potential virus/malware. This may sometimes mean that a warning pop-up happens in the corner of your screen, which it's easy to click on in order to continue with in Step 4 of this troubleshooting section. In many other cases, the file may be silently blocked. The setup may also fail to run, with a message stating that "Installation has failed" with a button to "Open Setup Log" (that log is typically not actually helpful for our troubleshooting, either). (If you do check the log and get confused by why it mentions Squirrel Updater and Discord or Microsoft Teams, that is because Squirrel Updater inexplicably puts all its installer logs in one file,. Teamcraft, as well as those other programs, use Squirrel Updater for automatic updates. This has nothing to do with your installations of any other programs!)
If you receive the above error about "installation has failed," you may try one simple fix for that (but it is unlikely to be sufficient on its own): 1. Right-click the Setup file 2. Select Properties 3. Search the bottom of the Properties window for an Unblock button, and click it 4. Click the OK button at the bottom 5. Try to run Teamcraft again (but it is probably still being blocked by your antivirus... hurrah... Please continue with the rest of the troubleshooting below)
It is highly likely that Windows has already marked the Setup as suspicious, so please open your Start Menu and search for "Windows Security". When it is opened, you MAY see something like this image, indicating that installation of Teamcraft was blocked (the name of the detection and the file it claims contains the problem will likely differ, because it doesn't know what is wrong... because there is nothing wrong...):
You may instead see something like this, which doesn't even try to tell you that anything is wrong, or that any files were quarantined. How informative and helpful of Windows! We will have to go a bit deeper to investigate.
Click on "Protection history", where you should see a recent detection that looks something like this, with a dropdown to "Allow on device" or "Restore" (or Block threat, or Quarantine, or Remove... but those are the opposite of what we want to do):
You may now restart your computer, download the setup file again, and hopefully this time it will run. However, until the dev and our helpful volunteer determine a way to keep this from happening, Windows Security may continue to complain repeatedly. To help avoid this behavior, which we know many users find annoying, we will need to make an exception through Windows Security until the false positive issue is resolved. Look toward the bottom of the Windows Security settings for the actual "Virus & threat protection settings". Click on the "Manage settings" link as indicated below:
Scroll down the page that appears to "Exclusions", then select "Add or remove exclusions".
Add a folder exclusion for Teamcraft's install folder, %LocalAppData%\ffxiv-teamcraft\
.
By default, that folder is located at C:\Users\[Username]\AppData\Local\ffxiv-teamcraft\
. So, depending on whether you've manually moved that folder (you would already know you did this, so please use the appropriate variable or input the moved folder), your exclusion will look something like this:
Hopefully you are now able to run the setup and have the Teamcraft desktop app install properly, with all its features working! If you still receive an error like this when Teamcraft finally successfully opens... ... then unfortunately, it is likely that the antivirus still "ate" files out of your installation, meaning you did not get to complete the install properly, and it is now a "dirty install." Follow , and keep an eye out just in case your antivirus decides to try to block the setup AGAIN.
If you are still struggling after following all the steps above for this accursed antivirus false positive problem, please reach out to us via the #troubleshooting
channel on our for more personalized support! But this appears to resolve 90+% of cases. Thank you for your patience as we work to permanently resolve this issue!