lumina

Lumina — Lovable for Game Dev

Turn natural language into working Unity (and soon Unreal Engine 5) games. Lumina is a Claude Code plugin: an orchestration + UX + game-dev-knowledge layer that drives existing open-source engine MCP servers and AI asset-generation APIs behind a single loop — plan → scaffold → generate code & assets → build → read errors → self-correct → playtest.

Status: MVP (Unity-first). Unreal support and richer asset generation are planned for v1.

What's inside

Path	Purpose
.claude-plugin/plugin.json	Plugin manifest + userConfig for API keys (Meshy/Tripo/ElevenLabs).
.mcp.json	Wires the Unity engine MCP + the bundled lumina-assets server.
servers/assets/	Custom MCP server: text→3D (Meshy/Tripo), text→SFX (ElevenLabs), with caching.
agents/lumina-orchestrator.md	The generator/verifier agent that runs the build loop.
skills/new-game/	Interview → one-page GDD + plan → hand off to the orchestrator.
skills/scaffold-unity/	Prepare a Unity project (folders, .gitignore, LFS, MCP bridge).
skills/gameplay-system/	Reusable systems (player controller, pickups, UI, …) + Unity C# patterns.
skills/build-verify/	Headless compile + play-mode tests → structured errors.
skills/playtest/	Enter play mode, screenshot + logs, confirm it matches intent.
hooks/hooks.json + scripts/doctor.mjs	SessionStart prerequisite check.
monitors/monitors.json + scripts/tail-unity-log.mjs	Streams Unity Editor errors to the agent.
templates/unity/	.gitignore + .gitattributes (LFS) applied to new projects.

Prerequisites

• Node.js 18+ (the asset MCP server uses global fetch).
• Unity (current LTS recommended) with the CoplayDev/unity-mcp companion package installed in your project, and the Editor open (the MCP only connects while the Editor runs). Repo: https://github.com/CoplayDev/unity-mcp
• Optional API keys (set when enabling the plugin): MESHY_API_KEY or TRIPO_API_KEY for 3D, ELEVENLABS_API_KEY for SFX. Without them, Lumina falls back to primitive placeholder assets.

Install (2 commands)

Lumina installs through Claude Code's plugin marketplace — no downloading, no npm install. Full step-by-step (including for non-coders) in INSTALL.md.

/plugin marketplace add https://github.com/tapascodespace/claude-plugin.git
/plugin install lumina

Then, with a Unity project open:

/lumina:new-game a 3D collect-the-coins prototype

The bundled lumina-assets MCP server has zero dependencies — it implements the MCP stdio protocol directly, so it runs the moment the plugin is installed (only Node.js 18+ is required on the machine for AI asset generation).

Local development

claude --plugin-dir .      # load this working copy without installing
claude plugin validate .   # validate the manifest

The orchestrator will scaffold (if needed), generate a coin mesh, add a player controller + score UI, build, self-correct compile errors, and playtest with a screenshot.

Engine MCP servers (reused, not rebuilt)

• Unity: CoplayDev/unity-mcp (primary), IvanMurzak/Unity-MCP, Unity official AI MCP.
• Unreal (v1): chongdashu/unreal-mcp, flopperam/unreal-engine-mcp, remiphilippe/mcp-unreal.

To enable Unreal later, add an unreal entry to .mcp.json and a scaffold-unreal skill.

Roadmap

• MVP (now): Unity, single playable scene, 3D + SFX generation, self-correcting build loop.
• v1: Unreal in parallel via an engine-agnostic intent layer; textures/sprites/music/animation; more genres; headless tests + auto-retry; Git LFS workflow; guided vs pro profiles.
• Later: multiplayer/netcode, monetization, platform export, cloud/headless engine runners, metric-driven "is it fun" playtest agents.

Known constraints

Long build times (favor C#/data-driven), Blueprint graphs aren't text-diffable, binary assets need LFS, engine version drift, and "compiles ≠ fun" — feel/balance stays a human judgment. See the project plan for the full risk list and mitigations.

License

MIT