Skip to main content
Same build, three ways to get it. Pick whichever your editor installs from.

GitHub Releases

Available now. Download the .vsix and install it in any editor.

Open VSX

For Cursor, VSCodium, Gitpod and Theia.

VS Code Marketplace

For VS Code.
Registry publishing is wired into the release pipeline but the listings may not be live yet. If a link above 404s, that registry has not been published to — use the .vsix from GitHub Releases in the meantime; it is the same artefact.

​
Quick install

​
From a release

1

Download the VSIX

Grab glua-gmod-<version>.vsix from the latest release.
2

Install it

Run this from the folder you saved the file in.
Or from inside the editor: Extensions → the ··· menu → Install from VSIX…
3

Open a GLua file

The extension activates when you open a .lua file in a Garry’s Mod workspace.
Cursor, VS Code and VSCodium keep separate extension directories. Install into each editor you use.

​
Updating

A .vsix install does not auto-update. Download the newer file and run the same install command — it replaces the previous version in place. To hear about new versions, watch the repository: Watch → Custom → Releases.

​
Unreleased builds

Every push to main builds and attaches a .vsix to its CI run, so you can pick up a fix before it is tagged. Open the latest CI run, scroll to Artifacts, and download glua-lsp-vsix-<sha>. And follow the instructions at Quick Install.
GitHub wraps workflow artifacts in a .zip. Unzip it to get the .vsix inside.

​
From source

1

Clone and install dependencies

Clone the repository and install packages with pnpm.
2

Build and package

Compile the extension and produce a .vsix.
That writes packages/glua-lsp/glua-gmod-<version>.vsix.
3

Run or install

Press F5 to launch the extension in a new Extension Development Host window, or install the package you just built.

​
Verify the installation

Open a .lua file inside a Garry’s Mod addon folder. The status bar shows a realm — GLua · Server, GLua · Client or GLua · Shared — once the language server has attached and started indexing.
Plain Lua in the status bar means the workspace did not look like a Garry’s Mod project. Click the status bar item to switch, or set glua.activation to always.

​
Setting it as your formatter

Register it as the default formatter for the glua language in your user or workspace settings.json:

​
Requirements

  • VS Code 1.85 or newer
  • No network connection required at runtime (the full wiki dataset is bundled)
  • No additional dependencies or external tools needed

Related topics

Install GLua for VS CodeGLua Code Formatterglua-gmodGLua for Garry's Mod: GMod Lua IDE Support