NPC Narrator

NPC Narrator connects a Foundry VTT world to an NPC Narrator campaign so players can talk to AI-backed NPCs from the tabletop. Replies appear in Foundry chat as Narrator and NPC lines; optional TTS follows the GM’s existing audio recipient (for example Discord).

Compatible with Foundry v13–v14. System-agnostic — works with any game system that uses Actors, Scenes, and tokens.

What this package contains

Requires an active NPC Narrator campaign (hosted at npcnarrator.com). The module connects only to the NPC Narrator site https://www.npcnarrator.com. Pairing, chat, and live updates all go through that site — players and Foundry never talk to the game backend directly.

Functionality

Campaign pairing (GM)
Generate a one-time Foundry pairing code in NPC Narrator GM console, then bind the world under Module Settings → Campaign pairing (or /narrator bind). The world registers as a campaign device (role: foundry). Set campaign text output to that Foundry device; set audio output as desired (e.g. Discord).

Actor & scene mapping

• System-agnostic Actor sheet header button to map a party member or Narrator NPC
• Players map their own character; GMs map Narrator NPCs and locations
• Mappings are stored by actor/scene id (duplicates start unmapped)
• Sync Narrator portrait pulls the closed-mouth still onto the Actor sheet, prototype token, and placed tokens when possible

Create from Foundry (GM, create-only)

• Actor → Create Narrator NPC (prefills name / role text; writes the override and refreshes the NPC catalog)
• Scene → Create Narrator Location (prefills name / journal summary when available)

Talking to NPCs (players)
Because Foundry does not open the Token HUD for tokens a player does not own, this module adds its own right-click menu on hover: Chat (public Foundry chat) or Whisper (private to sender + GMs). Also available via /narrator chat / /narrator whisper, hotkeys (Alt+C / Alt+W), toolbar buttons, and GM Token HUD icons.

Chat commands

Quick setup

1. Enable the module in the world.
2. Module Settings → set Yaml Editor base URL (default https://www.npcnarrator.com).
3. GM: bind with a pairing code from the DM console.
4. GM: map Narrator NPCs (and optionally sync portraits).
5. Players: map their character, then Chat/Whisper an NPC token.

Links

• Website: https://www.npcnarrator.com
• Source / issues: https://github.com/discgolferusa/NPC-Narrator-Foundry-Module
• Releases / changelog: https://github.com/discgolferusa/NPC-Narrator-Foundry-Module/releases

License: Proprietary — personal use with Foundry / NPC Narrator; redistribution, resale, and modification for redistribution are not allowed (see LICENSE).