Settings
All Blueprint AI settings are accessible via Project Settings > Plugins > Blueprint AI. Settings are stored in Config/DefaultBlueprintAI.ini.
Agent Profiles
Profiles let you create named configurations that control which tools are exposed to the AI and provide domain-specific instructions. Each profile has:
- Profile ID — Stable internal key (e.g.,
builtin_animation) - Display Name — Shown in the profile picker
- Enabled Tools — Whitelist of tool names. Empty set = all tools enabled.
- Custom Instructions — Text appended to the system prompt when this profile is active
- Tool Description Overrides — Per-tool description replacements to specialize tool behavior
Built-in profiles can be edited but not deleted. Custom profiles can be created and removed freely.
All Settings Reference
General
| Setting | Type | Default | Description |
|---|---|---|---|
| Auto-Connect on Startup | bool | false | Automatically connect to the last-used agent when the editor starts. |
| Check for Updates | bool | true | Check for newer Blueprint AI builds on editor startup and show an update banner if available. |
General | Storage
| Setting | Type | Default | Description |
|---|---|---|---|
| Session Archive Directory | FDirectoryPath | {Project}/Saved/BlueprintAI/Sessions/ | Override where session transcripts are stored. Use a shared folder to preserve history across projects. |
General | Chat
| Setting | Type | Default | Description |
|---|---|---|---|
| Chat Text Size | int32 | 12 | Font size for chat messages (8-24 points). |
| @ Picker: Include Engine Assets | bool | false | Include Engine assets (e.g. /Engine/BasicShapes) in the @ context picker. |
| @ Picker: Include Plugin Assets | bool | false | Include plugin assets in the @ context picker. |
OpenRouter
| Setting | Type | Default | Description |
|---|---|---|---|
| OpenRouter API Key | FString (password) | (empty) | API key for the built-in OpenRouter agent. Get one at openrouter.ai. |
| Default OpenRouter Model | FString | anthropic/claude-sonnet-4 | Default model ID for new OpenRouter sessions. Can be changed per session. |
BAI Agents
| Setting | Type | Default | Description |
|---|---|---|---|
| System Instructions | FString (multiline) | (built-in prompt template) | Custom instructions appended to the system prompt for all CLI agents. Includes discovery rules, execution rules, validation loops, and safety guardrails. |
| Custom Agents | TArray<FBAIAgentSettingsEntry> | (empty) | Define custom ACP-compatible connectors. Each entry spawns an external process communicating over stdin/stdout. |
Generation | Images
| Setting | Type | Default | Description |
|---|---|---|---|
| Default Image Model | FString | google/gemini-2.5-flash-image-preview | Default OpenRouter model ID for the generate_image tool. Must support image output. |
Generation | 3D (Meshy)
| Setting | Type | Default | Description |
|---|---|---|---|
| Meshy Key | FString (password) | (empty) | API key for Meshy text-to-3D generation. Get one at meshy.ai. |
| Default Meshy Style | FString | realistic | Default visual style preset (realistic, cartoon, low-poly, sculpture, pbr). |
| Meshy Timeout (seconds) | int32 | 300 | Maximum wait time for a Meshy generation job (60-600 seconds). |
MCP Server
| Setting | Type | Default | Description |
|---|---|---|---|
| Preferred MCP Port | int32 | 9315 | Preferred port for the embedded MCP server. Nearby ports are probed if unavailable. |
| Allow Browser-Origin Requests | bool | false | When disabled, requests with an Origin header are rejected to prevent CSRF from browser-based attacks. |
Tools
| Setting | Type | Default | Description |
|---|---|---|---|
| Tool Timeout (seconds) | int32 | 60 | Maximum runtime before a tool timeout is returned to the agent. The tool can continue in background. Set 0 to disable. |
| Globally Disabled Tools | TSet<FString> | (empty) | Tool IDs disabled across all profiles and sessions. |
Profiles
| Setting | Type | Default | Description |
|---|---|---|---|
| Agent Profiles | TArray<FBlueprintAIAgentProfile> | (built-in presets) | Create, edit, and remove profile presets. Each profile can restrict tools and append specialized instructions. |
Debug
| Setting | Type | Default | Description |
|---|---|---|---|
| Verbose Transport Logging | bool | false | Log all JSON-RPC and MCP payloads to the Output Log (LogBlueprintAI). High log volume. |