Fixing World/Performance Slowdowns


Here at The Forge, we value all of our customers, and want them to receive the best possible experience with Foundry Virtual Tabletop.

In the course of using Foundry VTT on The Forge however, performance can (rarely) be inconsistent or even debilitating. Below, we attempt to outline possible solutions for the users experiencing these problems.

World Size

Doing certain things on Foundry, like importing too many monsters or using modules that conflict can cause a world’s size to grow beyond reasonable limits, and take much longer to load. This world’s increased size is often unnoticeable on a local Foundry installation, due to the data being located locally- but players/other users attempting to connect to your Foundry instance will notice when attempting to load in the world. The same applies to The Forge.

To verify if a world is too large and fix that issue, we recommend reading this article and following its troubleshooting steps.

Poor Image Sourcing

We do not recommend using external image URLs on The Forge, since these images often lack optimization that we offer through our CDN, the user has to rely on the whims of a website/image host (if they are not hosting those images themselves), and because if those hosts go down, those images will disappear as well, once they are no longer cached (stored temporarily) on the user’s device.

If these images become inaccessible and cannot load, users can become stuck as their computer/device attempts to keep loading those images. If there are many images that refuse to load, this can result in loading times of several minutes to access a game, or when switching to a scene where those images are referenced.

To fix this issue, we recommend deleting any tokens/tiles placed on scenes that reference an external image URL that won’t load. We also recommend changing the image URLs for any entities (actors, items, etc.) to an image stored on The Forge. Downloading the world for local editing (backing it up while you do so), and then re-uploading the world via our Summon Import Wizard may help this to go faster. We understand that if there are many entities in the world with this issue, this can take quite a long time- which is why we recommend not using external images in the first place.

You can verify if missing/inaccessible images are the problem with your world by opening your browser’s console, and checking for any red-highlighted errors. If they reference images used in your world, that may be why you are experiencing performance issues.

Module Conflicts

The module community for Foundry VTT is made up of many generous developers. These developers (often unpaid) spend their time developing software that helps enhance the Foundry experience- for some people, in ways that are vital to their user experience.

However, it is physically impossible for software to be bug-free, especially when multiple different software interact on Foundry VTT, in the form of various modules.

To check for module conflicts, we recommend following the steps noted in this guide.