Talkative Townsfolk

"AI" disclosure

Some or all of the code in this repository was generated with the assistance of LLM-based tools.

AI-generated code is not automatically owned by the person who generated it. No claim of ownership is made over third-party code or material included in this repository.

If you believe any code in this repository infringes your copyright, please contact me with the relevant details and I will review the matter and remove the material if appropriate.

This repository is intended for personal use only. The code is provided "as is", without warranties of any kind. I accept no responsibility or liability for any damage, data loss, security issues or other consequences resulting from its use.

Use this code at your own risk. You have been warned.

About

A Foundry VTT module for preparing NPC dialogs per scene and playing them from a Dialogs tab on the Dragonbane actor sheet.

It gives the GM:

• Dialog trees of player questions/statements and NPC answers, with follow-ups
• Categories to group dialogs, collapsed automatically once all their questions are used
• Used markers on questions (right-click to toggle, reset from the menu)
• Links between answers and other questions (drag a question into an answer)
• Search across questions, answers and link texts
• A per-scene view, or all scenes at once

Compatibility

• Foundry VTT 14
• Dragonbane/Drakar och Demoner 4.x
• GM only: players never see the Dialogs tab

Installation

In Foundry VTT, go to Add-on Modules → Install module and enter the manifest url: https://code.chuggybumba.com/thanius/talkative-townsfolk/raw/branch/main/module.json

Configuration

1. Open an NPC or monster sheet and go to the Dialogs tab.
2. Open the menu (top right) and click the cog to open the dialog configuration.
3. In the configuration window:
   • Dialog adds a dialog to the current scene, or a follow-up to the selected dialog
   • Category adds a category to group dialogs under
   • Scenes starts a dialog in another scene (or drag a scene from the sidebar onto the tree)
   • Drag nodes in the tree to reorder them or make them follow-ups
   • Tick All scenes to see the dialogs of every scene
4. A new dialog that is still blank when the window closes is discarded.

Storage

Dialogs are stored as journal entries, found by flags rather than names:

Talkative Townsfolk / <character> (uid: <actorId>) / Scenes / <scene> (uid: <sceneId>) /
  <category>     one journal per category
  <character>    dialogs outside any category

Renaming the folders or journals is safe.