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 Volume | Number (0-1) | 0.5 | Controls the tick sound volume for this client. Set to 0 to disable typewriter ticks locally. |
| 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 |
These settings are available in current releases and may not appear in older screenshots of the wiki.
| Setting | Scope | Type / Default | What it changes |
|---|---|---|---|
| Typewriter Sound File | World | Audio path / modules/visual-novel-maker/assets/sounds/typewriter-key.wav |
Sets the default tick sound used by dialogue and narration typewriter playback. |
| Typewriter Sound Interval | World | Number / 60ms | Sets the minimum delay between tick sounds. Lower values tick more often. Range: 20-200ms. |
| Default to Framed Mode | World | Boolean / Off | Starts live sessions in framed character mode automatically. |
| Lock Background | World | Boolean / Off | Prevents camera zoom, pan, and shake from moving the background image. |
| Typewriter Sound Volume | Client | Number / 0.5 | Controls tick volume for this client. Set it to 0 to disable typewriter ticks locally. |
The current Typewriter Sound setting is a volume slider, not a simple on/off checkbox. If the tick sound continues after closing the overlay in an older install, update to v1.1.2 or later.
These are still managed by module UI instead of the Foundry settings screen.