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 three distinct levels of interaction, tailored to your subscription plan and current needs.

1. Ludus Lite​

Availability: All Plans. Ludus Lite is a specialized knowledge base restricted strictly to Unreal Engine and C++ programming questions. It is designed for quick answers and does not have access to your project internals or editor tools.

  • Best for: Quick syntax checks, definitions of engine terms, and general programming logic.
  • Limitations: Cannot provide lists of internal toolsets and has no awareness of your specific project context.

2. Ludus Full​

Availability: Trial, Indie, Pro and Enterprise Plans. This mode offers deep engine knowledge, capable of explaining complex systems, architecture, and best practices. It searches through our proprietary knowledgebase to provide cited, accurate information and help troubleshoot difficult bugs.

  • Best for: System design, complex debugging, code examples, and architectural guidance.

3. Ludus Agent​

Availability: Indie, Pro, Enterprise, and Trial Plans. Available in Plugin only. The Agent mode connects the AI directly to your Unreal Editor. It transforms the chat from a passive knowledge base into an active assistant that can "see" and "read" your project files.

Key Agent Capabilities in Chat:

  • 👀 Vision & Context: The Agent can capture screenshots of your viewport or editor to understand your current scene composition.
  • 📂 Project Awareness: It automatically retrieves essential project details including the project name, directory paths, Engine version, plugins, modules, and target platforms.
  • 📄 Source Code Access: You can ask the Agent to read specific C++ source files or headers in your project to provide context-aware suggestions.
  • 🔍 Asset Intelligence: The Agent can search for assets by type, path, or query, and retrieve metadata (size, creation date, parent class) without you needing to hunt through the Content Browser.

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: Ludus Lite, Ludus Full.
  • Limitations: The Web App cannot communicate with your local Unreal Editor. It cannot see your scene, read your local files, or execute Agent commands.

➡️ The Unreal Engine Plugin​

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

  • Supported Modes: Ludus Lite, Ludus Full, and Ludus 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: Ludus Lite, Ludus Full
  • 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.