简介
Blueprint Bridge 是一个 UE 蓝图文本与简化 JSON 格式之间的双向转换器，专为 LLM 设计。它实现了约 10:1 的压缩比，使得将蓝图内容发送给 ChatGPT、Claude 或任何 LLM 进行分析和修改更加 practical。
可作为独立 Web 应用或嵌入式 UE 编辑器插件使用。完全在本地运行，无数据外传。
Overview
Blueprint Bridge is a bidirectional converter between Unreal Engine Blueprint text and a simplified JSON format designed for LLM consumption. It achieves approximately 10:1 compression, making it practical to send Blueprint content to ChatGPT, Claude, or any LLM for analysis and modification.
Available as a standalone web app or an embedded UE Editor plugin. Fully client-side — no data leaves your machine.
Documents:
Quick Start
Install as a UE Editor plugin:
1. Download and unzip the BlueprintBridge plugin folder.
2. Copy the entire BlueprintBridge folder into your UE project's Plugins folder:
YourProject/Plugins/BlueprintBridge/BlueprintBridge.uplugin
3. Open the UE project. If Unreal asks to compile the plugin, click Yes.
4. After the Editor opens, go to Tools → Blueprint Bridge.
5. In a Blueprint graph, select nodes and press Ctrl+C.
6. Paste the copied Blueprint text into Blueprint Bridge and click Parse.
7. Use the generated simplified JSON and LLM Prompt for analysis or modification.
8. For reverse conversion, paste simplified JSON into JSON → UE mode, click Parse, then copy the generated UE text back into the Blueprint Editor.
9. Inspect the pasted nodes manually. Reverse conversion is experimental and may require fixing broken or incomplete nodes, especially when referenced functions, variables, assets, classes, or node types do not already exist in the target project.
快速开始
作为 UE 编辑器插件安装：
1. 下载并解压 BlueprintBridge 插件文件夹。
2. 将整个 BlueprintBridge 文件夹复制到 UE 项目的 Plugins 目录：
YourProject/Plugins/BlueprintBridge/BlueprintBridge.uplugin
3. 打开 UE 项目。如果 Unreal 提示编译插件，点击 Yes。
4. 编辑器打开后，进入 Tools → Blueprint Bridge。
5. 在蓝图图表中选中节点并按 Ctrl+C。
6. 将复制出的蓝图文本粘贴到 Blueprint Bridge 中，点击 Parse。
7. 使用生成的简化 JSON 和 LLM Prompt 进行分析或修改。
8. 如需反向转换，将简化 JSON 粘贴到 JSON → UE 模式，点击 Parse，然后将生成的 UE 文本复制回蓝图编辑器。
9. 粘贴后请手动检查节点。反向转换是实验性功能，可能需要修复损坏或不完整的节点，特别是目标项目中不存在引用函数、变量、资源、类或节点类型时。
Features
Forward: UE Blueprint → JSON
Copy nodes in UE Blueprint Editor (Ctrl+C)
Paste into the left input panel
Click Parse (or Ctrl+Enter)
Interactive node graph appears in the center panel
Right panel outputs simplified JSON and LLM Prompt
Reverse: JSON → UE Blueprint
Switch to JSON → UE mode
Paste simplified JSON (from LLM output)
Click Parse — auto-laid-out node graph appears
Right panel outputs UE Blueprint text
Copy and paste back into UE Editor (Ctrl+V)
Important: Reverse conversion is experimental and is intended as an assisted reconstruction workflow, not a guaranteed one-click round trip. Generated Blueprint text may contain broken or incomplete nodes after pasting into UE. This is expected for cases such as functions, variables, classes, assets, or node types that do not already exist in the target project, or node metadata that cannot be fully reconstructed from simplified JSON. Use the plugin’s visual graph and diff highlighting to inspect the result, then manually create missing project elements or repair broken nodes in the UE Blueprint Editor.
Diff highlighting: Modified nodes show in yellow, new nodes show in green, making it easy to review LLM changes before manual fix-up.
Result in UE Editor
After pasting the generated UE text back into the Blueprint Editor, nodes appear in the graph. The reverse mode is experimental and may produce broken nodes that require manual fixing. This behavior is expected when the target project lacks referenced functions, variables, assets, classes, or other required Blueprint context.
LLM Workflow
The complete workflow for using Blueprint Bridge with an LLM:
Forward: Paste UE Blueprint text → get simplified JSON
Copy Prompt: Switch to "LLM Prompt" tab → copy the full prompt with format reference
Send to LLM: Paste into ChatGPT / Claude, describe desired changes
Reverse: Paste LLM response JSON into reverse mode → get UE Blueprint text for review
Paste back: Copy UE text → Ctrl+V in UE Blueprint Editor, then inspect and manually repair any broken or incomplete nodes if needed
Token Savings
The simplified JSON strips GUIDs, coordinates, full object paths, and pin metadata — achieving approximately 10:1 average compression.
Hot Keys
Shift: Highlight more nodes connected to the hovering node.
Control: Highlight all nodes on the execution line.