GameScript Language Support for Visual Studio
Bring the full power of the GameScript language into Visual Studio 2022. The extension bundles the Language Server that powers syntax highlighting, completions, diagnostics, code navigation, and more—so you can write your game scripts without leaving your favourite IDE.
✨ Key Features
| Feature |
Description |
| Syntax Highlighting |
Semantic colour-coding for keywords, types (named types and casts included), literals, operators, and comments in .gs files. |
| Completions |
Context-aware completions for funcs, commands, tables, types, variables, constants, and context vars; signature help while typing arguments. |
| Diagnostics |
Real-time error squiggles for parse errors, undefined symbols, type mismatches, and semantic rule violations. |
| Hover Tooltips |
Hover any symbol to see its full signature and any doc-comment attached to its declaration. |
| Go to Definition |
Jump to where any symbol is declared—works across files in the workspace. |
| Find All References |
See every usage of a symbol across the entire workspace. |
| Document Highlights |
All occurrences of the symbol under the cursor are highlighted in the current file. |
| Rename Symbol |
Safely rename any symbol across all files in the workspace. |
| Document Symbols |
Full outline of the current file. |
| Workspace Symbols |
Search for any symbol across the whole workspace. |
| ObjectDef Highlighting |
Syntax highlighting for the host's Object Definition data files (.item, .npc, .menu, .obj, .tile, .varp, .varn, .inv, .anim, .param, .tex, .rig, .fx, .option, .palette). |
(Looking for VS Code support? → check out the GameScript Tools extension on the VS Code Marketplace, which also includes the script debugger.)
📁 Supported File Types
| Extension |
Content |
.gs |
GameScript source: named types, constants, context variables, constant tables, funcs, commands, triggers, and handlers |
gamescript.json |
Project marker — its folder (and subfolders) form one isolated project with its own namespace; the file's contents are ignored |
| Object Definition files (see above) |
Syntax highlighting only |
🛠️ Getting Started
Install
- Download from the Visual Studio Marketplace or use the in-IDE Extensions › Manage Extensions dialog and search for GameScript Tools (publisher Giant Blade).
Restart Visual Studio when prompted.
Open a folder containing .gs files — the language server indexes the workspace automatically. Put a gamescript.json in each script project's root if a workspace holds more than one (for example a server and a client project with different core.gs command sets).
New to the language? Start with the tutorial; the language reference covers the rest.
System Requirements
Visual Studio 2022 (17.0 or later), x64 · Windows 10 v1903 or later. The bundled language server is self-contained — no separate .NET installation needed.
🐛 Known Issues / FAQ
If you hit a bug please open an issue with reproduction steps and the smallest .gs snippet that shows the problem.
📜 License
The extension and bundled Language Server are licensed under the Apache License 2.0.
| |
