@maplestoryworlds/mlua-lsp
v1.1.0
Published
Fast, cross-platform LSP server for mLua (MapleStory Worlds scripting). Persistent TCP daemon with sub-second responses.
Maintainers
Readme
@maplestoryworlds/mlua-lsp
Launcher and host for the official msw.mlua Language Server. Exposes LSP as a cross-platform CLI for AI agents/scripts, and as a standard stdio server for editors. Does not implement an LSP itself — wraps msw.mlua's languageServer.js.
Install
npm install -g @maplestoryworlds/mlua-lspFirst run uses the bundled msw.mlua VSIX — no VS Code installation required.
Quick start
# Diagnostics on a .mlua file
mlua-lsp diagnose /path/to/project RootDesk/MyDesk/MyScript.mlua
# Hover / completion / definition (line and col are 1-based)
mlua-lsp hover /path/to/project RootDesk/MyDesk/MyScript.mlua 10 5
mlua-lsp complete /path/to/project RootDesk/MyDesk/MyScript.mlua 10 5
mlua-lsp definition /path/to/project RootDesk/MyDesk/MyScript.mlua 10 5
# Prewarm the persistent host before first edit (use in SessionStart hooks)
mlua-lsp start /path/to/project
# Inspect host state
mlua-lsp status /path/to/project
mlua-lsp dump /path/to/projectThe first CLI call spawns a persistent TCP host (~1.7 s cold start). Subsequent calls reuse the warm host with 30–50 ms responses. The host self-terminates after 30 min of inactivity.
Modes
| Mode | Entry | Use case |
|---|---|---|
| CLI (persistent host) | mlua-lsp <cmd> <project> ... | AI agents, hooks, scripts |
| stdio proxy | mlua-lsp serve <project> | Tooling sending many requests |
| LSP server | mlua-lsp server --stdio | VS Code / Cursor / Neovim |
| One-shot | mlua-lsp <cmd> ... --no-daemon | Debug, offline fallback |
Docs
| Topic | File | |---|---| | Install, postinstall, offline | docs/install.md | | CLI commands reference | docs/commands.md | | Environment variables | docs/configuration.md | | msw.mlua resolution order | docs/resolution.md | | Performance baseline | docs/performance.md | | Architecture & internals | docs/ARCHITECTURE.md | | Claude Code hook setup | docs/claude-code-diagnose-hooks.md | | CLI lifecycle walkthrough | docs/manual-cli-walkthrough.md | | vs mlua-lint-api | docs/comparison-with-mlua-lint-api.md | | Known issues | docs/issues/ | | Release history | CHANGELOG.md |
License
MIT
