Blueprint Interactions & Workflows

Ludus AI integrates directly with the Unreal Engine Editor to analyze, generate, and edit Blueprints in real-time. This deep integration allows for rapid prototyping and seamless translation between C++ and visual scripting.

These features require the Ludus Agent mode. Ensure you have selected the correct mode in the chat interface before beginning. Generating, editing and fixing blueprints also require following instructions from Beta Features Chapter to activate blueprints generation.

Analyzing Blueprints

Ludus can read the currently open Blueprint graph to understand its logic, context, and structure. This is useful for documenting legacy code, understanding complex systems, or debugging logic flows.

Workflow:
1. Open the Blueprint you want to analyze in the Unreal Engine Editor.
2. Open the Ludus AI Chat window.
3. Ensure the Agent mode is selected.
4. Ask Ludus to analyze the Blueprint or explain a specific section.
Example: "Explain how the movement logic in this Blueprint works."
Example: "Analyze this graph and tell me if there are any potential performance bottlenecks."
5. Output: Ludus will provide a detailed textual analysis or answer your specific question in the chat window.

Generating Blueprints from Scratch

(beta feature, activation required)

You can populate empty Blueprints with functional logic using natural language prompts. Ludus spawns and connects nodes in real-time.

Workflow:
1. Create a new, empty Blueprint Asset (or open a blank one) in your project.
2. Ensure the Blueprint graph is open and focused.
3. In chat (Agent mode), describe the functionality you want to create.
Example: "Create a basic character movement system with sprint and double jump."
4. Output: Ludus will begin spawning nodes, setting properties, and connecting wires directly in your graph. Watch the logic build itself in real-time.

Editing Existing Blueprints

(beta feature, activation required)

Ludus can modify existing logic to add features, tweak parameters, or refactor sections of your graph.

Workflow:
1. Open the existing Blueprint you wish to modify.
2. In the Ludus Chat, describe the specific changes you want to make.
3. Output: Ludus will modify the relevant nodes in real-time.

Pro Tip: Precision is Key
When editing existing complex Blueprints, be very specific in your prompt. Explicitly state what should be changed and, if necessary, what should remain untouched.
Good Prompt: "Update the 'Fire Weapon' event to consume 5 ammo instead of 1, but keep the sound effect logic exactly as it is."
Bad Prompt: "Fix the shooting." (This might lead to unwanted restructuring).

Converting Between C++ and Blueprints

(beta feature, activation required)

Ludus bridges the gap between scripting methods, allowing you to move logic between C++ and Blueprints easily.

Blueprint to C++
Convert visual logic into optimized C++ code.

1. Open the Blueprint you want to convert.
2. Ask Ludus: "Convert this Blueprint logic into C++ code. Include header and .cpp code if applicable."
3. Output: Ludus will generate the corresponding C++ header (.h) and source (.cpp) code (if applicable) directly in the chat window. You can then copy and paste this code into your IDE.

C++ to Blueprint
Rapidly prototype C++ logic visually.

1. Open the target Blueprint where you want the logic to appear.
2. Paste your C++ snippet into the Ludus Chat.
3. Prompt: "Convert this C++ code into Blueprint nodes."
4. Output: Ludus will interpret the code and generate the equivalent node structure in your open Blueprint graph.