1 Install NodeLens & the UE5 Plugin
โฌ๏ธ
Download and install the NodeLens app
Run the installer from releases.nodelens.io. Launch NodeLens and activate your license or start your free trial.
๐
Install the UE5 Plugin
Download the NodeLens plugin from the Fab marketplace and install it to your engine or project. Alternatively, copy the NodeLens plugin folder manually into your project's Plugins/ directory. Re-open your project โ you'll be prompted to compile the plugin. Click Yes.
โณ
Plugin pending Fab approval. The NodeLens UE5 plugin is currently under review on the Fab marketplace. Check back soon or follow us on X @nodelens_io for updates.
โ๏ธ
Configure the plugin
In Unreal Engine, go to Edit โ Project Settings โ Plugins โ NodeLens. Set the Project Name (this will be the folder name in your NodeLens Projects Directory) and the Server URL (default: http://localhost:7823).
โ
Verify the plugin is active
You should see a NodeLens button in the Blueprint editor toolbar. Make sure the NodeLens desktop app is running before you send anything.
2 Set up your Projects folder
NodeLens saves Blueprint data as plain .md files on your machine. Before you send anything, tell NodeLens where to store them.
โ๏ธ
Open Settings
Click the gear icon in the bottom-left of the NodeLens sidebar.
๐
Set your Projects Directory
Choose a folder on your machine where NodeLens will store all your Blueprint projects โ for example Documents\NodeLens Projects. You can change this at any time.
๐ก
Each UE5 project you send becomes its own subfolder inside this directory. All files are plain Markdown โ you can open them in any text editor or Obsidian.
3 Send a Blueprint from Unreal Engine
NodeLens plugs directly into UE5 โ no copy-paste required.
๐ฑ๏ธ
From the Blueprint editor toolbar
Open any Blueprint in Unreal Engine. Click the NodeLens button in the toolbar. The Blueprint is sent to NodeLens instantly.
๐ฆ
From the Content Browser (right-click)
Right-click any asset โ DataTable, Struct, Enum, Material, or DataAsset โ and choose NodeLens โ Send to NodeLens.
๐ก
The project name is set in the UE5 plugin settings (Edit โ Project Settings โ Plugins โ NodeLens). Make sure it matches an existing project in NodeLens, or NodeLens will create a new one automatically.
4 Explore the views
Once a Blueprint is loaded, you can switch between several views using the tab bar at the top of the viewer:
๐จ
Canvas
Interactive node graph โ drag nodes, zoom, pan, and inspect wire connections. The closest you can get to the Blueprint editor without opening UE5.
๐
Pseudocode
The Blueprint logic rendered as readable pseudocode. Great for understanding what a function does at a glance.
๐ณ
Exec Tree
A hierarchical view of the execution flow โ useful for tracing branches and loops.
๐
Notes (.md)
Every Blueprint gets a Markdown notes file. Add your own documentation, observations, or AI-generated summaries here. Changes are saved automatically.
5 Chat with AI about your Blueprints
The built-in AI chat lets you ask questions about your Blueprints in plain English. NodeLens sends your Blueprint context directly to your chosen AI provider โ no middleman.
๐
Add your API key
Open the chat panel (right side). Select your provider from the dropdown โ OpenAI, Claude, Grok, Gemini, or local Ollama. Paste your API key in Settings.
โ
Add Blueprint context
Click + Context in the viewer toolbar to attach the current Blueprint to your chat. The AI will receive it as structured context โ not raw node data.
๐ฌ
Ask anything
Examples: "What does the Add Item function do?" ยท "Is there a bug in this logic?" ยท "How would I add a stack limit check?"
๐
Your data stays yours. API calls go directly from your machine to your chosen provider. NodeLens never sees your Blueprint content or your API key.
6 Connect Claude via MCP
If you use Claude Desktop, you can connect NodeLens as an MCP server. This lets Claude read all your saved Blueprints directly โ no copy-paste, no context window limits.
๐
Open the Claude Desktop config file
The config file is located at %APPDATA%\Claude\claude_desktop_config.json. Open it in any text editor (e.g. Notepad). If the file doesn't exist, create it.
โ๏ธ
Add the NodeLens MCP entry
Paste the following inside the mcpServers object โ replace the path with the actual location of your NodeLens MCP server file:
{
"mcpServers": {
"nodelens": {
"command": "node",
"args": ["C:\\Users\\YourName\\AppData\\Local\\Programs\\NodeLens\\resources\\mcp-server\\index.js"]
}
}
}
โ
Save and restart Claude Desktop
After restarting, Claude will have access to all your NodeLens projects. You can ask it to read, analyze, or generate Blueprint logic across your entire codebase.
๐ก
MCP works best for cross-Blueprint analysis โ asking Claude to understand how multiple Blueprints interact, find patterns, or generate new logic based on your existing code style.
7 Load an existing NodeLens project
If you already have a NodeLens project folder from a previous install or another machine, you can load it in seconds.
๐
Use "Load Project from Folder"
Click the โ arrow icon next to the PROJECTS header in the sidebar. Select the root folder of your existing NodeLens project. NodeLens will scan it and import all Blueprints and notes automatically.
โ๏ธ
Or point to the same Projects Directory
If you're reinstalling NodeLens on the same machine, just set the Projects Directory in Settings to your existing folder โ everything will appear in the sidebar automatically.
8 Blueprint Data & Snapshots
NodeLens creates a structured snapshot of your Blueprints when you send them from Unreal Engine. These files represent the state of your Blueprint at that moment โ they are not a replacement for your Unreal project files.
โ ๏ธ
Always make Blueprint changes in Unreal Engine first. If you update a Blueprint and send it to NodeLens again, the new snapshot will replace the previous NodeLens data. Any manual edits made inside NodeLens will not be preserved.
AI-Generated Blueprint Changes
When using AI features (chat or MCP) to generate or modify Blueprint logic, always save the result to a new folder (for example, Fixes) โ never overwrite the original. This keeps your source Blueprint safe from accidental changes.
1๏ธโฃ
Review AI suggestions
Check the generated logic in NodeLens before applying anything.
2๏ธโฃ
Apply changes in Unreal Engine
Implement the changes manually in your UE5 project.
3๏ธโฃ
Send the updated Blueprint back to NodeLens
Re-send from UE5 to refresh the snapshot and keep NodeLens up to date.
Roadmap & Future Updates
NodeLens is actively developed and continuously improved. New Unreal Engine workflows, AI capabilities, and quality-of-life improvements are regularly added to make the workflow faster and more powerful.
๐ฃ
Follow @nodelens_io on X to stay up to date with the latest releases and features.
Ready to get started?
Download NodeLens and start understanding your Blueprints in minutes. 7-day free trial, no credit card required.
Download NodeLens