AmiBlitz 3 & BlitzBasic 2 for VS Code

VS Code language support for classic Commodore Amiga AmiBlitz 3 and BlitzBasic 2 projects. It brings a modern editing experience to retro BASIC development: syntax and semantic highlighting, completion, parameter hints, documentation on hover, diagnostics, and navigation across Include/XInclude source files.

Get AmiBlitz 3

Download AmiBlitz 3 from the official AmiBlitz3 GitHub repository, maintained by honitos.

Credits

VS Code extension created by Menno Homan (Windigo).

Included

• Syntax highlighting for .ab3, .ab2, .bb2, and .bb source files, including semantic colours for recognized project variables, functions, statements, NEWTYPEs, and fields.
• Completion for built-in commands, language instructions, and project symbols.
• Completion, navigation, and transitive symbol discovery for INCLUDE and XINCLUDE files.
• NewType field completion after variable\\field when the variable type can be inferred.
• Go to definition for project symbols.
• Optional diagnostics for variables introduced through an assignment without DEFTYPE (Dim is reserved for arrays).
• Automatic canonical capitalization, based on the bundled AmiBlitz / BlitzBasic command index. For example, dim player becomes Dim player, shared player becomes SHARED player, and and becomes AND.

SHARED player1 and SHARED player1.type are both recognized as shared variables for completion.

Flow-control commands follow their normal mixed-case spelling: If, For, Repeat, Gosub, and Return. Word operators always use capitals: AND, OR, NOT, MOD, BITSET, LSL, and related operators.

Document your own code

Add documentation comments immediately above a Function, Statement, Macro, NEWTYPE, DEFTYPE, Dim, or SHARED declaration. The plugin shows them in hover help, parameter hints, and the Open documentation page.

; @doc Draw the landscape and refresh both display buffers.
; @param force -1 to redraw even when the background is unchanged.
Statement RENDER_TILES{force.w}

Use @return to document the returned value of a function.

Settings

amiblitz.implicitVariables defaults to auto, which follows the current Syntax 0, Syntax 1, or Syntax 2 directive. You can override it with off, warn, or error.

amiblitz.autoCapitalization is enabled by default. Disable it if you prefer to keep the capitalization you type.

INCDIR "includes/", INCLUDE, and XINCLUDE are followed. The include directory is resolved relative to the source file and is inherited by nested includes. amiblitz.includePaths is an additional list of local folders searched after the source file's own folder. Nested includes are followed and cycles are safely ignored.

Development

Run npm install, then npm run compile. Press F5 in VS Code to launch an Extension Development Host.