Foundry modules / Documentation
Share NPCs and manage contacts
Last checked 2026-10-08
Why you share NPCs
Other player characters always appear in a player's Contacts. NPCs do not. A player sees an NPC by name only after you share that NPC with their character. Until then a thread with that NPC shows as Anonymous, and the NPC is missing from the directory and the dialer. Sharing is the in-fiction moment of getting someone's number.
Share an NPC with a character
- Open the phone and go to Contacts.
- Press + ADD at the top right. On a GM client this opens the ADD CONTACT screen instead of a new message.
- In the first selector, "Whose phone", pick the player character who should receive the contact.
- In the second selector, "Contact to add", pick the NPC from the NPCS group.
- Press + ADD CONTACT. The NPC now shows by name for that character, who can text and call them.
You can do the same for several characters by repeating the steps. Sharing adds to what the character already has. The ADD CONTACT screen has no option to take an NPC back.
Build an NPC's address book
When you act as an NPC with the AS selector, that NPC has its own Contacts. It lists everyone the NPC has texted or called, plus anyone you add by hand. Open ADD CONTACT while acting as the NPC and the phone is already filled in, so you only pick the "Contact to add".
| Case | Result |
|---|---|
| Character as the phone, NPC as the contact | The character is introduced to the NPC |
| NPC as the phone, character or NPC as the contact | The contact is added to that NPC's address book |
| Character as the phone, character as the contact | Nothing to add. The screen explains that characters already have each other. |
| An NPC added to its own book | Refused |
Calls to NPCs
When a player calls an NPC, every connected GM's phone rings and you answer as that NPC. If no GM is online the call falls through to voicemail, and the NPC's greeting plays out as text. Calls between two NPCs never ring. See Voicemail greetings.
A brand new NPC created mid-session may not exist on a player's client until they reload the page. If an NPC is missing from a player's list, ask them to refresh.
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.