Foundry Virtual Tabletop supports various ways to convey player dialogue and actions, both in and out of character, through messages in the chat log. This page provides an overview on these chat messages and their functionality.

The Chat Log

All chat messages can be accessed through the Chat Log sidebar in-game. At the bottom of this sidebar, users can use the text field to enter messages that are viewable by others. Pressing Enter will send a written message, while pressing Shift + Enter will add a new line to the message. Pressing Up arrow will bring up the last message or command entered.

Saving

Gamemasters can save the chat log to a file through the Export Chat Log button above the text field (marked with a floppy disk icon). This exports all available chat messages into a .txt file.

Deleting

Gamemasters can clear the chat log through the "Clear Chat Log" button above the text field (marked with a trash can icon). This deletes all messages in the chat log. A gamemaster can similarly delete individual messages, with the trash can found on the top right corner of each message.

Roll Modes

The roll modes dropdown configures the type of dice roll that will be dispatched by automated rolls created by game systems, modules, or macros. Note that the selected roll mode provides guidance for automated rolls, but using the /roll command always results in a public roll. See dice rolling details for more information.


Chat Commands

While entering a message, users are able to prefix their message with a command. Some commands related to sending chat messages are listed below:

In Character

Syntax: /ic {message}

Causes the message to be spoken by an associated character. With a character's token selected (or with a speaker identified through the Player Configuration window), players will automatically speak in character, removing the need to enter this command for every message.

Out of Character

Syntax: /ooc {message}

Causes the message to be spoken out of character (OOC). OOC messages will be outlined by the player's color to make them more easily recognizable. A player without an identified speaker or a selected token will automatically speak out of character.

Emotes

Syntax: /emote {message}

Causes the message to be an emote performed by the selected character. Emotes are in-character actions conveyed through text by the player, and therefore require the player to select a token (or link a character through the Player Configuration window). Entering "/emote waves his hand." while controlling a character named Simon will send the message, "Simon waves his hand."

Whispered Messages

Syntax: /whisper {target} {message} or /w {target} {message}

Whispers a message to the target. If the user sending the message does not have the "Private Messages" permission, Gamemasters will be able to see the content of the message even if they were not a recipient. If the whisper's target is a character, the whisper will be sent to whoever controls the token. In addition to using the /w whisper syntax you can also send whispered messages using @{name} {message} if that is more convenient to you.

Note that you can message multiple users at once by enclosing their names as a comma separated list within brackets. For example /w [Andrew, Tim, Julia] what do you think? or @[James, Alicia] should we attack, or sneak past?. Lastly, the names gm and players will send a whispered message to all Game Master users or all non-GM users respectively.

Dice Rolls

Syntax: /roll, /gmroll, /blindroll, /selfroll

Rolls dice as a chat message. In the chat log, rolls can be clicked to expand their tooltip, showing the value of each individual roll. It can be clicked again to collapse the display. Refer to the Rolling Dice article for further details on how to roll dice in Foundry VTT. Once a roll is placed, you can expand the rolls to see detailed results by clicking on the rolled total.


Chat Bubbles

When an in-character or emote chat message is sent from the perspective of a placed Token, it will display a chat bubble above that Token's head illustrating the dialog visually on the game canvas.

An example chat bubble displayed for an in-character message. The camera pans to focus on the speaker.

While chat bubbles can be a great immersion aid for many parties, they may not be a desirable feature for all game masters. There are two settings which can configure the behavior of chat bubbles:


Chat Message API

For module and system developers who want to develop using messages and the chat log, there is a Javascript API available to create, use, or modify chat messages or the chat log as a whole. See the Chat Message and Chat Log API documentation for details.