Mirae Engine (Anima Language Support)

This extension adds full language support for Anima, the scripting language used by the Mirae Game Engine, along with its associated Codex data format.

Anima is a clean, modular scripting language designed for elegant game logic and rich in-world behavior, while Anima Codex represents a structured, human-readable data format used to define objects, figures, and other assets.

✨ Features

• Syntax highlighting for both .anima and .codex files
• Semantic highlighting for:
  • IDs (@id)
  • Procedures
  • Events
  • Functions
  • Engine modules
  • Vectors (<x, y, z>)
  • Colors (<r, g, b, a>)
• Type-aware color picker support for color vectors in <r, g, b, a> or <r, g, b> format
• Error highlighting for illegal code patterns in .codex files
• Beautiful custom themes: Mirae Anima (Dark) and Mirae Anima (Light)
• Workspace-specific theme application with command shortcut

📁 File Types

🛠 Syntax Overview

Anima

procedure move_to(entity, position, speed) {
    kinetique.move_to(entity, position, speed)
}

function calculate_angle(origin, target) {
    dir = normalize(target - origin)
    return atan2(dir.z, dir.x)
}

with @door {
    on open() {
        tray.play_sound("creak")
    }
}

Anima Codex

codex = [
  @lamp_001: [
    type: "curiosa"
    mesh: "lamp_post"
    color: <0.8, 0.7, 0.6, 1.0>
    position: <2.5, 0.0, 7.0>
  ]
]

Illegal keywords and logic (e.g., procedure, if, on) are highlighted as errors in .codex files unless used inside a data block.

🎨 Theme Management

You can automatically apply the Mirae Anima (Dark) theme to your current workspace using:

Command Palette → Mirae: Set Theme for Current Workspace

This will write to your project's .vscode/settings.json:

{
  "workbench.colorTheme": "Mirae Anima (Dark)"
}

You can still manually select any theme from the VS Code theme menu as usual.

📦 Requirements

• Visual Studio Code 1.101.0 or later

🧾 Version History

0.1.0 (Current)

• Added color picker support for <r, g, b, a> and safe <r, g, b> color vectors
• Improved semantic highlighting for math functions and operators
• Highlighted invalid syntax in .codex files, including illegal keywords and function calls
• Added hex (0x...) and binary (0b...) numeric literal support
• Cleaned up language scopes and organized grammar structure
• Added new command to apply workspace-specific theme

📚 More Information

For full documentation and support, visit: 🌐 mirae-core.com

Want to contribute? Have suggestions? Check out the issue tracker.

Mirae is a digital atelier — a space for expressive, open-world creation.