Foundry modules / Documentation

Using Phone and Handouts together

Last checked 2026-10-12

Two modules that notice each other

ShawnsVTTs Phone and ShawnsVTTs Handouts each work alone. When both are enabled in a world, they find each other and a few things start to work that neither can do by itself. There is nothing to switch on. Install both and enable both. Both need the free ShawnsVTTs Library.

What you get with both

You have both, soHow it works
A handout can arrive on a phoneThe GM presses Send to phone on a saved handout. It shows up in a character's Files app, and OPEN HANDOUT shows it. See Send a handout to a phone.
A business card prints a working numberThe phone line on a card fills in from the number the Phone gave that actor. Change the number in the Phone and the card follows.
A player can keep a card's owner as a contactA card thrown to a player has a Save to my contacts button.
A player can throw a contact's cardA contact's page on the phone has a BUSINESS CARD button. The GM's client carries the throw out.
A macro can read numbers and share contactsThe Phone's API gives other modules and macros a number lookup and a way to share an NPC. See Macros and the phone API.

Cards and contacts are explained in Cards and contacts with the phone.

What does not change

  • A handout opened from a phone appears in the Handouts viewer window, on top of the phone. It is not drawn inside the phone's screen.
  • Without Phone, the Send to phone button does not appear and a card's phone line stays empty.
  • Without Handouts, a phone file that came from a handout shows where it came from but has no button to open it.
  • Players install nothing in either case.

Who has to be online

A card thrown from a phone, and a contact saved from a card, are carried out by the GM's client, which checks that the request is allowed. If no GM is connected, the player is told so and nothing happens. The rest, including sending a handout to a phone, is done by the GM.

Install order

  1. The free Library.
  2. Phone and Handouts, in either order.
  3. Enable all three in the world.

The install guide walks through it.

Next

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.