👾Troubleshooting
A quick list of common fixes for standard issues
Packet capture is not working properly; my inventory won't update, TC can't detect my gearset's stats from the game, etc.
If the above are true, please try the following.
My character is not detected/appears as "Unknown," my inventory info is inaccurate/outdated, or packet capture is working but my inventory still does not update properly.
There is likely an issue with character linking on your desktop client.
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.
You MUST teleport to an entirely different zone than the one you are currently in -- for example, Limsa to Mor Dhona -- as this may not work properly if you merely use aethernet teleports within the same zone.
I am using a VPN or other security tools, and some portion of Teamcraft is not working properly.
Teamcraft needs to see packets to parse them. Most VPNs hide packet contents for privacy, so Teamcraft isn't able to see them. Here are some suggestions for how to make some common VPNs cooperate with Teamcraft.
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.
Kaspersky has sadly been blocking Firestore, which is Teamcraft's database, by default.
One way this can be fixed is by whitelisting Firestore. Go to Kaspersky and add https://firestore.googleapis.com/*
and https://*.firebaseio.com/*
to its whitelist.
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.
My list isn't working.
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 I am still having an issue.
I am unable to access the site at all. (Russia/Turkey/limited countries)
Sadly, certain countries 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.
Conversely, you may also wish to check the solutions for VPNs interfering with Teamcraft functions or the below guide for pages not loading properly.
Teamcraft Guides pages only load the headers and none of the guides, or other pages similarly don't load most of their contents.
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 theClear data
button near the top.Firefox: Click
Clear cookies and site data...
, then clickRemove
in the prompt.Edge: Click
Cookies
, then clickffxivteamcraft.com
and click theRemove
button.
If clearing site data was not enough to resolve your problem:
I believe I may have a dirty install and need to fully remove all remnants of older versions of Teamcraft.
I am still having an issue.
At this point, you will likely need to make a bug report; this can be done on the TC Discord server in the #troubleshooting
channel.
How to open the console to help troubleshoot your issue
To see the developer console for Teamcraft, press Ctrl+Shift+I and click the Console
tab. Please take a screenshot of this so that you may paste it into Discord for more efficient troubleshooting!
How to submit a bug report for Teamcraft: definitions
For ease of reading, you will want to copy the template below into the #troubleshooting
channel of the Teamcraft Discord, and fill in your information next to the >:
Bug Report Template
Last updated