Quick Start

Get up and running with NeoStack AI in 5 minutes

1. Open the Chat Window

Go to Tools > Agent Chat or use the keyboard shortcut to open the chat window.

2. Follow the Setup Checklist

The first-run panel shows the checks that matter:

• Connect NeoStack for subscription checks, NeoStack Cloud chat, extensions, and remote access.
• Choose how chat runs with NeoStack Cloud, a local/BYOK provider, or an external ACP agent.
• Verify project tools so the Unreal MCP server is running on the effective port.
• Check local prerequisites if you plan to use external agents such as Claude Code, Codex, or Copilot CLI.

3. Choose the Simplest Chat Path

Option A: NeoStack Cloud

1. Click Connect NeoStack in the Setup Checklist or go to Settings > Chat & Agents > Chat Providers.
2. Sign in on neostack.dev and choose your workspace.
3. Return to the editor. The NeoStack Cloud key is saved automatically.
4. Start a new chat and choose NeoStack Cloud.

Option B: Local/BYOK Provider

1. Go to Settings > Chat & Agents > Chat Providers.
2. Add or select OpenRouter, Ollama, Vercel, or a custom OpenAI-compatible endpoint.
3. Paste the API key if the provider needs one.
4. Start a new chat and choose a model from that provider.

Option C: External ACP Agent

1. Install and sign in to the agent CLI, such as Claude Code or Codex.
2. Select the agent in NeoStack AI.
3. Follow the setup prompt if Node.js, npx, or the agent CLI is missing.
4. Click Connect.

4. Start Prompting

Once connected, type a prompt and press Enter:

Create a Blueprint Actor called BP_Coin with:
- A StaticMeshComponent called Mesh
- A SphereComponent called CollisionSphere
- A float variable called PointValue set to 10

5. Review Tool Calls

The AI will execute tools to create your Blueprint. You’ll see:

• Tool calls with their arguments
• Permission requests for destructive operations
• Results showing what was created

6. Attach Context

For more accurate results, attach context to your prompts:

1. Right-click a Blueprint node in the graph editor
2. Select Attach to Agent Prompt
3. The node context will be included in your next message

Example Workflows

Create a Health System

Create a Blueprint Component called BPC_HealthComponent with:
- Float variable MaxHealth = 100
- Float variable CurrentHealth = 100
- Event dispatcher OnHealthChanged
- Event dispatcher OnDeath
- Function TakeDamage(float Amount) that reduces CurrentHealth and broadcasts events

Modify Existing Blueprint

Open BP_PlayerCharacter and:
- Add a SpringArm component attached to root
- Add a Camera component attached to the spring arm
- Set SpringArmLength to 300

Create AI Behavior

Create a Behavior Tree called BT_PatrolAndChase with:
- Selector at root
- Sequence for chasing (check if player visible, move to player)
- Sequence for patrolling (move to random point, wait 2 seconds)