Getting Started

Get CodeScape running in your Unreal Engine project in under 5 minutes.

Installation

Download the plugin

Download CodeScape from the downloads page or the Epic Games FAB Marketplace. You'll receive a .zip file containing the plugin.

Copy to your project

Extract the archive and copy the CodeScape folder into your project's Plugins/ directory.

YourProject/
  Plugins/
    CodeScape/
      CodeScape.uplugin
      Source/
      Resources/

Enable the plugin

Open your project in Unreal Engine 5.7+, go to Edit → Plugins, search for "CodeScape" and enable it. Restart the editor when prompted.

Configure your AI provider

Open Edit → Project Settings → CodeScape and enter your API key for at least one provider. Or use Ollama for free local inference.

Requirements: Unreal Engine 5.7+, Windows 10/11, Visual Studio 2022 (for source builds). CodeScape is an editor-only plugin with zero runtime impact.

Your First Tool

Once installed, open any Blueprint editor and look for the CodeScape chat panel docked on the right side. Type a natural language command:

you > Create a health component with max health 100, take damage function, and death event

CodeScape will analyze your request, select the appropriate tools (CreateBlueprint, AddVariable, CompileDSL), and generate a complete Blueprint with variables, functions, and event dispatchers — all with proper node layout.

Session Modes

Floating panel: Access from the CodeScape toolbar button in any editor window
Docked panel: Automatically embedded in Blueprint, Material, Widget, AnimBP, and BehaviorTree editors
MCP client: Use Claude Desktop, Cursor, or any MCP-compatible tool to access CodeScape remotely

Tool Reference

Browse all 321 tools organized by category. Use the search bar to find specific tools.

Blueprints 34 tools

Create, edit, compile and analyze Blueprint graphs with AI-driven node generation and auto-layout.

CreateBlueprint AddComponent AddVariable AddFunction AddEvent CompileDSL AnalyzeBlueprint RefactorBlueprint ValidateBlueprint CompareBlueprints TraceFlow AutoLayout +19 more

Materials 8 tools

Generate PBR materials, master materials, material instances and complex shader graphs.

CreatePBRMaterial CreateMasterMaterial CreateMaterialInstance ImportTextures AnalyzeMaterial BatchMaterials +2 more

Level Design 22 tools

Spawn actors, configure lighting, organize outliners, audit performance and manipulate terrain.

SpawnActor BatchSpawn ConfigureLighting SetCollision OrganizeOutliner PerformanceAudit +10 more

Sequencer & Cinematics 14 tools

Create level sequences, camera rigs, tracks, keyframes and cinematic shot presets.

CreateLevelSequence CreateCameraRig AddTrack AddKeyframes SetFocalLength CinematicShot +6 more

Niagara VFX 5+ tools

Create particle systems with presets for fire, smoke, rain, magic and custom emitters.

CreateNiagaraSystem CreateNiagaraPreset ConfigureEmitter AnalyzeNiagara +more

Animation 10+ tools

Build state machines, blend spaces, montages, motion matching and IK systems.

CreateStateMachine CreateBlendSpace CreateMontage ConfigureIK MotionMatching +more

Audio & MetaSounds 14 tools

Place ambient sounds, configure spatial audio, sound mixes, and procedural MetaSound patches.

PlaceAmbientSound ConfigureSpatialAudio CreateSoundMix SetAttenuation CreateMetaSound +more

AI & Gameplay 26+ tools

Behavior trees, AI perception, NavMesh, EQS, Gameplay Abilities, Enhanced Input, State Trees, Smart Objects.

CreateBehaviorTree ConfigurePerception SetupNavMesh CreateEQS CreateAbility ConfigureInput CreateStateTree +more

World Building & PCG 22+ tools

Procedural structures, PCG graphs, geometry scripting, landscape sculpting, water systems, foliage.

GenerateStructure CreatePCGGraph CreateDynamicMesh SculptLandscape ConfigureWater PlaceFoliage +more

Physics & Chaos 8 tools

Rigid bodies, constraints, Chaos destruction, vehicle setup, cloth simulation.

ConfigureRigidBody AddConstraint FractureGeometry CreateVehicle ConfigureCloth +more

Rendering & Graphics 15 tools

Configure Lumen GI, Nanite, Virtual Shadow Maps, TSR, Ray Tracing, Pixel Streaming.

ConfigureLumen EnableNanite SetupVSM ConfigureTSR EnableRayTracing +more

Asset Management & Infrastructure 29+ tools

Find, rename, validate, audit assets. Data structures, editor utilities, Mass Entity configuration.

FindAsset RenameAsset ValidateAssets AuditDependencies CreateStruct CreateEnum CreateDataTable +more

AI Providers

CodeScape supports 10 AI providers (9 cloud + Ollama local). Configure one or more in Project Settings → CodeScape.

Google Gemini

Gemini offers excellent multi-modal capabilities with image understanding. A free tier is available for experimentation.

Provider: Gemini
API Key: Your Google AI Studio key
Model: gemini-2.5-flash (recommended) or gemini-2.5-pro
Vision: Supported

OpenAI

The industry-standard large language model with broad knowledge of game development patterns.

Provider: OpenAI
API Key: Your OpenAI API key
Model: gpt-4.1-mini (recommended), gpt-4o, or o4-mini
Vision: Supported

Anthropic Claude

Claude excels at complex reasoning and understanding nuanced instructions. Large context window for complex projects.

Provider: Claude
API Key: Your Anthropic API key
Model: claude-haiku-4-5 (recommended), claude-sonnet-4-6, or claude-opus-4-6
Vision: Supported

DeepSeek

High-performance open model with excellent code generation capabilities at competitive pricing.

Provider: DeepSeek
API Key: Your DeepSeek API key
Model: deepseek-chat or deepseek-reasoner
Vision: Not supported

MiniMax

Specialized generation model for creative and structured content tasks.

Provider: MiniMax
API Key: Your MiniMax API key
Model: MiniMax-M2.7 (recommended)
Vision: Not supported

Groq

Ultra-fast inference on open-source models (Llama, Qwen). Ideal when response latency matters.

Provider: Groq
API Key: Your Groq API key
Model: llama-3.3-70b-versatile (recommended), llama-3.1-8b-instant, or qwen/qwen-3-32b
Vision: Not supported

Mistral AI

European LLM provider with strong multilingual support and the Codestral model tuned for code.

Provider: Mistral
API Key: Your Mistral API key
Model: mistral-small-latest (recommended), mistral-large-latest, or codestral-latest
Vision: Limited

Cohere

Enterprise-grade LLM with a strong focus on retrieval-augmented generation and command-style models.

Provider: Cohere
API Key: Your Cohere API key
Model: command-a-03-2025 (recommended) or command-a-reasoning-08-2025
Vision: Not supported

xAI Grok

xAI's Grok family — reasoning-first models with long context and tool use.

Provider: Grok
API Key: Your xAI API key
Model: grok-4 (recommended), grok-4.1-fast, or grok-3-mini
Vision: Supported

Ollama (Local)

Run AI models completely locally on your machine. No API key needed, no internet required. Full privacy for sensitive projects.

Provider: Ollama
Endpoint: http://localhost:11434 (default)
Model: llama3.1, codellama, mistral, or any Ollama model
Cost: Free

Tip: Install Ollama from ollama.ai, then run ollama pull llama3.1 to download a model. CodeScape will detect it automatically.

MCP Integration

Access all 321 CodeScape tools from external AI clients via the Model Context Protocol.

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI models to external tools. CodeScape includes a native C++ MCP server that exposes all tools via JSON-RPC 2.0 over TCP.

Connecting Claude Desktop

Enable MCP in CodeScape

Go to Project Settings → CodeScape → MCP Server and enable it. Default port is 8765.

Configure your MCP client

Add CodeScape to your client's MCP configuration. For Claude Desktop, edit claude_desktop_config.json:

{
  "mcpServers": {
    "codescape": {
      "command": "path/to/CodeScapeMCP.exe",
      "args": []
    }
  }
}

Start using tools

All 321 tools are now available to your AI client. Ask it to create Blueprints, materials, or any other UE5 asset.

Architecture

CodeScape is built as a pure C++20 Unreal Engine plugin with zero external dependencies.

Pipeline Overview

Input

Natural language via chat panel or MCP client

↓

Reformulation

AI enriches request with UE5 context and asset state

↓

AI Provider

Dynamic 40KB+ system prompt sent to selected provider

↓

Extraction

Tool calls parsed from response (JSON + fallback scan)

↓

Dispatch

O(1) TMap lookup routes to correct tool among 321

↓

Execution

Native UE5 C++ execution with FScopedTransaction undo support

Key Stats

175,000+

Lines of C++

793

Source files

60+

Module dependencies

20+

Test suites

NodeForge Compiler

CodeScape's advanced Blueprint compiler converts DSL descriptions into production-ready node graphs.

13-Phase Layout Engine

Topology scan
Execution column assignment (layering)
Spanning forest construction
Pin geometry estimation
Anchor-based Y assignment
Cluster identification
Overlap resolution (sweeping)
Exec wire straightening
Re-resolve post-straightening
Data node anchoring
Global overlap resolution
Reroute nodes for collision avoidance
Comment containment refit

Result: Clean, readable Blueprint graphs with proper node spacing, reroute nodes for wire clarity, and comment blocks that fit their contents. No manual cleanup needed.

FAQ

Does CodeScape affect my game's runtime performance?

No. CodeScape is an editor-only plugin. It generates standard UE5 assets (Blueprints, Materials, etc.) that run natively. Zero runtime overhead.

Can I use generated assets in commercial games?

Yes. All assets generated by CodeScape are standard UE5 assets that you own completely. No licensing restrictions on generated content.

How does the auto-backup work?

Before any tool modifies an asset, CodeScape creates a serialized backup. Combined with FScopedTransaction support, every operation can be undone with Ctrl+Z.

Can multiple team members use CodeScape simultaneously?

Yes. Each developer uses their own API keys and runs CodeScape independently. Assets are generated locally and can be committed to version control as usual.