Foundry modules / Documentation
Foundry VTT Phone: frequently asked questions
Last checked 2026-10-08
Which versions of Foundry VTT does the phone support?
Foundry 13 and 14. It has been tested on 13.351 and 14.368. See Compatibility for the current table.
Does it work with my game system?
Yes, with any game system. The phone does not read rules data. It runs on the characters and NPCs you already have, and the wallet only works if the Library has a currency preset for your system. See Wallet.
Do my players need to install anything?
No. Only the GM installs the phone and the free Library. Players need a character they own, and, if you turn on the item setting, a phone item on that character. See Install.
What else does the phone need?
The free ShawnsVTTs Library module, enabled in the same world. If it is missing, the phone shows an error message when the world loads and does not start.
Can I use it in a world that already has actors?
Yes. Characters (and the player-character types some systems use) each get a handset, and NPC actors become lines the GM answers and texts as from the GM phone. Vehicles and other actor types are ignored. Nothing about your existing actors is changed beyond the phone's own saved data. See Getting started.
Does the GM have to be online?
For some things, yes. Calling an NPC rings the connected GMs, and if no GM is online the call goes to voicemail. The wallet needs a GM client to apply a payment, and a player's battery charge is applied by an online GM client. See Calls and the dialer.
Does it work with a phone as an inventory item?
Yes, as an option that is off by default. When on, a character's phone only works while they carry an item named Phone, Smartphone, Cell phone, Mobile, Handset, Burner or Commlink, or an item flagged as a phone. See Phone as an inventory item.
Is there voice chat?
No. Calls ring and connect, and the conversation happens at the table, the way a phone call does in any roleplaying game. Nothing is recorded in the phone. The only audio the phone plays besides short tones is an audio file the GM uploads.
Are messages private?
Between players, the phone hides what is not meant for you, but it runs on a friendly-table trust model. Foundry sends every client the data of every actor, so a determined player with browser tools could read it. Do not store secrets in the phone that a player must never find.
Where is the data stored?
In your world. A player's own messages, notes and settings are saved on their character. Anything the GM controls, such as jammed handsets, the clock, shared contacts and the era, is a world setting only a GM can write. Files the GM uploads from the phone go into a folder named shawnsvtts-phone-uploads in your Foundry Data folder.
How does it perform with many actors?
Phone logs grow with play, and Foundry sends actor data to every client. To keep that in check, the GM's client removes superseded read marks and similar entries automatically shortly after loading, and the GM can run the same cleanup with the compact function from Macros and the phone API. Real conversations and files are never removed by it.
How do I back up my phone data?
Back up your world as you normally do, since messages, notes and settings live in it. Also keep the shawnsvtts-phone-uploads folder in your Data folder, because uploaded pictures and audio files are stored there and are not part of the world file.
What happens when Foundry updates?
The module declares support for Foundry 13 and 14. Updates to the phone arrive through Foundry's normal module update check. If a new Foundry release causes trouble, check Compatibility and Troubleshooting.
What happens if I cancel my membership?
The copy you installed keeps working. You stop getting updates, and your install link stops working after a short grace period. See Membership and updates.
Can players send each other texts without the GM?
Players text each other directly and see each other in their contacts. Only NPCs need the GM: the GM shares an NPC so it shows by name, and answers or texts as that NPC. See Messages and NPC contacts.
Can I make the phone a 1990s brick phone?
Yes. The GM can set the era to a 1990s brick phone, which keeps texts (160 characters, multi-tap input), contacts and calls, and adds Snake. See Era and the brick phone.
Does the battery drain on its own?
No. The battery is off by default. When on, it drains per in-game hour (4 percent by default) and only when the GM advances the world clock. See Battery.
Do players need Foundry's upload permission?
No. Players never upload files through the phone. The GM attaches images and audio, and players send photos from their own gallery. You do not need to grant any upload permission. See Where the phone keeps your data.
Where does the phone keep my table's messages and photos?
In your own Foundry world and data folder. Texts and notes are stored in the characters' data, GM settings are world settings, and images the GM adds are files in your Foundry data folder. Nothing is sent to ShawnsVTTs. See Where the phone keeps your data.
Can players read each other's private messages?
Not through the phone, which only shows a player their own conversations. But Foundry sends every character's data to every player's browser, so a player who knows how to use their browser's developer tools could read more than the phone shows them. Treat it as a friendly-table arrangement, not a safe. See Where the phone keeps your data.
Where do I get help if something does not work?
Start with Troubleshooting, which covers the common causes, and Install to confirm both modules are enabled in the world.
Related
Foundry Virtual Tabletop belongs to Foundry Gaming LLC. ShawnsVTTs modules are independent add-ons and are not made, endorsed or supported by Foundry Gaming LLC.