Claude Mario Clone

A Mario-style platformer game built with Claude Code and the Unity Editor.

Features

• Player movement and physics
• Tile-based levels
• Enemies
• Collectibles
• Sound effects

---

Setup

Prerequisites

• Unity 6 (6000.4.0f1) — confirmed working version
• Claude Code (VS Code extension or CLI)
• uv Python package manager

---

1. Install the Unity MCP Package

1. Open Unity Editor
2. Go to Window → Package Manager
3. Click the + button (top left) → Add package from git URL
4. Enter the following URL and click Add:

   https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main
   

---

2. Start the MCP Server in Unity

1. Go to Window → MCP for Unity
2. Click Start Server
3. The server will start on http://localhost:8080/mcp

Keep Unity open and the server running whenever you want Claude Code to have access to the editor.

---

3. Configure Claude Code (VS Code Extension)

The MCP server config is already included in this repo at .mcp.json:

{
  "mcpServers": {
    "unityMCP": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

If Claude Code does not pick it up automatically, register it manually via the CLI:

claude mcp add --transport http unityMCP http://localhost:8080/mcp

Verify the connection:

claude mcp list

You should see unityMCP: http://localhost:8080/mcp (HTTP) - ✓ Connected.

---

4. Add Claude Code CLI to PATH (macOS)

If the claude command is not found in your terminal, add it to your PATH:

echo 'export PATH="$PATH:/Users/$USER/Library/Application Support/Claude/claude-code/2.1.87/claude.app/Contents/MacOS"' >> ~/.zshrc && source ~/.zshrc

Note: Replace 2.1.87 with your installed version if different.

---

Package Notes

• TextMeshPro — in Unity 6, TMP is bundled inside com.unity.ugui (v2.0.0). Do not install com.unity.textmeshpro separately; it is incompatible with Unity 6000.x. If you see TMPro namespace errors, install com.unity.ugui via the Package Manager.

Development

This project is built interactively with Claude Code. See CLAUDE.md for development conventions.