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

ASHES Language Support

A Visual Studio Code extension that provides syntax highlighting and IntelliSense for the ASHES (Adventure Scripting Helping Escoria) language used in Escoria adventure game framework.

Features

• Syntax Highlighting: Full syntax highlighting for ASHES language files (.esc)
• Auto-completion: IntelliSense for ASHES commands, built-in variables, and keywords
• Hover Information: Detailed information about commands and variables on hover
• Code Snippets: Pre-built snippets for common ASHES patterns
• Command Reference: Built-in command reference panel
• Smart Indentation: Proper indentation rules for ASHES code structure

ASHES Language Features Supported

Events

• Event definitions with :event_name
• Event flags with | FLAG_NAME

Commands

• All standard Escoria commands (say, set_global, change_scene, etc.)
• Custom commands
• Command parameter hints

Variables

• Local variables with var
• Global variables with global
• Built-in variables (CURRENT_PLAYER, ESC_LAST_SCENE, etc.)
• Global IDs with $ prefix

Control Flow

• If/elif/else statements
• While loops
• Break and done keywords

Dialog System

• Dialog blocks with ?!
• Dialog choices with -
• Conditional dialog choices with [condition]

Comments

• Line comments with #

Installation

1. Copy this extension folder to your VS Code extensions directory
2. Reload VS Code
3. Open any .esc file to see syntax highlighting

Usage

Auto-completion

• Type any ASHES command and press Ctrl+Space for suggestions
• Use $ prefix for global ID suggestions
• Built-in variables are automatically suggested

Snippets

• Type snippet prefixes and press Tab to expand:
  • event - Create new event
  • say - Say command
  • dialog - Dialog block
  • if - If statement
  • And many more...

Command Reference

• Press Ctrl+Shift+P and type "ASHES: Show Command Reference"
• View all available commands with descriptions and parameters

Language Features

Syntax Highlighting

• Events are highlighted in blue
• Commands are highlighted in green
• Variables are highlighted in orange
• Strings are highlighted in yellow
• Comments are highlighted in gray
• Dialog blocks have special highlighting

Smart Indentation

• Automatic indentation for events, control flow, and dialog blocks
• Proper outdenting for break, done, else, etc.

Folding

• Events can be folded for better code organization
• Dialog blocks can be folded

Contributing

This extension is designed specifically for the Escoria framework and ASHES language. If you find issues or want to add features, please contribute to the project.

License

This extension is part of the Gymkhana project and follows the same license terms.