
Luaward
io.github.luawardPublished by GitHub account luawardv0.2.8Updated Nov 21, 2026
Luau script protection, licensing, live Roblox in-game QA, and Windows Computer Use.
Overview
Luaward connects coding agents to a Luaward workspace for protected Luau script builds, licensing, and live Roblox in-game QA.
- What you can do
- Create, build and deploy protected Luau scripts at fast, balanced or max levels, stage drafts and promote or roll back live versions
- Manage license keys and HWID resets, and resolve player error reports
- Inspect connected Roblox sessions, run isolated tests with cleanup, and profile FPS and memory
- Snapshot GUI handles and interact with UI controls safely
- Optionally, on Windows, drive desktop mouse and keyboard, take OS screenshots, compare screens, and control windows and processes
- When to use it
- Useful when you ship Luau/Roblox scripts and want an agent to build and deploy protected versions, manage licensing, or test and profile a live game session without leaving the editor.
- Requirements
- A Luaward account with OAuth 2.1 sign-in (or a scoped personal MCP token supplied as LUAWARD_MCP_TOKEN) and a workspace. The hosted endpoint is remote; the optional Windows desktop bridge runs locally via npx and needs Node.js. Live game tools require a connected Roblox session.
Installation
In SourceWeft
- Open Luaward in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.luaward%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"luaward": {
"type": "http",
"url": "https://luaward.com/mcp"
}
}
}README
Luaward Official AI Plugin
Luau script protection, licensing, and live Roblox in-game and Studio QA for Claude, Antigravity, Gemini CLI, Codex, and MCP agents
Protect, build, test in a live Roblox session, inspect GUI and remotes, and sync with Roblox Studio directly from your coding agent.
Overview
The Luaward plugin connects Antigravity to your Luaward workspace over Luaward's hosted MCP server (https://luaward.com/mcp) using OAuth 2.1, and pairs two specialized skills (luaward-workspace and luaward-live-qa) plus workspace safety rules (rules/AGENTS.md).
- Workspace & Protection: create and deploy protected Luau scripts (
fast,balanced,max), stage drafts (publish: false), test builds, promote/roll back live versions (promote_build), manage license keys/HWID resets, and resolve player error reports. - Live Game QA & Profiling: inspect connected sessions, run isolated tests (
run_and_collectwithclean_envand resource cleanup viacleanup_run), profile FPS/memory (benchmark_session), inspect UI handles (gui_snapshot), and interact safely (ui_controls). - Windows Desktop & Visual QA (Optional Hybrid Bridge): combine Luaward Cloud (
https://luaward.com/mcp) and localfile_pathscript loading with@luaward/mcp(npx -y @luaward/mcp) on Windows for hardware Win32 input (os_click,desktop_mouse,desktop_keyboard), OS PNG screenshots and visual diffs (desktop_screenshot,compare_screens), window/process control (desktop_launch,desktop_window,desktop_ui_tree).
Quick start
1. Install the plugin
From Antigravity Customizations -> Plugins (once published to the Marketplace), find Luaward and click Install. Or install directly from a local checkout:
2. Connect your Luaward account (OAuth 2.1)
Installing the plugin enables its skills and rules. Sign in to unlock Luaward Cloud MCP tools.
- Open Agent settings -> Customizations.
- Click Authenticate next to the
luawardMCP server entry in the Luaward plugin. - Sign in to your Luaward account in the browser and authorize your workspace.
- Copy the authorization code if prompted, paste it into the authentication field in settings, and click Submit.
Antigravity refreshes OAuth access tokens automatically. You can also generate a personal scoped MCP token (lwm_...) anytime at dash.luaward.com/dashboard/ai.
3. Optional: Enable Windows Desktop Bridge (@luaward/mcp)
If you develop on Windows and want hardware Win32 mouse/keyboard automation, window management, OS screenshots, and local file_path script loading, add @luaward/mcp to your local MCP config alongside your standalone Potassium or Roblox Studio MCP configs (if used):
4. Try it out
Ask Antigravity:
List my Luaward projects, scripts, and connected live Roblox game sessions.
Or try:
- Run a live in-game QA check on my Roblox session and inspect GUI controls and remotes.
- Diff my open Roblox Studio place against the live game and mirror missing remotes or GUI.
- Deploy a draft build from my script, test it in-game, and promote it when clean.
Troubleshooting
Installed, but Luaward tools do not appear
Check that the Luaward plugin is enabled in Agent settings -> Customizations, then click Authenticate on the luaward MCP server entry (or check that your workspace has an active session/token).
Browser OAuth finished, but Antigravity is still waiting
Copy the authorization code shown after approving access on luaward.com/oauth, paste it into the authentication prompt inside Antigravity settings, and click Submit.
Live game tools return "no game is connected"
Connect a live game session from the Luaward Dashboard ("Test in game"), or run the workspace pair snippet inside your connected Roblox executor session.
Links & Development
- Workspace MCP Docs: luaward.com/docs/ai-tools/workspace-mcp
- NPM Hybrid Bridge (
@luaward/mcp): npmjs.com/package/@luaward/mcp - Release & Marketplace Guide: RELEASING.md
Source: README.md at commit 4aef70a
Tools
0Version history
1- v0.2.8LatestNov 21, 2026
Score
75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.