Skip to main content

📖 How to use Ludus

The Chat interface is the central command center for interacting with Ludus AI. Whether you are debugging complex C++ macros, seeking advice on system architecture, or commanding the Agent to inspect your scene, everything starts here.

Chat Modes​

Ludus provides two distinct levels of interaction, tailored to your subscription plan and current needs.

1. Agent Lite​

Availability: All Plans (including Free). Agent Lite is faster and cheaper than Agent, designed for quick answers and general assistance. Both Agent Lite and Agent share the same context awareness capabilities within the plugin.

  • Best for: Quick syntax checks, definitions of engine terms, and general programming logic.
  • Note: 3D model generation and Blueprint Analysis require a paid plan (Indie or higher). Blueprint Generation requires Pro or Enterprise. For complex C++ tasks, we recommend using Agent or MCP for best results.

2. Agent​

Availability: Indie, Pro, Enterprise, and Trial Plans. The Agent mode takes more time to process but delivers superior results for complex, multi-step tasks and in-depth problem solving. Both Agent and Agent Lite share the same context awareness capabilities within the plugin.

Key Capabilities in Chat​

(available for both Agent and Agent Lite in the plugin)

  • 👀 Vision & Context: Capture screenshots of your viewport or editor to understand your current scene composition.
  • 📂 Project Awareness: Automatically retrieves essential project details including the project name, directory paths, Engine version, plugins, modules, and target platforms.
  • 📄 Source Code Access: Read specific C++ source files or headers in your project to provide context-aware suggestions.
  • 🔍 Asset Intelligence: Search for assets by type, path, or query, and retrieve metadata (size, creation date, parent class) without needing to hunt through the Content Browser.
  • 🧊 3D Model Generation: Generate custom 3D models from text descriptions or uploaded images, placed directly into your scene.
  • 🔧 Blueprint Generation & Editing: Create, modify, and fix Blueprints using natural language.

Note: While the Chat is the interface for these commands, the specific workflows for generating assets and modifying code are detailed in their respective chapters:

Ways to Access Ludus​

Ludus AI is available wherever you work, but the capabilities differ based on your connection to the engine.

➡️ The Web Application​

Accessible via browser, the Web App is perfect for second-screen workflows or researching solutions while away from your workstation.

  • Supported Modes: Agent Lite and Agent (knowledge search only).
  • Limitations: The Web App provides access to the Ludus knowledgebase only. It cannot generate 3D models or Blueprints, communicate with your local Unreal Editor, see your scene, or read your local files.

➡️ The Unreal Engine Plugin​

The Plugin is the integrated experience that lives inside your editor.

  • Supported Modes: Agent Lite and Agent.
  • The Connected Experience: Only the plugin allows you to utilize Agent capabilities. When you ask a question in the Plugin, Ludus knows exactly which Blueprint is open, what assets are selected in the Content Browser, and the state of your current World Outliner.

➡️ The MCP​

Designed for developers who want Ludus AI's expertise directly within their favorite IDEs (Cursor, VS Code, Rider, and more).

  • Supported Modes: Agent Lite and Agent (knowledge search only, no project context).
  • Integrated Knowledge: You can provide it with any context—code files, terminal output, or specific questions—and it will respond using its deep knowledge of Unreal Engine and C++. It is great for your coding agents to get more insights into Unreal-specific things or do research.
  • Workflow: It functions similarly to the Web App but is integrated into your coding environment, allowing you to reference expert knowledge without leaving your IDE. It does not currently control the Unreal Editor instance directly.

The Ludus Difference: specialized AI vs. Generic LLMs​

While generic LLMs provide broad knowledge, Ludus is engineered specifically for game development in Unreal Engine.

1. Context Awareness A standard LLM does not know you are working on a VR project in UE 5.3 using a specific set of plugins. Ludus Agent scans your environment to ensure its answers are relevant to your exact engine version and project settings.

2. Grounded in Knowledge Ludus utilizes an intelligent ranking system to search our own proprietary Knowledgebase. It provides answers backed by authoritative sources rather than hallucinating API calls that don't exist.

3. Safety & Precision When assisting with tasks, Ludus is designed to "analyze before acting." It breaks complex requests into manageable steps and validates logic to prevent editor crashes - a safeguard generic chat bots cannot provide.