Uninstall Starts But Doesn't Complete / Manual Uninstall

Problem

Fantasy Grounds Unity begins the uninstall process, but no progress appears and the uninstall process doesn’t complete.

NOTE: In rare cases, we have discovered that the Fantasy Grounds uninstall process does not start as intended. Our developers are aware of this issue and a fix will be released in a future update.

If you would like to help our developers investigate this issue, please locate and send the following .LOG file to us via a new support ticket.

Conditions

This file must be pulled immediately after the button does not work; the updater application is closed; and before restarting any applications.

File Locations

Windows:
%USERPROFILE%\AppData\LocalLow\SmiteWorks\FGUpdaterEngine\Player.log

Mac:
~/Library/Logs/SmiteWorks/FGUpdaterEngine/Player.log

Linux:
~/.config/unity3d/SmiteWorks/FGUpdaterEngine/Player.log

Create a new bug report / support ticket:
Link: https://fantasygroundsunity.atlassian.net/servicedesk/customer/portals

Thank you for your assistance in resolving this issue! Please see solutions below.

Solution

Check for a /channels directory

In a majority of cases, we have discovered that the absence of a /channels folder can cause the uninstallation process to halt before starting. This can be resolved by creating a channels directory in the Fantasy Grounds data directory. OS-specific locations below.

To check for this folder, go to the following locations:

Windows 10/11:
C:\Users\[username]\AppData\Roaming\SmiteWorks\Fantasy Grounds\

macOS:
/Users/[username]/SmiteWorks/Fantasy Grounds/

Linux:
/home/[username]/.smiteworks/fgdata/

Note: .smiteworks is a hidden directory denoted by the . at the beginning of the folder name.

If there is no channels directory in the location listed above, you can create a channels directory manually, then try the Uninstall process from Fantasy Grounds --> Settings again. It should start and complete as expected.

Checking Windows 10/11

  1. First, make sure Windows 10/11 has downloaded and installed all updates, rebooting as requested by Windows to ensure everything is updated fully.

     

  2. Next, make sure that Fantasy Grounds Unity has write permissions in Windows 10. You can refer to the following help article for more information on this issue: https://fantasygroundsunity.atlassian.net/wiki/spaces/FGCP/pages/1161756673

Check Antivirus / Antimalware / Network Protection Programs

If system or network protection software has accidentally locked down or quarantined Fantasy Grounds Unity applications, they may not allow Fantasy Grounds Unity to run its uninstall routine successfully. Be sure to whitelist the following Fantasy Grounds programs in any antivirus, antimalware, network protection, firewall, VPN, etc. software:

FantasyGrounds.exe
FantasyGroundsUpdater.exe
FGUpdaterEngine.exe

Manual Uninstall - Windows - Removing Fantasy Grounds Directories

Before removing directories, be sure to backup your Campaign and Extensions folders located in the Data folder location listed below.

In a default Windows 10 installation of Fantasy Grounds Unity, the following directories are created and populated. You can manually delete the following directories and all their contents:

App: C:\Program Files\SmiteWorks
Data: C:\Users\[username]\AppData\Roaming\SmiteWorks\

[username] denotes the account name you use when logging into Windows 10.

Note: If you changed the installation or data directory locations during setup, you will need to locate the directories on your machine and delete them.

Can’t Find AppData - Enable Hidden Files

If you cannot find the AppData folder in File Explorer, follow these steps:

  1. Navigate to the C:\Users\ directory\[username]\ directory

  2. Click on the View tab at the top.

  3. Locate the Hidden items checkbox and place a checkmark in it.

You should now see the AppData directory. It will appear slightly transparent to denote that it is a hidden file/folder.

If you plan to immediately reinstall Fantasy Grounds, you can usually skip the following steps.
If there was a technical issue that caused you to uninstall Fantasy Grounds and it is not resolved by reinstalling, uninstall and complete all of the steps below, reboot, then reinstall Fantasy Grounds.

Manual Uninstall - Windows - Removing Registry Keys

Caution: When working in the Windows Registry, it is always a good idea to make a backup of the registry before continuing. See the following Microsoft Support article for more information:
https://support.microsoft.com/en-us/topic/how-to-back-up-and-restore-the-registry-in-windows-855140ad-e318-2a13-2829-d428a2ab0692

To remove the Windows Registry keys added by Fantasy Grounds, follow these steps:

  1. Open Registry Editor. There are two ways to open Registry Editor in Windows 10:
    - In the search box on the taskbar, type regedit, then select Registry Editor (Desktop app) from the results.
    - Right-click Start, then select Run. Type regedit in the Open: box, and then select OK.

  2. Find the following registry entries:
    Computer\HKEY_CURRENT_USER\SOFTWARE\SmiteWorks
    Computer\HKEY_LOCAL_MACHINE\SOFTWARE\SmiteWorks

  3. Right-click on the Smiteworks folder on the left, then click Delete. Select Yes when prompted.

Manual Uninstall - Windows - Remove Desktop Icons

Right-click on the desktop icon and select Delete.

If you are not displaying icons, you can find the shortcut in the following location:
C:\Users\[username]\Desktop

Manual Uninstall - Windows - Uninstall or Change a Program

Now, in the search bar next to the Start menu, type Control Panel and click on the app.

Once there, click on Uninstall a program under the Programs section.

Locate the Fantasy Grounds Unity entry
Note: The entry may have “Demo” in the title. This is normal even if you’ve purchased a license.

Once highlighted in the list, click Uninstall at the top, or right-click the entry and choose Uninstall.
Since you have already manually deleted all of the programs and directories associated with Fantasy Grounds, you will be asked if you would like to remove it from the Programs list. Click Yes.

If you installed via Steam, you may get the following screen when attempting to uninstall:

If you need assistance with the Manual Uninstall process, please feel free to contact Customer Support:
Link: https://fantasygroundsunity.atlassian.net/servicedesk/customer/portals

Manual Uninstall - macOS

The App directory is located here:
/Applications/SmiteWorks/Fantasy Grounds/

The Data directory by default is here:
/Users/[YourUsername]/SmiteWorks/Fantasy Grounds

You can manually remove Fantasy Grounds by dragging these two folders from their default locations into the Trash, then empty the Trash when you are done.

The Applications directory (shown in Icon view):

 

The Data directory (shown in Folder view):

Additionally, if you moved the Fantasy Grounds application icon to the desktop or pinned it to the dock bar, you can also move them to the Trash to remove them.

Manual Uninstall - Linux

Since all information in the Ubuntu Linux installation is stored in a hidden directory in your /home/[username]/ directory called .smiteworks, you can simply delete that directory by dragging it to the trash and then emptying the trash.

Note: If you do not see the .smiteworks directory, you may need to place a checkmark next to "Show Hidden Files" in the menu shown in the image below:

If you are running running a version of Ubuntu with a different desktop environment, or simply wish to use the terminal, you can use the following instructions:

Launch a Terminal session and enter the following command:
cd ~/.smiteworks ; rm -r fantasygrounds fgdata ; cd .. ; rmdir .smiteworks

You may need to precede certain commands in this line with the sudo command if you do not have permissions to delete/remove files and directories. The sudo command would precede the the rm and rmdir lines.
cd ~/.smiteworks ; sudo rm -r fantasygrounds fgdata ; cd .. ; sudo rmdir .smiteworks

If you need to break the command down into its individual parts, enter each line, then hit Enter:
cd ~/.smiteworks
rm -r fantasygrounds fgdata
cd ..
rmdir .smiteworks