Skip to content
BlueprintAI

Troubleshooting

import { Aside } from ‘@astrojs/starlight/components’;

Skills not installed after opening the editor

Section titled “Skills not installed after opening the editor”

Run setup manually:

Terminal window
python Plugins/BlueprintAI/setup.py

If setup runs but skills are still missing, check that the target AI service is installed and that BlueprintAI can locate its configuration directory. Run with verbose output:

Terminal window
python Plugins/BlueprintAI/setup.py --verbose

“No CLI output” or empty response from the AI

Section titled ““No CLI output” or empty response from the AI”

The AI tried to run an operation but got no response. Common causes:

  • Editor not found — BlueprintAI could not locate the Unreal Engine installation. Check that UE 5.7+ is installed and that Scripts/utils/paths.py can resolve the engine path.
  • Python plugin disabled — ensure PythonScriptPlugin is enabled in your project.
  • Port conflict — BlueprintAI uses UDP port 6776 for remote execution. Check nothing else is using that port.

Run the schema command to test basic connectivity:

Terminal window
python Plugins/BlueprintAI/Scripts/cli.py schema

Compilation errors after an operation

Section titled “Compilation errors after an operation”

The AI receives the full compiler error and usually corrects itself. If it cannot, inspect the asset manually in the editor. Common causes:

  • A referenced class or asset does not exist at the specified path
  • A function signature mismatch (parameter type changed elsewhere in the project)
  • A node was wired to an incompatible pin type

”Domain not available” for Enhanced Input / Control Rig / State Trees

Section titled “”Domain not available” for Enhanced Input / Control Rig / State Trees”

These domains require optional engine plugins. Go to Edit → Plugins and verify:

  • Enhanced Input: EnhancedInput plugin enabled
  • Control Rig: ControlRig and RigVM plugins enabled
  • State Trees: StateTree plugin enabled
  • Common UI: CommonUI plugin enabled

After enabling plugins, restart the editor.

Operations succeed but the asset looks wrong

Section titled “Operations succeed but the asset looks wrong”

Use the inspect command to verify the actual state of the asset:

Terminal window
python Plugins/BlueprintAI/Scripts/cli.py inspect /Game/MyAsset/BP_Example

Then ask the AI to describe what it sees versus what was expected. This gives the AI the context to issue corrective operations.

The editor opens but hangs during an operation

Section titled “The editor opens but hangs during an operation”

BlueprintAI runs operations in commandlet mode. If the commandlet hangs:

  1. Kill the UnrealEditor.exe process
  2. Delete Saved/Autosaves/ if the project was left in a partial state
  3. Re-run the operation

If hanging persists, check Saved/Logs/ for the last commandlet log for error details.