PocketScroll brings Foundry VTT to your pocket. The PocketScroll Foundry Companion module is a lightweight, zero-dependency module that runs inside your Foundry VTT server and acts as a real-time communication bridge between the Foundry VTT game world and the PocketScroll mobile app (available on iOS and Android).
Once installed and activated, the module listens for requests from connected mobile devices and executes privileged operations on their behalf — rolling dice, updating character sheets, managing combat, moving tokens, and more. It also monitors Foundry's hook system and pushes live updates to all connected devices whenever game state changes, so every player's phone stays perfectly in sync with the table.
No separate backend or server infrastructure is required. The module communicates directly through Foundry VTT's built-in Socket.IO server using the module.pocketscroll-socket channel.
Get the mobile app: IOS / Android
How It Works
- GM installs the module in Foundry VTT via the manifest URL (takes under a minute)
- GM activates the module in their world's module settings
- Players download the PocketScroll app on iOS or Android
- GM shares an invite link — players tap it to connect for free
- Play — character sheets, dice rolls, combat, and maps all work in real time from mobile devices
The module requires the GM to be logged into Foundry VTT for the bridge to be active. All privileged operations (actor updates, combat management, token movement) are executed through the GM's session with full Foundry permission enforcement.
Features
For Players
- Full Character Sheet — View abilities, skills, modifiers, saving throws, proficiencies, hit points, AC, movement speeds, senses, and active conditions from your phone
- Actions & Spellcasting — Cast spells, use abilities, and roll attacks directly from the app. Supports spell preparation management for prepared casters. Items are organized by type: weapons, spells (by level), features (by activation type), and consumables
- Dice Rolling — Roll ability checks, saving throws, skill checks, attack rolls, and damage rolls with full advantage/disadvantage support. Hit dice rolling for short rests
- Inventory Management — Browse, equip, and use items. Track consumable charges, equipment slots, and loot
- Combat Tracker — Follow initiative order, see whose turn it is, track round count, view combatant HP/AC, and target enemies
- Interactive Map — View the battle map with your token's position, move your token with touch controls, and see line-of-sight visibility (fog of war rendered on mobile)
- Chat — Send and receive chat messages, view roll results, and see whispers directed to you
- Journals — Browse and read journal entries you have permission to view, with enriched HTML content
- Short & Long Rests — Execute rests with proper D&D 5e resource recovery (spell slots, hit dice, HP)
For Game Masters
- Party Dashboard — Monitor all player characters' HP, AC, class, and resources at a glance in a carousel or grid layout
- Creature Cards — Quick reference for scene NPCs, deduplicated by name with count indicators (e.g., "3x Goblin")
- Full Combat Controls — Start encounters, advance/revert turns and rounds, roll initiative (individual or all-at-once), set initiative manually, toggle defeated status, add/remove combatants, and end encounters
- GM Map — Full scene view with no fog-of-war restrictions. Control token visibility (hide/show from players), move tokens, and manage combatant status
- Token Visibility — Toggle token visibility for players directly from the mobile app
- Damage Application — Apply damage or healing to any targeted token
- Journal Sharing — Show journal entries to all players from your device
Real-Time Synchronization
The module hooks into Foundry VTT's event system and broadcasts live updates to all connected mobile devices. Changes made in Foundry on the desktop are reflected instantly on mobile, and vice versa:
- Actor updates — HP changes, item modifications, spell slot usage, condition changes
- Combat events — Initiative changes, turn/round advancement, combatant additions/removals, defeat toggles
- Scene & token events — Token movement, visibility changes, scene switches
- Chat messages — New messages, roll results, whispers (respecting privacy)
- Journal updates — New entries, page edits, "Show to Players" events
Installation
- In Foundry VTT, go to Add-on Modules → Install Module
- Paste the manifest URL into the Manifest URL field:
https://flavio-s-amorim.github.io/pocketscroll_foundry_module/module.json
- Click Install
- Enable PocketScroll Foundry Companion in your world's module settings
- Download the PocketScroll app on iOS or Android
- Connect to your Foundry server from the app