Game Worlds


A game world is an instance of a system with a cohesive data structure that allows for playing a tabletop game in Foundry VTT. Game worlds require a game system to be created. This article will familiarize you with the aspects of the game world menus: creating, installing, and editing. It will also discuss launching worlds, enabling safe mode, and deleting worlds.

If you are new to Foundry Virtual Tabletop and want help setting up your first game, we strongly recommend starting with: Tutorial - Gamemaster Part One

The Game Worlds Tab

Foundry VTT Configuration & Setup
The main menu tab of Foundry Virtual Tabletop where game worlds are listed (when created).

On the main menu of the Foundry Virtual Tabletop software is a menu that lists all game worlds that presently exist and can be manipulated or launched. When Foundry VTT is first installed there will be no worlds available, but new worlds can be created or installed easily.

Installing Premade Worlds ( )
Premade Game World Browser
The premade worlds browser allows you to select from a list of game worlds already configured for immediate play.

Foundry VTT provides several exclusive and community sourced premade worlds that are already set up and prepared for play. To install one of these worlds, click the Install World button, select a world from the list, and click the install button to the right of its entry.

Note: You will also need to install the game system that is meant to be used with this game world before you will be able to launch it.

Creating New Worlds ( )

Creating Worlds

Create World Menu
The create world menu allows you to create a new world with a game system of your choice.

The Create New World dialog has the following entries which determine different aspects of the game world. Many of these items cannot be changed once the game world is created.

World Title
This is the human-readable name of the world which appears at the top of every world entry in the game worlds tab of the main menu. This field is required, and can be changed later by editing the world after it is created.
Data Path
This is the folder name for where the game world's data is stored. As the create game world menu shows, this will be located in your foundry Data/worlds folder. This field is required and cannot be changed after the game world is created.
Game System
This is the game system tied to the game world. The system determines the data schema used in the world to store, categorize and utilize information on characters, items, and similar items unique to the game itself. This is required for a game world, and cannot be changed once the game world is created.
Background Image
This is the image that is used on the game world's login screen once the world has been launched. It's recommended that you use 1920x1080 or larger images for best appearance, but any web safe image format and resolution will work here. This field is optional and can be changed later by editing the world after it's created.
Next Session
This field allows you to determine the next time your game will run. You can manually enter the next game day, or click the calendar button to open a drop down calendar to select the specific date. This date will be shown to all users on the login screen when the game is loaded. You can also manually enter the time of day that the game is played, or click the clock to open a drop down clock to select the game session time. Both of these fields are optional, and can be changed later by editing the world after it's created.
World Description
This text box allows you to create a description of the game world, its themes, house rules, or to provide messages to your players when they are logging in to the game. You can see this text on the game worlds' tab of the main Foundry menus, as well as the login screen when the game world has been launched. This field is optional, and can be changed later by editing the world after it is created.

Game World Flags

On the Game Worlds screen of the main menu of Foundry there are multiple flags which can be applied to a game world to provide users useful information or warnings before they launch a game world. The possible flags are listed below.

Compatibility Risk ( )
The compatibility risk flag indicates that a module or system developer has not verified this package works in your current version of Foundry VTT. This does not mean that the module or system will not work, though it may experience errors. If your modules indicate compatibility risk, it is important to be cautious and watch for any issues or problems that may arise.
Compendium ( )
The compendium flag indicates that the game world contains at least one compendium.
Core Version ( )
The core version flag indicates the version of Foundry VTT that the world was initially created with.
Requires System Update ( )
The requires system update flag indicates the system attached to this world is missing, damaged or so out of date that the game world may not properly launch.

Launching Worlds

Game Worlds - User Login Screen
The world login screen allows you to log into an active game world or return to setup.

To launch a world click the Launch World button to the right of the world's name.

Launching a world begins the process of creating a server with a live game for your players to connect to. Once a world is launched a login screen will be available for players to join the game from. It will display the world title, background image, next session, session time, and world description.

Users can select the user account they want to log in with, which may require an access key, depending on how a game master has configured the users in the game world.

By default all newly created worlds begin with a single Gamemaster user account without a password. Additional users can be added after logging in. For more on creating users and managing their permission levels see the Users and Permissions article. Please note that attempting to log in to a user account using a password when the account itself doesn't have a password will produce a false "wrong password" response. To log into a user account that has no password, leave the password field blank.

Return to Setup

From the login page you can use the Return to Setup option to close down the world and return to the main setup menus for Foundry VTT. Doing this will log out all users currently in the active game world. If you have an admin password set for your software you will need to provide it to use this option, unless you previously logged in as an Admin, at which point the server will automatically recognize you.

Editing Worlds

Edit World Menu
The Edit World dialog allows you to change certain aspects of the game world after it has been created.

To edit a world click the Edit World button to the right of the world's name.

Once a world has been created it will be placed into the list of available game worlds in the Game World tab of the Foundry main menus. The Edit World button opens the edit world dialog which allows you to change certain details about the game world such as the title, background image, next session date and time, and the world description.

You cannot change the game data path or game system once the game world has been created.

Reset User Access Keys

When this option is toggled the associated world will have all of the user access keys blanked, including any gamemaster level users. This is useful for regaining access to a game world where access keys have been forgotten or lost.

To set new access keys you will need to launch the game world and enter the user management menu. You can find more information on user configuration in the Users and Permissions article.

Safe Launching a World

It is possible to launch a world with a "Safe Configuration" to circumvent issues which might be preventing a world from loading correctly. To do this, edit the game world and enable the Launch in Safe Configuration setting, then launch the game world.

When Safe Configuration is toggled on, the next time the game world is launched the following effects will be applied to it:

Once a world has been launched with this setting enabled it will automatically be turned off. This setting is especially useful for troubleshooting worlds in which bad assets, scripts, or corrupted data is preventing a game world from loading.

Deleting Worlds

Delete Game World Action
The delete world confirmation box.

To delete a world click the Delete World button to the right of the world's name.

Clicking the Delete World button will bring up a prompt to delete the world and all of its data. The process of deleting worlds includes verification to prevent accidental deletion of a game world, and requires a user to type the title of the game world into the text field before it will allow the user to click the Yes button and complete the process.

Please note: This process cannot be undone.