Garry's Mod Lua API Definitions

This repository scrapes the Garry's Mod Lua API and generates annotated code snippets that will help provide autocompletion for Lua in editors like VSCode, NeoVim and more.

🔨 Usage

To get autocompletion for the Garry's Mod Lua API in your Garry's Mod projects, you need to install the Lua Language Server and our GLua API Definitions.

First install Lua Language Server (LuaLS): for your editor of choice:

• Visual Studio Code Extension

• NeoVim Configuration

Then download/install our GLua API Definitions for the Lua Language Server. This process varies depending on your editor:

• Visual Studio Code

• NeoVim

Visual Studio Code

Installing our GLua API Definitions for the Lua Language Server in Visual Studio Code is easy thanks to the Lua Language Server Addon Manager built into the VSCode extension.

1. In Visual Studio Code open the Command Palette with the key combination Ctrl+Shift+P (or Cmd+Shift+P on macOS)

2. Search for Addon, then select Lua: Open Addon Manager ...:

3. Search for the Garry's Mod addon and Enable it:

NeoVim

1. Clone (or download and unzip) our lua-language-server-addon branch

2. Follow the instructions in the Lua Language Server documentation and point workspace.userThirdParty to where you placed the lua-language-server-addon branch

📅 Automatically up-to-date

Using GitHub Actions, this repository is automatically updated on the first day of every month at approximately 00:00 UTC.

A workflow will automatically scrape the latest Garry's Mod Lua API from the Garry's Mod Wiki and package them into 🔗 a release.

Note

The Lua Language Server addon might not be immediately updated to align with the definitions in this repository. This delay occurs because we must submit a pull request (PR) to the Lua Language Server Addons repository (LuaLS/LLS-Addons) to update the addon. Subsequently, a maintainer of the LuaLS/LLS-Addons repository needs to find time to review and merge the PR.

Our schedule for updating our addon with LuaLS/LLS-Addons is set for the first day of February, April, June, August, October, and December. This schedule is subject to change based on the availability of maintainers and the urgency of the update.

If you urgently require the most current definitions from the addon, you can expedite the process by submitting a PR to update it yourself. Instructions for doing so can be found in the CONTRIBUTING.md file.

🤖 Advanced Usage

Running the Scraper Locally

You can clone this repository and run the scraper yourself. This is useful if you want to use the latest version of the API, or if you want to make changes to the scraper.

1. Clone this repository

2. Install the dependencies with npm install

3. Run the scraper with npm run scrape-wiki

Testing the project

This project uses Jest to automate testing. You can run the tests with npm test.

API as JSON

The API is also available as JSON. You can find it with the Lua API package on 🔗 the releases page. It is named something like YYYY-MM-DD_HH-MM-SS.json.zip.

Manual Installation

If you cannot or do not want to use Lua Language Server:

1. Download and unzip the latest release from 🔗 the releases page, it's named something like YYYY-MM-DD_HH-MM-SS.lua.zip

2. Include or symlink the unzipped directory into your workspace

Contributors

luttje 💻	Aske 💻	Vurv 💻	jason 🤔	_AMD_ 🐛	[aka]bomb 🐛 💻	Rubat 💻
Techbot121 🐛	TIMON_Z1535 🤔 🐛