🚀 EmmyLua Debugger

High-performance cross-platform Lua debugger with full debugging features including breakpoints, variable watch, stack trace, and more.

✨ Features

• 🎯 Full Debugging Features - Breakpoints, step execution, variable watch, stack trace
• 🌍 Cross-Platform Support - Windows, macOS, Linux
• ⚡ High Performance - Efficient debugging communication based on TCP protocol
• 🔧 Easy Integration - Supports multiple Lua versions and game engine integration

🎮 Supported Platforms

🔧 Lua Support

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/EmmyLua/EmmyLuaDebugger.git
cd EmmyLuaDebugger

2. Build the Project

Windows (Visual Studio)

mkdir build
cd build
cmake .. -DEMMY_LUA_VERSION=54
cmake --build . --config Release

macOS/Linux

mkdir build
cd build
cmake .. -DEMMY_LUA_VERSION=54 -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release

3. Basic Usage

Integrate the debugger in your Lua code:

-- Load the debugger module
local dbg = require('emmy_core')

-- Start the TCP debug server
dbg.tcpListen('localhost', 9966)

-- Wait for IDE connection
dbg.waitIDE()

-- Set a strong breakpoint here
dbg.breakHere()

-- Your Lua code
print("Hello, EmmyLua Debugger!")

Connect the debugger in your IDE:

1. Open an IDE that supports EmmyLua (e.g., IntelliJ IDEA + EmmyLua plugin)
2. Configure the debug connection: TCP Connect mode, address localhost:9966
3. Click to start debugging
4. Set breakpoints in your code and enjoy debugging!

📚 Documentation

🛠️ Build Options

Advanced Build Examples

# Build for a specific version
cmake .. -DEMMY_LUA_VERSION=55
# Build using Lua source
cmake .. -DEMMY_USE_LUA_SOURCE=ON

Development Environment Setup

1. Install required build tools:

   • Windows: Visual Studio 2019+
   • macOS: Xcode + Command Line Tools
   • Linux: GCC 7+ or Clang 6+

2. Install CMake 3.11+

3. Clone and build the project: bash git clone --recursive https://github.com/EmmyLua/EmmyLuaDebugger.git cd EmmyLuaDebugger mkdir build && cd build cmake .. cmake --build .

🙏 Acknowledgements

• libuv - Cross-platform asynchronous I/O library
• nlohmann/json - Modern C++ JSON library
• Lua - Powerful embedded scripting language

📞 Support & Contact

• 🐛 Report Issues
• 💬 Discussion

⭐ If you find this project helpful, please give us a Star! ⭐

Made with ❤️ by EmmyLua Team