All module settings are found under Module Settings in the Foundry VTT configuration menu.
These settings apply to the entire world and can only be changed by the GM.
| Setting | Type | Default | Description |
|---|---|---|---|
| Enable Module | Boolean | On | Master toggle. When off, the entire module is disabled. |
| Dialogue Theme | Select | Default | Visual theme for the VN overlay. Options: Default, Elegant, Indigo, Detective, Fantasy, Romance, SF. |
| Prompt Distance | Number (1-5) | 1 | How many grid squares away the interaction prompt bubble appears. |
| Default Transition | Select | Fade | Screen transition when entering/exiting VN mode. Options: Fade, Wipe, Shutter, None. |
| Typewriter Speed | Number (10-100) | 30 | Characters per second during text display. Higher = faster text. |
| Skip PC Speaker Switch | Boolean | On | Prevents the Foundry chat speaker from changing when clicking a PC character on the VN stage. |
| NPC Interaction Range | Number (0-10) | 2 | Maximum distance (in grid squares) to interact with an NPC token via the F keybind. 0 = unlimited range. |
| Choice Mode | Select | Instant | How player choices resolve. Instant = first player to click. Vote = all players vote. |
| Vote Resolution | Select | GM | How votes are finalized. Majority = auto-confirm when majority agrees. GM = GM manually confirms. |
| Live Mode: Hide Dialogue Box | Boolean | Off | Hides the dialogue box during live sessions. Useful for voice-only play where only character visuals are needed. |
| Live Mode: Voice Highlight | Boolean | Off | Detects microphone activity and highlights the speaking player's character on stage. Requires players to grant mic access. |
These settings are stored per-client and each player can configure them independently.
| Setting | Type | Default | Description |
|---|---|---|---|
| Typewriter Sound | Boolean | On | Plays a tick sound during text display. |
| Disable Update Notification | Boolean | Off | When enabled, suppresses the module update notification dialog. |
These settings exist in the module but are not shown in the settings menu. They store internal data.
| Setting | Scope | Description |
|---|---|---|
| gmOverrides | World | GM-level overlay customization overrides |
| playerPermissions | World | Permission matrix controlling which overlay elements players can customize |
| playerOverrides | Client | Player-level overlay customization overrides |
| backgroundLocations | World | Array of background location data (managed via Background Config) |
| defaultBgTransition | World | Default background transition settings (managed via Background Config) |
| scenePresets | World | Array of scene preset data (managed via Scene Preset Panel) |
| dockPosition | Client | Saved position of the Character Dock window |
Two additional buttons appear in the settings panel:
| Button | Description |
|---|---|
| Open Overlay Customize | Opens the Overlay Config Editor for full visual customization |
| Discord | Opens the GlitchSmith Discord server in a new tab |