Settings

(How to change settings in VScode)

All settings are under the bgforge namespace.

General

Setting	Default	Description
bgforge.validate	saveAndType	When validation runs: manual = only when invoked explicitly, save = on save, type = while editing, saveAndType = on both save and edit. type/saveAndType are disk-intensive and debounced at 300ms.
bgforge.diagnostics	true	Report tree-sitter parse errors as diagnostics, alongside compiler diagnostics, for languages with a parser (Fallout SSL/MSG, WeiDU BAF/D/TP2/TRA). In-memory and instant, so it runs independently of bgforge.validate; set to false to silence the syntax source without disabling compiler validation.
bgforge.binaryEditor.autoDumpJson	false	Whether saving a file in the binary editor should also write a JSON snapshot next to it.
bgforge.debug	false	Enable debug logging in the Output panel (BGforge MLS channel)

Fallout SSL

Setting	Default	Description
bgforge.falloutSSL.compilePath	""	Path to sslc compiler. Drop exe into system PATH and enter filename, or use full path. Empty = use built-in.
bgforge.falloutSSL.compileOptions	-q -p -l -O2 -d -s -n	Compiler flags
bgforge.falloutSSL.outputDirectory	""	Output directory for compiled scripts (default: next to source)
bgforge.falloutSSL.headersDirectory	""	Additional headers directory (workspace is always scanned)
bgforge.falloutSSL.compileOnValidate	true	When enabled, validation on save/edit also writes the compiled .int. Disable to validate without overwriting output.

WeiDU

Setting	Default	Description
bgforge.weidu.path	weidu	Path to WeiDU binary (or add to system PATH)
bgforge.weidu.gamePath	""	Absolute path to IE game directory (needed for BAF/D diagnostics)

How to Pass Settings

Depends on the editor. See the editor-specific pages for examples:

• Sublime Text - settings in LSP client config
• Neovim - settings table in vim.lsp.config
• Emacs - eglot-workspace-configuration or lsp-mode
• JetBrains - LSP4IJ Configuration tab
• Helix - config table in languages.toml
• Zed - settings in lsp config
• Geany - initialization_options in LSP Client config
• Kate - settings in LSP client config (Kate 25.08+)
• Notepad++ - settings in NppLspClient config