OSU Beatmap Syntax Highlighter

A Visual Studio Code extension that provides syntax highlighting for OSU beatmap (.osu) files.

Features

• Comprehensive syntax highlighting for all OSU beatmap sections:

  • File format version declarations
  • Section headers ([General], [Metadata], [TimingPoints], etc.)
  • Key-value pairs with proper type recognition
  • Timing points with color-coded parameters
  • Hit objects (circles, sliders, spinners) with detailed highlighting
  • Color definitions for combo colors
  • Events and storyboard commands
  • Comments and file references

• Smart recognition of:

  • Numeric values (integers, decimals, negative numbers)
  • Boolean values (0/1, true/false)
  • File paths and extensions
  • Coordinate pairs and timing data
  • Slider curve types (P, B, L, C)
  • Storyboard commands and parameters

• Editor features:

  • Code folding for sections
  • Auto-closing brackets and quotes
  • Comment toggling with //
  • Proper indentation handling

Installation

1. Download the extension package (.vsix file)
2. Open VSCode
3. Go to Extensions view (Ctrl+Shift+X)
4. Click the "..." menu and select "Install from VSIX..."
5. Select the downloaded .vsix file

Usage

The extension automatically activates when you open any .osu file. All OSU beatmap syntax will be highlighted according to the defined color scheme.

Supported File Types

• .osu - OSU beatmap files

Color Scheme

The extension uses semantic highlighting that works with any VSCode theme:

• Section headers - Highlighted as entity names
• Property names - Highlighted as variables
• Numeric values - Highlighted as constants
• File paths - Highlighted as strings
• Comments - Standard comment highlighting
• Timing data - Specialized numeric highlighting
• Storyboard commands - Keyword highlighting

Contributing

Feel free to contribute to this extension by submitting issues or pull requests on the GitHub repository.

License

MIT License - see LICENSE file for details.