Foundry modules / Documentation
Foundry phone quickstart for GMs: set up in ten minutes
Last checked 2026-10-10
Ten minutes from install to first text
This is the shortest route to a table where every player has a working phone. You only do this once per world. Your players install nothing: they just open their character and the phone is there. Each step names the exact button or label you will see, so you can follow along with the world open.
- Install both modules. In Foundry, open Add-on Modules, then Install Module. Install the free ShawnsVTTs Library first by pasting
https://modules.shawnsvtts.com/shawnsvtts-lib/module.jsoninto Manifest URL, then install the phone from your install link. The full walkthrough is on the install page. - Enable both in your world. Launch the world, open Module Management (Manage Modules in Foundry 13) in the game settings, tick both modules, save, and let Foundry reload.
- Give each player a character. Every player needs a character actor that they own. That character is their handset. Vehicles and other actor types are ignored, and NPC actors become lines that you, the GM, answer. If you have turned on the "phone is an inventory item" setting, also give each character an item named Phone, Smartphone, Cell phone, Mobile, Handset, Burner or Commlink. See phone as item.
- Open your own phone and find Manage. As GM, your phone has a MANAGE icon in the APPS grid that players never see. Everything below happens there. The tour is on the GM Manage panel page.
- Share two NPCs. On your phone open Contacts and press + ADD. Under "whose phone" pick a player character, under "contact to add" pick an NPC, and press + ADD CONTACT. Repeat once more. Until you do, that NPC shows up as "Anonymous" in the player's threads. See NPC contacts.
- Set greetings for those two NPCs. In MANAGE find VOICEMAIL GREETINGS, type what the NPC says when nobody picks up, and press SAVE. With no greeting the caller sees a plain automated-tone placeholder. See voicemail greetings.
- Send a first notice. Still in MANAGE, find NOTICE, type "The group chat is open. Say hi.", leave everyone unticked, and press SEND NOTICE. It lands on every player's home screen until they press DISMISS.
- Optional: switch on the battery. In the GM · PHONE panel, tick Phone charging. It will not switch on until the in-game clock has been set in the Weather app. Drain defaults to 4 percent per in-game hour. See battery.
- Optional: set the signal. In the SIGNAL panel pick NORMAL, WEAK or DEAD for the active scene. See signal zones.
What to try before the players arrive
Open the phone as the GM, choose one of the NPCs you just shared from the AS selector at the top, and send a text to a player character. Have that player open Messages and confirm the NPC's name shows. Then ring the NPC from the player's phone and answer as the NPC. Two minutes of this will teach you more than any page.
Calls ring and connect, but the conversation itself happens at the table, as it always did. The phone adds the ring, the screen and the paper trail.
A good first session
Do not turn everything on at once. Share two or three NPCs, send one notice, and let the players text each other and the party GROUP CHAT. Add the battery or a dead zone in a later session, when the table is comfortable with the basics. Players adjust fast, and the phone is more fun when it is a small surprise than a rulebook.
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.