Skip to content

A VS Code BlitzMax language extension, with a custom debug adapter and integrated LSP support

License

Notifications You must be signed in to change notification settings

Hezkore/vscode-blitzmax-support

Repository files navigation

BlitzMax for Visual Studio Code

Version Installs Rating Discord Chat

Welcome to the BlitzMax extension for Visual Studio Code!
If you are new to BlitzMax or VS Code, make sure you read how to get started.

This extension provides the following features inside VS Code for BlitzMax source files:

You can discuss this extension on Discord: Discord Chat
We hang out in the #vscode-extension channel!

Get started writing BlitzMax code in VS Code


Changelog


See CHANGELOG.

Note about using the Language Server Protocol


A "LSP" server is an external application that monitors your project and source code.
It can provide linting and very accurate auto-complete suggestions, among many other things.

You will have to provide (or write) your own LSP server.
A work in progress LSP server can be found here.

Useful LSP links for server developers:
VS Code specific information
Official LSP specifications

Note about using formatting


Formatting is currently handled externally.
You will have to install a BlitzMax specific formatter.
(Unless your LSP server handles it)

The extension will guide you through this process on the first format.

FAQ


  • Q. What languages are supported?

    • A. Only BlitzMax NG is officially supported.
      You can enable the 'Legacy Mode' build option for basic BlitzMax Vanilla/Legacy build support.
      (I highly recommend you upgrade to BlitzMax NG)
  • Q. Why is the outlines view and breadcrumbs not working?

    • A. These features are provided by the LSP server.
      Make sure your current LSP supports these features.
  • Q. I've found an issue / I'd like to make a feature request, what do I do?

  • Q. How do I <do this or that> in VS Code?
    (aka. I need more help)

Credits


BlitzMax by Mark Sibly.
BlitzMax NG by Brucey.
Extension by Hezkore.
Icons by GWRon.

Contributing


Contributions are greatly appreciated.
Fork this repository and open your pull requests.

License


Licensed under the MIT License.

About

A VS Code BlitzMax language extension, with a custom debug adapter and integrated LSP support

Topics

Resources

License

Stars

Watchers

Forks