🚀 EmmyLua2 for IntelliJ IDEA

✨ Features

Powered by the robust emmylua-analyzer-rust engine

🎯 Core Features

• Smart Code Completion - Context-aware precise code suggestions
• Syntax Highlighting - Support for Lua 5.1/5.2/5.3/5.4 syntax
• Error Detection - Real-time syntax and semantic error reporting
• Code Navigation - Quick jump to definitions, find references
• Refactoring Support - Rename, extract variables and other refactoring operations

🔧 Advanced Features

• EmmyLua Annotations Support - Complete type annotation system
• Debugger Integration - Built-in EmmyLua debugger (TCP connect/listen); Emmy Attach Debugger for attaching to running processes (Windows only)
• Multi-platform Support - Full support for Windows, macOS, Linux (Emmy Attach Debugger is Windows only)
• Performance Optimization - High-performance language server based on Rust

🛠️ Installation

Install from JetBrains Marketplace (Recommended)

1. Open IntelliJ IDEA
2. Go to File → Settings → Plugins
3. Search for "EmmyLua2"
4. Click Install to install the plugin
5. Restart IDE

Manual Installation

1. Download the latest version from Releases
2. In IntelliJ IDEA, go to File → Settings → Plugins
3. Click the gear icon → Install Plugin from Disk...
4. Select the downloaded plugin file
5. Restart IDE

🚀 Quick Start

Create Lua Project

1. File → New → Project
2. Select Lua project type
3. Configure project settings
4. Start writing Lua code!

Configure EmmyLua Annotations

---@class Player
---@field name string
---@field level number
local Player = {}

---Create new player
---@param name string Player name
---@param level number Player level
---@return Player
function Player:new(name, level)
    return setmetatable({
        name = name,
        level = level
    }, { __index = self })
end

🔧 Supported IDE Versions

IDE Version	Plugin Version	Status
2024.3+	0.8.x	✅ Actively Supported
2025.2+	0.12.x	✅ Actively Supported

🤝 Contributing

We welcome contributions of all kinds! Please check the Contributing Guide to learn how to participate in the project.

Development Environment Setup

📋 Prerequisites

• JDK 17+ - Recommended to use OpenJDK or Oracle JDK
• IntelliJ IDEA 2024.3+ - Ultimate or Community Edition
• Git - Version control tool

🔨 Build Steps

1. Clone Repository

   git clone https://github.com/CppCXY/Intellij-EmmyLua2.git
   cd Intellij-EmmyLua2
   

2. Import Project

   • Open the project with IntelliJ IDEA
   • Wait for Gradle sync to complete

3. Build Plugin

   ./gradlew buildPlugin
   

4. Run Development Environment

   ./gradlew runIde
   

🎯 Available Gradle Tasks

Task	Description
buildPlugin	Build plugin distribution package
runIde	Run plugin in IDE sandbox
test	Run test suite
downloadEmmyLuaAnalyzer	Download Emmy Lua Analyzer
installDependencies	Install all dependencies
cleanDependencies	Clean downloaded dependencies

🙏 Acknowledgments

• emmylua-analyzer-rust - Core language analysis engine
• EmmyLuaDebugger - Debugger support
• LSP4IJ - LSP client implementation

📄 License

This project is open source under the MIT License.

---