Skip to main content

Application Settings

DDDBrowser stores application settings that persist between sessions. This guide covers all available settings and how to configure them.

Accessing Settings​

  1. Press Esc (exit / pause menu)
  2. Choose Settings
  3. The Settings modal opens with a General view and a Keybindings view (Change Keybindings button)

Also reachable from the broader menu/UI where Settings is listed.

General view (as shipped)​

Audio Settings​

Audio Device Selection​

Choose which audio output device to use:

  • Dropdown menu: Lists all available audio devices
  • Default: System default device is selected automatically
  • Change: Select a different device from the dropdown
  • Save: Changes are saved immediately

The selected device is used for all audio playback in DDDBrowser.

Volume Controls​

DDDBrowser provides fine-grained volume control:

Master Volume​

  • Range: 0.0 to 1.0
  • Default: 0.25 (25%)
  • Purpose: Overall volume level for all audio
  • Effect: Multiplies all other volume levels

Music Volume​

  • Range: 0.0 to 1.0
  • Default: 1.0 (100%)
  • Purpose: Background music volume
  • Use case: Adjust music relative to other sounds

SFX Volume​

  • Range: 0.0 to 1.0
  • Default: 1.0 (100%)
  • Purpose: Sound effects volume
  • Use case: Adjust effect sounds (footsteps, impacts, etc.)

Voice Volume​

  • Range: 0.0 to 1.0
  • Default: 1.0 (100%)
  • Purpose: Voice/dialogue volume
  • Use case: Adjust spoken dialogue and voiceovers

UI Volume​

  • Range: 0.0 to 1.0
  • Default: 1.0 (100%)
  • Purpose: User interface sounds volume
  • Use case: Adjust menu sounds, notifications, etc.

Volume Calculation​

Final volume for any sound is calculated as:

Final Volume = Master Volume × Category Volume × Scene Volume

For example, if Master is 0.5, SFX is 0.8, and a scene sound has volume 0.6:

  • Final = 0.5 × 0.8 × 0.6 = 0.24 (24%)

Quit Confirmation​

  • Option: "Don't ask again" checkbox
  • Default: Unchecked (shows confirmation dialog)
  • Purpose: Skip quit confirmation dialog
  • When checked: Application quits immediately when you choose Quit
  • When unchecked: Shows confirmation dialog before quitting

Graphics​

  • Occlusion culling: Toggle hierarchical-Z (HZB) compute occlusion culling. This is not GL hardware occlusion queries; it is an independent GPU path from SSAO.
  • SSAO: Toggle screen-space ambient occlusion. Multiplies a contact-shadow factor into the G-buffer AO channel before lighting. Independent of occlusion culling / HZB.
  • Shadows: Toggle shadow rendering

See also Scene features — Material AO vs SSAO.

Network Policy (script HTTP)​

Controls Engine.httpRequest third-party hosts (not scene travel Allow HTTP):

  • Shows the active scene origin host when a scene is loaded
  • Allow allowlisted third-party hosts: when enabled, listed hosts may be contacted via script GET
  • Host list: add/remove hosts (e.g. api.example.com)

Scene origin remains allowed for script HTTP when a scene is active. Travel/load http:// uses a separate Allow HTTP prompt and does not change this policy.

Script origins (executable Luau)​

Controls which hosts may supply .luau scripts beyond the scene URL host:

  • Scripts from the same host as the scene URL are always allowed
  • Other hosts require an entry under Script origins
  • Stored as scriptOriginsAllowlist in settings.json

See Engine API — Script origin trust.

Settings Storage​

Settings are stored in:

Location: %LOCALAPPDATA%\DDDBrowser\settings.json

Format: JSON (fields evolve with the app). Typical keys include audioDevice, audioVolumes, quitDontAsk, graphics, scriptNetworkPolicy, and scriptOriginsAllowlist.

Persistence: Save applies when you click Save in the Settings modal (or as otherwise noted for individual controls).

Backup: You can backup your settings by copying the JSON file.

Resetting Settings​

To reset settings to defaults:

  1. Close DDDBrowser
  2. Delete or rename settings.json
  3. Restart DDDBrowser
  4. Default settings will be created automatically

Troubleshooting​

Audio Not Working​

  • Check that an audio device is selected
  • Verify the device is not muted in system settings
  • Try selecting a different audio device
  • Check Master Volume is not set to 0

Settings Not Saving​

  • Verify write permissions in %LOCALAPPDATA%\DDDBrowser\
  • Check disk space
  • Look for error messages in the application log

Volume Too Low/High​

  • Adjust Master Volume first (affects everything)
  • Then adjust category volumes (Music, SFX, etc.)
  • Remember: Final volume = Master × Category × Scene

Next Steps​