AI Service Setup

The first time you open the editor with Blueprint AI installed, setup.py runs once. It looks at your project folder for a .claude/ (or a CLAUDE.md / AGENTS.md) and copies the bundled skill file into Claude’s skills directory.

After that, Claude knows about Blueprint AI. Ask it to create or edit an Unreal asset and it calls cli.py itself.

You can re-run setup any time:

python Plugins/BlueprintAI/setup.py

Supported assistants

Assistant	Skill location	In-editor chat panel
Claude	.claude/skills/unreal/	✅ Bundled

Claude is the supported assistant. First-class integration for Cursor, GitHub Copilot, Windsurf, and OpenAI Codex ships next; for now, those tools drive Blueprint AI via the bring-your-own CLI path below.

Uninstalling

To remove the installed skill:

python Plugins/BlueprintAI/setup.py --uninstall

How the skill works

A skill file is a short markdown document that describes Blueprint AI to the AI assistant:

• When to engage — any request to create, edit, or inspect an Unreal asset
• What’s available — a pointer to the CLI’s self-documenting schema (not the schema itself — keeps the per-session cost low)
• How to call it — invoke cli.py schema to learn operations, then cli.py apply to run a plan

Claude reads the skill on session start. From your side this means you can say “create a pickup Blueprint” and Claude knows to use Blueprint AI rather than writing Python or C++ from scratch.

Note

If you update Blueprint AI to a version that adds new operations, re-run setup.py to refresh the skill. The installer is idempotent — already-current skills are skipped, so it’s safe to run every editor launch (and indeed it does).

Any other AI tool

Any tool that can shell out to a CLI can drive Blueprint AI. Point it at the CLI and let the self-documenting schema do the rest:

CLI="python Plugins/BlueprintAI/Scripts/cli.py"

# Discover every operation and its parameters
$CLI schema

# Apply an operations plan from stdin
echo '[{"op":"create_blueprint","path":"/Game/Pickups","name":"BP_Pickup","parent":"Actor"}]' \
    | $CLI apply --stdin

# Inspect an existing asset
$CLI inspect /Game/Pickups/BP_Pickup

Pipe cli.py schema into your tool’s system prompt once; the model produces valid operation plans on its own from then on. See the CLI Commands reference for the full command list.