/
Installing on Mac OSX (on Steam)

Installing on Mac OSX (on Steam)

NOTE: Fantasy Grounds VTT (FGVTT) used to be called Fantasy Grounds Unity (FGU). Some screenshots were made prior to this renaming and may reflect the old FGU name. Please bear with us while we update the wiki to match current naming conventions and visual aesthetic changes.

Install the Software

  1. From within the Steam Store page, click in the Search box in the upper right and type Fantasy Grounds VTT

    ImagesRichShot-372D1D73-103A-4083-9722-7FE22A38645E-4470-000008533A92A2A4.png

  2. Once located, click the Fantasy Grounds VTT box.

    ImagesRichShot-04B5032C-5829-46C5-A712-A9FB80D31B7F-4470-00000870D7C3B933.png

  3. On the Fantasy Grounds VTT page, scroll down and click the Download Mac Demo button to download and begin the install process.

ImagesRichShot-A20B1BF5-9759-4C60-8AC1-8AEA88CE2519-4470-0000088F1C3FBDD2.png

  1. Click the Install button to continue through the installation process.

    ImagesRichShot-16C33DF5-4A54-4B96-8702-E340FC2D446E-581-00000394FB25FF16-20250716-192657.png

  2. Navigate to your Steam Library and locate the Fantasy Grounds VTT Demo, then click Play.
    Note: It may be listed as simply Fantasy Grounds VTT if you purchased a license key for it via Steam.

    ImagesRichShot-DA479C56-42A7-46A0-B8AD-70DE78C80A43-4470-000008DED56A8E7B.png


    If a license key was detected from an earlier purchase of Fantasy Grounds VTT, a window may pop up prompting you to write down or copy your license key.
    We recommend recording this license key for later in the installation process.

    image-20240910-210521.png

  3. The Web Install package will load and select basic install parameters. Click Continue.

    ImagesRichShot-9543622B-2587-4B22-BE09-BB399E9D15F9-581-000000F107898E1E-20250716-183834.png

  4. If you have multiple user accounts in macOS, you can select other options, but if you only have one account, it should default to Install for all users of this computer. Click Continue.

    ImagesRichShot-708FD1FD-E918-41AB-A48A-0E4884BCCE2F-581-0000011F74A74576-20250716-184154.png

  5. Click Install to continue.

NOTE: It is recommended to allow the Installer to install Fantasy Grounds VTT in the default location. Changing the Install Location could potentially cause permissions issues and the inability for Fantasy Grounds VTT to write necessary files and configurations.

ImagesRichShot-D34E5B8B-7888-4E66-9122-AA6D6A2C03F8-581-0000012A5F3F7F77-20250716-184240.png

  1. The installer may ask for permissions to complete the installation. Enter your password, and username if it isn’t already entered, and click Install Software.

    ImagesRichShot-2577E0CD-5906-40AD-BBB2-0357BF32524C-581-0000017B5D771B97-20250716-184828.png

     

  2. Take a moment to read the Next Steps and click Close when ready.

    ImagesRichShot-6F1F474C-A9DF-4A6F-BA2C-63A503B1E29E-581-00000191E3283460-20250716-185005.png

NOTE: There is currently an issue with macOS Big Sur 11.0.x that may affect our installer.
If you are installing in macOS Big Sur, and encounter the issue where FGU can’t find FGUpdaterEgine or start the Updater, please follow the temporary workaround listed here, then continue on from Step 6 below:

  • open Finder or Spotlight or Terminal and navigate to : /Applications/SmiteWorks/Fantasy Grounds/FGUpdaterEngine

  • launch the FGUpdaterEngine.app found in that folder

  • the .app will run through an update and close

  • you can now navigate to : /Applications/SmiteWorks/Fantasy Grounds/ and launch FantasyGroundsUpdater.app

  • continue installation from Step 7 below

  1. The Fantasy Grounds VTT setup should run automatically (except on Big Sur).

  2. After installation is complete, the FGUpdateEngine will run to guide you through setting up file locations, username and password verification as well as license key entry.

    ImagesRichShot-40B237AA-D7DC-47EB-B57A-91622BC0F134-581-000001E42CAA1807-20250716-185558.png

  3. CChoose a path where your data files will be stored. This will require the most storage space for modules, maps, extensions, etc., so make sure this location will have ample space.

    We recommend keeping the default setting as this help ensure that system permissions will allow Fantasy Grounds VTT to read and write necessary files in this location after installation.

    Click the Check Directory button to make sure the installer has the proper permissions to create the directory.

    ImagesRichShot-ADD4D25F-CC22-437B-A19F-58D56BB71F63-581-000001FD7403BCAA-20250716-185747.png

    If there are no additional permissions needed, the Check Directory button will change to Continue. Click the Continue button to proceed.

  4. Type in your username and password, then click the Log In button. Once your login credentials are validated, you will see a “Login Successful!” message. Click Continue to go to the License Key screen.

    If you don’t yet have an account, you can click the Click Here To Create One Now link above the username box to create an account. Your Fantasy Grounds forum account is what you use to log in.

NOTE: Fantasy Grounds account usernames are case-sensitive. Be sure to enter your username into Fantasy Grounds exactly as it appears in the forums.
ie. DragonSlayer is not the same as dragonslayer.

ImagesRichShot-271DA9B7-0A0D-4503-966B-ADDC54C52402-581-0000025FD0284216-20250716-190449.png

  1. If you have a license key, enter or paste it into the License Key box and click Finish.
    If you do not have a license key and wish to Demo the software, just click Finish.

    ImagesRichShot-91534161-5099-4AEB-8092-311807A09B87-581-000002974038028B-20250716-190848.png

  2. Once these steps are completed, click Update to run the latest update. The Updater will install the latest version of Fantasy Grounds VTT, including modules and any purchased products you have linked to your FG account from Steam or from the Fantasy Grounds VTT website.

    ImagesRichShot-25DEB110-5682-4313-BDA6-91F651362998-581-000002BAEC04103D-20250716-191121.png
    ImagesRichShot-A4246B49-277A-4697-A68A-056854CD1310-581-000002DD0AA09BD5-20250716-191347.png

NOTE: Once Fantasy Grounds VTT has updated the FGUpdaterEngine program, it will restart and may look different. This is because FGVTT has updated it’s core theme since the original launcher was uploaded. This is normal.

  1. Once the updater has completed it’s process, click Launch Fantasy Grounds and accept the End-User License Agreement to proceed.

    ImagesRichShot-0548BA6B-A7E5-4D7D-A9BF-32A87BF4857F-581-000002FCD4AE3F90-20250716-191604.png