SF
STS Forge

Quick Start: AI Integration

Connect AI assistants to read and modify your Blueprints using Blueprint AI Assistant.

Two ways to use AI with your Blueprints:

  • Agentic AI: Use Claude Code, Cursor, or Codex to read and modify Blueprints directly from your IDE.
  • Export and upload: Export Blueprints to text and drop them into ChatGPT, Gemini, or any AI chat.

Tools like Claude Code, Cursor, and Codex can read the plugin's documentation, then call its operations on your behalf. You ask for changes in plain English. The AI figures out which operations to run and handles the details.

How it works#

The plugin offers three interfaces: an HTTP server, a single-operation commandlet, and a batch mode. Your AI picks between them automatically based on context:

  • Editor is open: The AI detects the running HTTP server and enters live coding mode. Changes appear in your editor in real time.
  • Editor is closed: The AI chooses between the commandlet (single operation) or batch mode (multiple operations) depending on what you asked for. Each invocation starts the engine headlessly, runs the operations, and exits.

You do not need to launch servers, write curl requests, or pick between modes. The AI reads the plugin docs and handles transport selection transparently.

Setting up Claude Code#

  1. Install the plugin (Installation)
  2. Add this block to your project's CLAUDE.md file (create one if it doesn't exist). Replace paths with your actual engine and project paths:
## BlueprintAIAssistant (BAA)

Plugin for reading and modifying Blueprints, Materials, DataTables, and other
UE assets. See [AI_GUIDE.md](Plugins/BlueprintAIAssistant/Docs/AI_GUIDE.md)
for the full operation list and invocation patterns.

### Paths
- Engine: `C:\YOUR_ENGINE_PATH\Engine\Binaries\Win64\UnrealEditor-Cmd.exe`
- Project: `C:\YOUR_PROJECT_PATH\YourProject.uproject`

### Quick reference
See `Plugins/BlueprintAIAssistant/Docs/AI_GUIDE.md` for the complete operation
list. Load this file when you need to work with Blueprint assets.

### Transport (use fastest available)
1. Check `curl -s http://localhost:7850/baa/v1/status` -- if success, use HTTP
2. If refused and multiple ops needed, launch BAAServer in background
3. Otherwise, one-shot commandlet

### Key rules
- Use `detail` format when you need node GUIDs for write operations
- Use `batch` for multiple operations (avoids repeated 30-60s engine startups)
- Use `-compile -save` flags on write verbs to finalize changes
- All arg keys are lowercase (e.g., `srcnode` not `srcNode`)
  1. Verify it works. Ask Claude:
Use BAA to list all available operations

Claude reads the AI guide, picks the right interface, and returns the operation list.

What to ask#

Talk to your AI the same way you would describe the task to another developer:

  • "Export BP_MyBlueprint": the AI reads any Blueprint and returns its structure
  • "Add a Health variable to BP_Player": creates the variable with the type and flags you specify
  • "What nodes are in BP_Enemy's EventGraph?": reads and describes the graph
  • "Create a new Blueprint called BP_Pickup based on Actor": creates the asset, adds components, sets defaults

The AI translates your request into the right sequence of operations, compiles, and saves.

Option B: Export and upload#

If you prefer working with ChatGPT, Gemini, or another AI chat, you can export your Blueprints to text and upload the files directly. This gives any AI full visibility into your Blueprint's structure without needing tool integration.

  1. Right-click a Blueprint in the Content Browser
  2. Select Blueprint AI Assistant > Quick Export to Text
  3. Upload the exported file to your AI chat
  4. Ask questions or request changes. The AI can read the full structure: variables, functions, components, graph nodes, and connections.

This approach works for code review, debugging, understanding unfamiliar Blueprints, and planning changes. The AI cannot apply changes back to the editor directly, but it can tell you exactly what to change or generate batch JSON you can run yourself.

See Output Formats for the four detail levels and when to use each.

How the plugin works (background)#

You do not need to understand this to use the plugin with AI, but it helps to know what is happening behind the scenes.

Interface When AI uses it What happens
HTTP Server Editor is open AI sends requests to localhost:7850. Changes apply live. No engine startup cost.
Commandlet Editor closed, single operation AI runs the engine headlessly for one operation (~30-60s startup).
Batch Mode Editor closed, multiple operations AI bundles operations into a single engine invocation (~30-60s total).

All operations return JSON. Running the same operation twice produces the same result with no duplicates, so re-runs are safe.

Next steps#