Overview

Legacy Mode is one of the ways VTT is able to continuously evolve without breaking existing games. Many bug fixes are done behind the scenes and do not need any sort of explanation. Other changes are handled through Version Upgrades. For those, older games that use the deprecated behavior are automatically updated by VTT. But some bug fixes are more complicated and not easily handled through the versioning system. That is where Legacy Mode comes in. The basic idea is that each major bug fix will get a checkmark in the Game Settings. Game Settings are available in Edit mode in the menu on the right. Under Game Settings, you will see each of the bug fixes listed next to a checkbox that can be switched on or off. The default when creating a new game is to have the Legacy Mode settings disabled. Many games created before October 22, 2025 (the date of v18 due to PR #2581) have Legacy Mode enabled by default so they will not change behavior. When any Legacy Mode feature is active, there will be a badge with the number of active features indicated.

User Actions

Be careful when copying or editing games that have one or more Legacy Mode features active. The changes can be subtle and difficult to detect when just copying and pasting code. Test and test again. If in doubt, it is okay to leave the same Legacy Mode features checked in the new or modified game.

If you have made changes to a game with Legacy Mode features, tested it, and are confident that it will work without Legacy Mode, uncheck the box for that mode under Game Settings and click the red and white Remove button. This will remove that Legacy Mode setting from the game forever. This cannot be undone.

Legacy Mode Features

The complete list of Legacy Mode Features is available on a separate page.