gymkhana-actions/vscode-extension-ashes/INSTALL.md

Installation Guide for ASHES Language Support Extension

Quick Installation

1. Copy the extension folder to your VS Code extensions directory:

   • Linux: ~/.vscode/extensions/
   • macOS: ~/.vscode/extensions/
   • Windows: %USERPROFILE%\.vscode\extensions\

2. Rename the folder to ashes-language-support-0.1.0 (or similar)

3. Reload VS Code or restart the application

4. Test the extension by opening any .esc file

Alternative Installation (Development Mode)

1. Open VS Code in the extension directory:

   cd vscode-extension
   code .
   

2. Press F5 to run the extension in a new Extension Development Host window

3. Open a .esc file in the new window to test the extension

Building from Source

1. Install dependencies:

   npm install
   

2. Compile TypeScript:

   npm run compile
   

3. Package the extension (optional):

   npx vsce package
   

Testing the Extension

1. Open the sample file: sample.esc in the extension directory
2. Check syntax highlighting: Events, commands, and variables should be colorized
3. Test auto-completion: Type say( and press Ctrl+Space
4. Test snippets: Type event and press Tab
5. Test hover: Hover over commands like say or set_global
6. Test command reference: Press Ctrl+Shift+P and type "ASHES: Show Command Reference"

Features to Test

• ✅ Syntax highlighting for events (:event_name)
• ✅ Syntax highlighting for commands (say, set_global, etc.)
• ✅ Syntax highlighting for variables (var, global)
• ✅ Syntax highlighting for dialog blocks (?!)
• ✅ Auto-completion for commands
• ✅ Auto-completion for built-in variables
• ✅ Code snippets for common patterns
• ✅ Hover information for commands
• ✅ Smart indentation
• ✅ Code folding for events

Troubleshooting

Extension not loading

• Check that the folder is in the correct extensions directory
• Restart VS Code completely
• Check the Developer Console for errors (Help > Toggle Developer Tools)

Syntax highlighting not working

• Make sure the file has a .esc extension
• Check that the language is set to "ASHES" in the bottom-right corner of VS Code

Auto-completion not working

• Press Ctrl+Space to manually trigger completion
• Check that the extension is activated (should show in the Extensions panel)

Uninstalling

Simply delete the extension folder from your VS Code extensions directory and restart VS Code.