NimbyScript for Visual Studio Code

Language support for NimbyScript, the modding language for NIMBY Rails.

Features

Syntax Highlighting

Full syntax highlighting for NimbyScript files with semantic token support for context-aware coloring.

Intelligent Completions

Context-aware autocompletion for:

Language keywords (fn, struct, let, if, for, etc.)
Primitive types (i32, f64, bool, etc.)
Game API types, methods, and fields
Your defined structs, enums, and functions
Callback function templates

Real-time Diagnostics

Catch errors as you type:

Syntax errors with error recovery
Type mismatches
Undefined variables and functions
Invalid callback signatures
Meta field validation

Hover Information

Hover over symbols to see:

Type information
Documentation from API definitions
Function and method signatures
Field types and readonly status

Signature Help

Get parameter hints while typing function and method calls.

Go to Definition

Navigate to symbol definitions with F12 or Ctrl+Click:

Jump to struct, enum, and function definitions
Go to type definitions
Find implementations

Find References

Find all references to a symbol (Shift+F12):

See where structs, functions, and variables are used
Navigate between usages

Document Outline

Navigate your code with the outline view showing all:

Structs and their fields
Enums and variants
Functions and methods

Inlay Hints

See parameter names and type annotations inline in your code.

Type Hierarchy

Explore type relationships with the type hierarchy view.

Rename Symbol

Rename any symbol with F2. All references are automatically updated.

Code Folding

Collapse and expand code blocks to focus on what matters. Works on structs, enums, functions, and nested blocks.

Smart Selection

Expand your selection progressively with Shift+Alt+Right. Contract with Shift+Alt+Left. Selection expands through syntax nodes (identifier → expression → statement → block → function).

Linked Editing

When you rename a struct, its method prefixes (Foo::method) and self parameter types (&Foo) update together. Enable with the editor.linkedEditing setting.

Workspace Symbols

Search for any symbol across all open files with Ctrl+T (Cmd+T on macOS).

Requirements

No additional requirements. The extension bundles the language server for your platform.

Extension Settings

Setting	Description	Default
`nimbyscript.server.path`	Path to custom language server binary	(bundled)
`nimbyscript.api.definitionsPath`	Path to custom API definitions file
`nimbyscript.trace.server`	Enable language server tracing for debugging	`off`
`nimbyscript.inlayHints.enabled`	Enable inlay hints for type annotations and parameter names	`true`
`nimbyscript.semanticTokens.enabled`	Enable semantic token highlighting	`true`

Supported Platforms

macOS (Apple Silicon and Intel)
Windows (x64 and ARM64)
Linux (x64 and ARM64)

Release Notes

See GitHub Releases for version history.

Contributing

Found a bug or have a feature request? Please open an issue on GitHub.

License

MIT

NimbyScript

Alex Sørlie