High-performance cross-platform Lua debugger with full debugging features including breakpoints, variable watch, stack trace, and more.
- 🎯 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
| Platform | Status | Notes |
|---|---|---|
| Windows x64 | ✅ | Fully supported |
| macOS | ✅ | Intel & Apple Silicon |
| Linux | ✅ | any |
| Lua Version | Status | Notes |
|---|---|---|
| Lua 5.1 | ✅ | Fully supported |
| Lua 5.2 | ✅ | Fully supported |
| Lua 5.3 | ✅ | Fully supported |
| Lua 5.4 | ✅ | Fully supported |
| LuaJIT | ✅ | Fully supported |
git clone https://github.com/EmmyLua/EmmyLuaDebugger.git
cd EmmyLuaDebuggermkdir build
cd build
cmake .. -DEMMY_LUA_VERSION=54
cmake --build . --config Releasemkdir build
cd build
cmake .. -DEMMY_LUA_VERSION=54 -DCMAKE_BUILD_TYPE=Release
cmake --build . --config Release-- 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!")- Open an IDE that supports EmmyLua (e.g., IntelliJ IDEA + EmmyLua plugin)
- Configure the debug connection:
TCP Connectmode, addresslocalhost:9966 - Click to start debugging
- Set breakpoints in your code and enjoy debugging!
| Option | Default | Description |
|---|---|---|
EMMY_LUA_VERSION |
54 |
Lua version (51/52/53/54/jit) |
EMMY_USE_LUA_SOURCE |
OFF |
Whether to build with Lua source |
# Build for a specific version
cmake .. -DEMMY_LUA_VERSION=53
# Build using Lua source
cmake .. -DEMMY_USE_LUA_SOURCE=ON-
Install required build tools:
- Windows: Visual Studio 2019+
- macOS: Xcode + Command Line Tools
- Linux: GCC 7+ or Clang 6+
-
Install CMake 3.11+
-
Clone and build the project:
git clone --recursive https://github.com/EmmyLua/EmmyLuaDebugger.git cd EmmyLuaDebugger mkdir build && cd build cmake .. cmake --build .
- libuv - Cross-platform asynchronous I/O library
- nlohmann/json - Modern C++ JSON library
- Lua - Powerful embedded scripting language
⭐ If you find this project helpful, please give us a Star! ⭐
Made with ❤️ by EmmyLua Team