ue5-vscode-debugger

# UE5 VSCode Debugger

Configure VSCode for F5 debugging of Python scripts running in Unreal Engine 5 editor via debugpy remote debugging.

## Dependencies

## Dependencies

**Required Skill**: [ue-mcp](https://github.com/jlowin/fastmcp) (for general remote execution)

This skill includes its own `remote-execute.py` for specialized debugging tasks, but relies on `ue-mcp` for:
- Initial UE5 Python plugin configuration verification
- General remote execution needs outside of debugging


## Quick Start

### Setup VSCode for UE5 Debugging

Configure VSCode with debugging launch and task configurations:

```bash
# Auto-detects project from CLAUDE_PROJECT_DIR
python scripts/setup-vscode.py

# Or specify project path explicitly
python scripts/setup-vscode.py --project /path/to/ue5/project

# Force overwrite existing configurations
python scripts/setup-vscode.py --force
```

This automatically creates:
- `.vscode/launch.json` - Debug configurations for attaching to UE5
- `.vscode/tasks.json` - Tasks for starting debugpy server and executing scripts

**Note:** Requires debugpy installed in UE5's Python environment.

### Start Debugging

1. Open any Python file in VSCode
2. Press **F5** (or Run → Start Debugging)
3. Select **"UE5 Python: Debug Current File"**
4. VSCode will:
   - Start debugpy server in UE5 editor (port 19678)
   - Execute your Python file in UE5
   - Attach debugger and hit breakpoints

## Core Workflows

### Workflow 1: First-Time VSCode Setup

For new UE5 projects that need VSCode debugging:

1. **Ensure UE5 project is configured:**
   ```bash
   # Use ue-mcp or direct python command
   ue-mcp configure
   ```

2. **Setup VSCode configurations:**
   ```bash
   python scripts/setup-vscode.py
   ```

3. **Install debugpy in UE5's Python:**
   - Open UE5 Editor
   - Execute via ue-mcp or scripts/remote-execute.py:
     ```bash
     python scripts/remote-execute.py \
       --code "import subprocess; subprocess.run(['pip', 'install', 'debugpy'])"
     ```

4.