Foundry Virtual Tabletop is a powerful application with a lot of features, so it can be overwhelming to a new game-master, even if you have previous experience using virtual tabletop software. This article provides a basic introduction to the layout of Foundry VTT and gives you all of the beginning steps required for setting up a game for your players. This article will introduce you to:

The Main Menu

Foundry VTT Configuration & Setup
The Configuration and Setup menu of Foundry Virtual Tabletop.

The main menu of Foundry VTT allows for managing of worlds, game systems, modules, and various configuration settings of the software itself.

Game Worlds

This panel is the default displayed when Foundry first loads, it contains all of the game worlds you have created to run games in. When Foundry is first launched this list will be empty (as pictured to the right) but will quickly become populated with campaigns for you and your players to adventure in.

Game Systems

This panel lists all of the game systems that are currently installed, and allows you to update them to their most current versions if required. Game systems are vital for the creation of game worlds and running game sessions.

Add-on Modules

This panel lists all of the modules that are currently installed and available to be used in a game world. This panel also allows you to update modules to their most current version if required. Modules do nothing on their own and must be loaded from within a live game. This tutorial series will not go over modules as they are not required to use Foundry's various tool sets.


This panel lists various configuration settings that you can use to fine-tune the behavior of Foundry.

When you first launch Foundry Virtual Tabletop, it's recommended that you navigate to the Configuration tab and set an Administrator Password. This password is encrypted and allows you to secure Foundry VTT to prevent access to the main setup menu. It's also required to use the Return to Setup feature from the login page of any currently hosted world.

Update Software

This panel allows you to see the current version of Foundry and if a newer version is available. You can update your version of foundry from this menu, and even switch to various test branches, provided that one is currently available.

Installing a Game System

The Game System Browser
Game Systems can be easily installed using the Module Browser.

Before you can create your first world you will first need to install a Game System. Game Systems set the rules by which your world operates, whether this is one of the more common rulesets from a major publisher, or if you prefer to use something like the Simple Worldbuilding System. Each world has a Game System tied to it. Without one installed, it is impossible to create a world.

Foundry VTT provides a package installation system available from the Setup screen for the installation of Game Worlds, Game Systems, and Add-on Modules. The "Install System" button at the bottom of each of these tabs on the Setup screen will allow you to install the package type for that tab.

The Game System Installation Menu

  1. From the Setup screen navigate to the Game Systems tab
  2. Click the "Install System" button at the bottom of the menu
  3. A package installation browser will appear allowing you to see all of the Game Systems currently available for Foundry VTT
  4. You can search this listing with the search field, or filter the listing using package categories
  5. Once you have chosen a Game System, click the install button to the right of the system's name, and FVTT will download and install it for you

Game Systems which have not yet been officially released can also be installed manually if you have a link to the system.json file (called the manifest url) for that system, by pasting the URL into the Manifest URL field and clicking the install button.

Updating Game Systems

As a reminder, it is wise to periodically update installed systems from the Game System tab of the main Foundry VTT menus. You can update game systems individually by clicking the associated "check update" button in the system's entry, or use the "update all" button at the bottom of the tab to check all of your installed systems for updates, which will then be automatically applied if one is available.

About Modules

It is a common pitfall for some users to rush immediately to install Add-on Modules without first learning to use the basic features of Foundry VTT. While modules provide a large variety of customization and changes to the way core Foundry VTT features work, they can carry with them some compatibility issues and should be installed in small increments to allow you to be certain which features were added by community-supported modules and which features are part of the core software.

Always remember, the first step in troubleshooting any issue you may experience in Foundry VTT is to disable all modules.

Creating A New World

The World Configuration Sheet
The World configuration sheet allows you to specify the details of your Game World and edit them later.

Now that you have a Game System, navigate to the Game Worlds tab, from here you will create your very first Game World! Clicking the "Create World" button on this tab presents a dialog menu.

Editing an Existing World

The Edit Game World button can be used at any time after a world has been created, allowing you to display this menu again in order to change details about your game world such as the description, next session, background image, or title! It can also be used to reset active modules or reset user access keyswithout having to launch the world first. If you are having trouble launching your world or logging in, simply edit the world and check the appropriate box to reset modules or user access keys as necessary.

The Create World Menu

World Title
The title that players will see when logging in to the game, and how the world will be referred to in the user interface.
Data Path
The folder name within the Worlds folder where your data will be stored. As this will be used in web URLs, it cannot contain spaces or special characters, use hyphens to separate multiple terms instead. (Example: my-first-campaign is better than "my first campaign".)
Game System
The ruleset the world will use. A game system cannot be changed once the world is created, so be sure you are using the correct system.
Background Image
An image that you and your players will see when logging in to the Game World for a session. This image will be stretched to fit the browser window, so it is recommended that you use an image that is at least large enough to function as a desktop wallpaper.
Next Session
Allows you to set the date and time for the next game session, and will be visible to any players from the login screen for your Game World. This is purely optional. The date and time is automatically localized to the user's correct timezone.
World Description
Provides a text description for your world, allowing for some additional thematic information or a brief description for your setting, current plot points, or other information your players will see when logging in.

Once you have filled out these fields to your liking, click Create World to finalize your Game World!

Installing a Game World

Foundry VTT offers a number of adventures and campaigns which come already prepared with everything you need to run them with your players. Similar to the installation of Game Systems, these worlds can be installed from the Game Worlds tab and will automatically install all content, including the Game System for you.

The Game World Installation Menu

  1. From theSetupscreen navigate to the Game Systems tab
  2. Click the "Install World" button at the bottom of the menu
  3. A package installation browser will appear allowing you to see all of the Game Worlds currently available for Foundry VTT
  4. You can search this listing with the search field, or filter the listing using package categories
  5. Once you have chosen a Game World, click the install button to the right of the World's Title, and FVTT will download and install it for you

As with Game Systems, Game Worlds which have not yet been officially released can also be installed manually using the world.json Manifest URL field.

Launching Your New World

Once your Game World has been created, simply clicking the "Launch World" button to the right of the world's Title will launch it the world and take you to the game's login screen. From here you can select the username to log in as (by default there is initially only a single, passwordless gamemaster account) or return to the setup menu.

Select the gamemaster player, and log in.

Once you have joined the game session, you'll see the core user interface which you and your players will use to plan and play games in FVTT. The image below details the major elements.

This UI map describes the primary interface elements you will first encounter in a newly created world.
The canvas, not labeled in the picture to the right, is the underlying layer where the scene and all objects are shown.
Game Pause Indicator
When the game is paused, players may not move their tokens or activate doors. You can toggle the paused state of the game by pressing the space as GM at any time.
Layer Controls
Used to switch layers on your Scenes to control the various placeable canvas objects, including: Tokens, Measured Templates, Tiles, Drawings, Walls, Lights, Sounds, and Map Notes.
Layer Tools
The specific tools related to the layer you are currently using.
Scene Navigation Bar
Used to switch between currently available scenes. Activatating a scene will display it for all users, simply clicking on a scene will display it only for you.
Sidebar Tabs
Used to access data for the various entities stored in your world.
Players List
Displays the current user accounts, when collapsed, only shows the users who are currently signed in.
Macro Directory
Provides access to all macros that have been created which you have permission to view, use, or edit.
Macro Hotbar
Gives instant keypress access to 10 quick Macros, which can be used to send chat messages or perform scripted API actions. Primarily used by advanced users. Some systems provide the ability to drop items or actors onto the macro bar to generate a macro for quick use. The Hotbar Pages control can be used to switch between up to four different pages of macro layouts.
Default Roll Mode
used to set the current mode to be used for rolling dice. For more information see Rolling Dice.
Export Chat Log
used to save a copy of all messages which presently appear in your chat log to a plain text file.
Clear Chat Log
deletes all messages from the chat log.
Chat Entry
used to chat, communicate, and enter chat commands.

Conclusion of Part 1

This concludes part one of the Getting Started Tutorial!