Foundry modules / Documentation
Run a mystery with the Foundry phone
Last checked 2026-10-08
Clues that live in a pocket
Mysteries run on information moving between people. A phone is a natural home for that: messages that arrive at the wrong moment, a photo with something in the corner, an email that proves someone lied. Everything below is something the phone does today. The phone never sends anything on its own, so you are the one who sends the text, which is exactly the control a mystery GM wants.
A tip from nobody
Until you share an NPC with a character, a text from that NPC shows as "Anonymous". That is your anonymous tipster for free. Hold the AS selector on the tipster NPC, text a player character, and the player sees only the number and the words:
- "Check the harbour office. Not the front desk. Ask for the night ledger."
- "Don't trust the man in the grey coat."
Later, when the players earn the tipster's trust, open the thread and press SHARE CONTACT. The name appears and the tipster joins their Contacts. That reveal costs you one button and lands with real weight.
Planted photos and files
There is no in-phone button for planting evidence. You do it with a macro, and it takes one line per clue:
game.modules.get('shawnsvtts-phone').api.sendFile(game.actors.getName('Aria'), { kind: 'photo', name: 'Dock at night', url: 'path/to/image.png', caption: 'Taken from the roof', fromLabel: 'Anonymous' })- Use
kind: 'text'with abodyfor a ledger page or a note.
The clue appears in the player's Photos or Files app, with the sender label you chose. A photo is far better than reading out a description, because players zoom in and find the detail you did not know you had put there. See photos and files and the macro reference in macros and API.
Email for the paper trail
Email has subjects, compose and reply, so it suits formal evidence: a lab report, a bank notice, a forwarded chain. Send a message as an NPC witness with a subject line like "Re: Thursday night" and let the players reply with questions. See email.
Shared notes for the case board
Notes can be private, shared with one character, or shared with the whole group. Encourage the table to keep a shared "Suspects" note. Anything one player adds is there for everyone, and one player can keep a private note of a hunch they are not ready to say aloud. See notes.
The call log as your continuity sheet
On your side of the screen the GM call log shows every call, including calls between other characters. When players split up and ring each other, you have a record of who called whom and when. Missed calls and voicemails give you hooks: "You have a voicemail from a number you do not know."
To leave one yourself, drop a voicemail from any NPC without ringing the player. Type the text, optionally attach an audio file you uploaded, and use the LEFT field to set the in-fiction time it was left. That field only changes the timestamp shown, so a "left at 3:12 a.m." message works well as a discovery. It is delivered the moment you send it, not at a scheduled time.
The phone is a friendly-table trust model, not a vault. Do not put a secret on it that a player could not be trusted to leave alone.
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.