👾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.

• Attention PS4/PS5 Players: Packet capture (and therefore inventory tracking) does not work for the PS4/PS5, only on PC.

• Are you using the Desktop App? Packet capture (and therefore inventory tracking) only works on the desktop app (and only when your game is running DirectX 11; if you are still using DirectX 9, packet capture can no longer work due to packet changes by Square-Enix). It will not work on the web version, and inventory information is only stored locally on your computer. Please make sure you have the app downloaded and installed before trying to use packet capture.

• Is the app updated? Teamcraft needs to be on the latest version of the app for packet capture to work. If you are not up to date, please update before continuing.

• Have you restarted Teamcraft? As of version 8.0.12, PCAP no longer requires a client update to update OPCodes. Restarting Teamcraft can resolve issues related to this.

If the above are true, please try the following.

• Open the console by pressing Ctrl-Shift-I and clicking the Console tab. Then type window.debugPackets = true; Press Enter, and move in game/teleport to a new zone. Is there any output after the command says true? If there is output, congratulations; packet capture itself is working! However, if Teamcraft is still telling you that your inventory is outdated, it is likely something has broken with your character linking. Please see the section below about fixing broken character links.

• Still no output? Are you using a VPN or a tool to lower your ping? This should broadly no longer have an impact, but please see the section below for successfully using your VPN with Teamcraft.

• Teamcraft might be getting blocked by your antivirus Some antivirus programs might attempt to block Teamcraft or its installer, out of an abundance of caution. Please try excluding the entire Teamcraft install folder in your antivirus. Teamcraft should be located at %LocalAppData%\ffxiv-teamcraft\. This may have caused the download or installation of your installer to become corrupted Since it is possible that the Teamcraft app may not have been installed properly due to this blocking, you may wish to re-download and re-install Teamcraft to ensure all components have been installed properly. BitDefender is a special case; 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.

• Still not working. :( Please try this process to make sure that you don't have a dirty install with old files related to Teamcraft laying around mucking things up.

• Still nothing. Am I hopeless? Please post your main.log (can be found in %AppData%\ffxiv-teamcraft\logs\) and the most recent Deucalion session log (can be found in %AppData%\deucalion) in #troubleshooting on the Teamcraft Discord server. We should be able to find what's wrong based on that.

• My main.log said "tasklist is unknown"! First, make sure Powershell is fully updated. Ensure that Powershell has been properly added to your PATH Variable: 1. Press the Windows key, search "env" and hit Enter 2. Click "Environment Variables" in the advanced tab 3. Under "System Variables", locate the Path entry 4. Click "New" and paste in %SystemRoot%\system32\WindowsPowerShell\v1.0 5. Click OK to confirm all this work, then try re-opening TC.

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.

• Go to Settings > Desktop, then click the buttons to 'Reset ignored characters' and 'Reset linked characters'.

• Restart Teamcraft.

• Go to the General > Inventory page and click the button to "Reset all inventories".

• In game, sort your inventory or otherwise move an item from one slot to another. Make sure at least one item moves. This should trigger a popup to select your character in TC.

• Once your character has been selected, teleport to a new zone.

You MUST teleport to an entirely different zone than the one you are currently in -- for example, Limsa to Eulmore -- 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.

• ExitLag: ExitLag does not cooperate with Teamcraft due to how it changes packet structure. You must use Raw Socket mode and run both TC and FFXIV as admin for packet capture to work.

• 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.

• OpenVPN-based VPNs, like Wireguard, Cloudflare, etc.: OpenVPN-based VPNs encapsulate packets, hiding them from Teamcraft. You must use Raw Socket mode and run both TC and FFXIV as admin for packet capture to work.

• 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/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).

• Clear site data/cookies for ffxivteamcraft.com Please click the lock icon in your URL bar at the top of your browser (next to ffxivteamcraft.com) and perform a process like one of the following (three common browsers are listed, but processes should be fairly similar across assorted other browsers) to clear your site data for Teamcraft.

• 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.

If clearing site data was not enough to resolve your problem:

• Please clear your browser's cache as well.

• Please investigate whether you may need to add exceptions to your VPN/security software/antivirus/adblocker for the sites TC needs to work. You will wish to whitelist the following:

• ffxivteamcraft.com

• firestore.googleapis.com

• *.firebaseio.com

I believe I may have a dirty install and need to fully remove all remnants of older versions of Teamcraft.

• Back up any offline lists you wish to keep This process will clear any offline lists you may have made. If you wish to back up a an offline list to your Teamcraft account, open the List itself and click the button near the top to 'Copy this list to your account'.

• Consider backing up your Desktop settings to make the reinstall more convenient Go to Settings > General and scroll down to find the button to Export settings. You may scroll down to this again after you have reinstalled Teamcraft and Import settings.

• Close all instances of Teamcraft Open your Task Manager and please end all Teamcraft processes.

• Clean up old Local files Press WIN+R and type %localappdata%. Locate the ffxiv-teamcraft folder and delete it. Find it again in the Programs folder, if it exists there, and delete it.

• Clean up old Roaming files Press WIN+R and type %appdata%. Locate the ffxiv-teamcraft folder and delete it.Uninstall TeamcraftPlease open Control Panel\Programs\Programs and Features and make sure that TC is not listed. If it is, please click it and click uninstall. It might fuss about the app not being able to be found; you may safely ignore this and click OK.

• Restart Computer Restart your computer just to be certain that no Teamcraft-related processes are running.

• Download and Reinstall Download the latest version of the app and install it.

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

• Issue: A clear and concise description of what the bug is.

• Steps to Reproduce: A bug that can't be reproduced can't be fixed. Explain in detail, with numbered steps, what needs to be done to trigger the issue or bug you are experiencing. It may help to pretend that you are explaining it to a reader who is not familiar with FFXIV, or the Teamcraft app!

• Expected Behavior: A clear and concise description of what you expected to happen.

• Software Version/Type: Are you using the website or the desktop app? If the app, then which version? If the website, then which browser?

• Additional Information: Any additional context that can help diagnose the issue. The more info, the better!

• Screenshots: Please provide any screenshots you can of what is happening. Opening the console via CTRL + SHIFT + I and clicking the Console tab is often extremely useful to help us diagnose the issue. Discord allows you to attach multiple screenshots to one post if need be!

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

**Issue:** 
> 
**Steps to Reproduce:**
> 
**Expected Behaviour:**
> 
**Teamcraft Version - Browser / Desktop Client**
> 
**Additional Information/Console:**
> 
**Screenshots:**