Bevy Scene Notation (BSN)

VS Code language support for .bsn (Bevy Scene Notation) files: syntax highlighting, formatting, and validation.

Temporary, unofficial. Not affiliated with or endorsed by the Bevy or Jackdaw projects.

Features

• Syntax highlighting for .bsn files (bracket matching, comments, auto-closing pairs)
• Format on save / format document, powered by the bundled bsn-fmt Rust CLI
• Inline diagnostics — parse errors from bsn-fmt check are shown as squiggles when a .bsn file is opened or saved

Requirements

The formatting and validation features shell out to the bsn-fmt CLI.

• Windows (x64) and Linux (x64): nothing to do — a prebuilt bsn-fmt binary is bundled with the extension.

• macOS or other platforms: no prebuilt binary is bundled yet. Build it yourself:

  cd bsn-fmt
  cargo build --release
  

  Then either put the resulting binary on your PATH, or set the bsn.cliPath setting to its full path.

Syntax highlighting alone works with no extra setup.

Extension Settings

Usage

1. Open a .bsn file — syntax highlighting applies automatically.
2. Run Format Document (Shift+Alt+F) to reformat via bsn-fmt.
3. Parse errors surface automatically as diagnostics on open/save.

Try it from source

Open this repo folder in VS Code, press F5 to launch an Extension Development Host, then open example.bsn.

Acknowledgements

Syntax grammar and the example file are based on jbuehler23/jackdaw's jackdaw_bsn, used under the MIT License. See THIRD-PARTY_NOTICES.txt.

License

MIT © 2026 Liam Karl Mitchell