Read this in Chinese (简体中文)

INI IntelliSense for Red Alert 2

INI IntelliSense is a powerful, feature-rich Visual Studio Code extension tailor-made for Command & Conquer: Red Alert 2 mod development. It aims to revolutionize your workflow on .ini configuration files by providing a modern coding experience, including dynamic syntax highlighting, deep language intelligence, advanced diagnostics, and intuitive inheritance visualization.

Key Features

1. Dynamic Syntax Highlighting

Going beyond traditional static syntax files, this extension provides more accurate and richer coloring through dynamic code analysis.

• Multi-level Keys: Applies different colors to different parts of Key.Part1.Part2.
• Complex Section Syntax: Accurately highlights the [Section]:[Inherits] structure.
• Fully Customizable: All colors can be freely configured in VS Code settings.

2. Schema-Driven IntelliSense

The core capabilities of this extension are driven by a configurable rule file (INICodingCheck.ini), providing unparalleled contextual awareness.

• Auto-Completion:
  • Keys: Intelligently suggests all available keys based on the current section's type (including inheritance).
  • Values: Provides completion for boolean values (yes/no), colors, and all IDs registered in [Registries] (e.g., unit, building, weapon names).
• Hover Information:
  • Type & Source: Displays the key's type (e.g., TechLevel: int) and its source (e.g., Ares, Phobos, or Original Game), helping you distinguish between vanilla and extension features.
  • CSF Preview: If a value refers to a CSF string (e.g., UIName=Name:Apoc), hovering will show the actual localized text (e.g., "Apocalypse Tank").
  • Override Details: When a key overrides a value from a parent section, the hover information clearly shows the overridden parent section's name, file, line number, and the old value, with a one-click link to jump to it.
• Go to Definition:
  • Hold Ctrl and click on a value (like a unit ID) to jump across files to that unit's [Section] definition.

3. Advanced Diagnostics

• Built-in Real-time Checks:
  • Code Style: Checks for extra spaces around the equals sign, leading whitespace; ensures proper spacing before/after comments.
  • Type Validation: Validates value types in real-time against the schema (e.g., int, float, numeric ranges, enum values).
• External Validator Integration:
  • Seamlessly integrates with INIValidator.exe for deeper, cross-file logical validation. Easily manage and run it via a status bar icon or command.

4. Inheritance & Reference Visualization

• Override Indicator: Displays a clear up-arrow (↑) next to the line number, intuitively showing that the key on this line overrides a definition from a parent class.
• CodeLens: Above each [Section], it shows how many times that section is referenced as a "value" and "inherited from" across the entire workspace.
• Find All References: Right-click a section name to find all places that reference or inherit from it.

5. More Handy Features

• CSF File Support: Native support for parsing binary .csf string files in your workspace, powering hover previews and potential future features.
• Color Picker: Provides a visual color picker and preview for R,G,B formatted color values.
• INI Project Explorer: A dedicated view in the activity bar that clearly displays all indexed INI files and their internal structure (sections, keys) in a tree, for quick navigation.
• Code Folding: Supports folding code blocks by [Section].
• Performance Optimized: With configurable file indexing rules, the extension only scans the *.ini files you specify (by default, only core game files in the root), ensuring swift response even in large workspaces.

Installation & Configuration

Installation

1. Download the latest .vsix file from the release page.
2. In VS Code, open the Extensions view (Ctrl+Shift+X).
3. Click the three-dots menu (...) in the top-right corner and select "Install from VSIX...".
4. Choose the .vsix file you downloaded and install it.
5. Reload VS Code.

Initial Setup

To get full IntelliSense and diagnostics, you need to configure the dictionary file (INICodingCheck.ini) and your Mod root directory.

1. The extension will prompt you with a Setup Wizard upon first activation.
2. You can also click the $(rocket) INI: Show Setup Guide command or use the status bar menu to reopen the wizard.
3. The wizard helps you download the official dictionary (with latest Ares/Phobos support) and set up your workspace paths automatically.

Diagnostic Error Codes

You can use these codes in ra2-ini-intellisense.diagnostics.severity to customize the error level (Error, Warning, Information, Hint, None) for each rule.

Settings

You can configure this extension in detail in your VS Code settings.json file (Ctrl+,).

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.