How does Atlas understand Unreal Engine's specific C++ syntax and macros?

Atlas uses tree-sitter to parse the Abstract Syntax Tree (AST) of Unreal Engine C++ code, specifically recognizing UCLASS, UPROPERTY, and UFUNCTION macros. This allows it to build a semantic index that understands the engine's reflection system and module dependencies declared in Build.cs files.

Can Atlas help me understand Build.cs files and module dependencies in Unreal Engine?

Yes, Atlas can read and interpret Build.cs files, which are crucial for Unreal Build Tool. It understands how modules declare dependencies and can even propose adding new module dependencies, ensuring the correct order before adding includes.

How does Atlas ensure it doesn't accidentally modify my Unreal Engine project while I'm exploring?

Atlas employs a read-only plan agent and permission-gated tool calls. The explore subagent, specifically designed for wide sweeps, operates with a deny-by-default permission set, only allowing tools like grep and read to prevent any unintended changes to your .uproject or source files.

Does Atlas support Unreal Engine's clang-format style guide?

Absolutely. Atlas can apply the engine's .clang-format configuration to any C++ code it modifies or generates, ensuring that your project adheres to the Epic style guide and maintains consistent formatting.

How can I trace UFUNCTION or UCLASS definitions across different Unreal Engine modules with Atlas?

Atlas integrates with the Language Server Protocol (LSP). You can use the lsp tool's goToDefinition operation to precisely navigate from a UFUNCTION call or UCLASS usage to its definition, even if it resides in a different Source/ module.

What if I need to search for a specific UPROPERTY usage across the entire Unreal Engine codebase?

You can delegate this task to the explore subagent using `atlas task explore "grep -r UPROPERTY Source/"`. This will perform a comprehensive, read-only search across all Source/ directories, providing you with all instances of UPROPERTY usage.

Onboard to an Unfamiliar Unreal Engine Codebase with Atlas in 2026

Atlas helps Unreal Engine developers in 2026 rapidly build a working mental model of unfamiliar codebases by leveraging semantic search, analyzing Build.cs module rules, and integrating with the Unreal Automation Framework and clang-format for a complete workflow.

How Atlas builds a mental model of Unreal Engine code

In 2026, Atlas helps you understand an unfamiliar Unreal Engine codebase by starting from meaning, not just filenames. It uses a hybrid semantic and keyword retrieval system to index your C++ code, focusing on UCLASS, UPROPERTY, and UFUNCTION macros to build a rich understanding of the engine's reflection system.

When you encounter a new Unreal Engine project, Atlas begins by indexing its C++ source files, paying special attention to the unique macro-driven architecture. Instead of relying on blind line windows, Atlas uses tree-sitter to parse the Abstract Syntax Tree (AST) declarations, allowing it to understand the relationships between UCLASS definitions, UPROPERTY declarations, and UFUNCTION implementations. This deep understanding of Unreal Engine's reflection system means that when you ask codebase_search a plain-language question, such as "how requests are authenticated," Atlas queries its semantic index and returns highly ranked snippets directly relevant to the engine's specific patterns, like UFUNCTIONs exposed to blueprints or USTRUCTs used for data serialization. This approach ensures that the initial insights you gain are rooted in the actual design patterns of Unreal Engine.

Exploring Unreal Engine project structure with Atlas

Understanding the physical layout of an Unreal Engine project is crucial, and Atlas helps you achieve this in under 5 minutes. After an initial semantic search, you can use the glob tool to quickly map the top-level directories, revealing the Source/ module folders and the central .uproject file that defines the project's structure.

Once Atlas has provided initial semantic insights, the next step in building a mental model of an Unreal Engine codebase is to understand its physical organization. The glob tool allows you to inspect the top-level directories and files, immediately highlighting key Unreal Engine artifacts like the .uproject file and the Source/ directory, which typically contains all C++ modules. This helps you quickly identify the naming conventions and module structure, such as Source/MyGameModule/ or Source/ThirdPartyPlugin/. Following this, you can use the read tool to inspect critical files like the main .uproject file or specific Build.cs files within Source/ directories. These Build.cs files, managed by Unreal Build Tool, declare module dependencies and build settings, providing concrete information about how different parts of the Unreal Engine project are interconnected. This combination of semantic understanding and structural mapping provides a robust foundation for further exploration.

Deep diving into Unreal Engine code with Atlas and LSP

To truly grasp the intricate dependencies within an Unreal Engine codebase, Atlas integrates with the Language Server Protocol (LSP) to provide precise navigation. After reading the 2 or 3 files codebase_search ranked highest, you can use the lsp tool's goToDefinition operation to follow UCLASS inheritance chains or trace UPROPERTY usage across modules.

After gaining initial semantic and structural understanding, Atlas enables a deep dive into specific Unreal Engine code paths using its lsp tool. Once you've identified the most relevant files from codebase_search and read them, you can leverage lsp's goToDefinition functionality. This is particularly powerful in Unreal Engine, where UCLASS macros define complex inheritance hierarchies and UPROPERTY declarations link C++ code to the editor's reflection system. You can direct navigate from a UFUNCTION call to its definition, or from a UPROPERTY declaration to its usage in a Blueprint-exposed class. Atlas understands the nuances of Unreal Engine's C++ syntax, including the reflection macros, ensuring that goToDefinition accurately resolves symbols even across different Source/ modules and their Build.cs dependencies. This allows you to build a precise mental model of how specific features are implemented and interconnected within the engine.

Delegating wide sweeps and ensuring safety in Unreal Engine

For broader investigations across an unfamiliar Unreal Engine codebase, Atlas offers the explore subagent, which operates with a deny-by-default permission set, ensuring safety. This subagent can perform wide sweeps, like grepping for specific UFUNCTION signatures or UPROPERTY usage patterns, without making any modifications to your project files, typically completing its task in under 10 seconds.

When you need to perform a wide-ranging search or analysis across an Unreal Engine project without the risk of accidental modifications, Atlas's explore subagent is invaluable. You can delegate tasks to it using the task tool, defining its scope and permissions. The explore subagent is configured with a deny-by-default permission set, allowing it only to use tools like grep, glob, read, bash, webfetch, and websearch. This means it can, for example, grep for all instances of a specific UFUNCTION macro across all Source/ directories, or glob for all Build.cs files to understand module dependencies, without ever being able to write to your .uproject or C++ source files. This read-only capability is critical for safely exploring large and complex Unreal Engine codebases, providing comprehensive insights while maintaining the integrity of your project.

Recording findings and maintaining Unreal Engine code style

As you build your mental model of an Unreal Engine codebase, Atlas helps you consolidate your learning and maintain code quality. You can use the todowrite tool to record open questions or insights, ensuring that your discoveries are preserved for future turns, and Atlas can apply the engine's clang-format rules, often reducing formatting review time by 20%.

Effective onboarding isn't just about understanding; it's also about documenting your journey and ensuring future contributions adhere to established standards. As you uncover key architectural patterns, UCLASS hierarchies, or Build.cs module interactions, you can use the todowrite tool to create a persistent list of open questions, observations, or tasks. This ensures that your evolving mental model is captured and accessible. Furthermore, when Atlas proposes any code modifications, such as adding a new module dependency to a Build.cs file or implementing a new UFUNCTION, it computes a unified diff for every file edit and surfaces it for your approval. Before writing, Atlas can also apply the engine's .clang-format rules, ensuring that any new or modified C++ code adheres to the Epic style guide, maintaining consistency across the Unreal Engine project. This comprehensive approach supports both learning and high-quality code contributions.

Step by step

01Ask Atlas about core concepts: Start by asking `atlas codebase_search "how requests are authenticated"` to understand key UFUNCTIONs or UCLASSes involved in an Unreal Engine project's authentication flow.
02Map the project structure: Run `atlas glob "Source/*"` to visualize the Source/ module directories and identify Build.cs files, understanding the project's Unreal Build Tool structure.
03Read critical files: Use `atlas read "Source/MyGame/MyGame.Build.cs"` and `atlas read "MyProject.uproject"` to inspect module dependencies and project settings.
04Deep dive with LSP: Select a UCLASS or UFUNCTION from the codebase_search results and use `atlas lsp goToDefinition` to trace its implementation across Unreal Engine C++ files.
05Explore widely with subagents: Delegate a broad search for UPROPERTY usage patterns with `atlas task explore "grep -r UPROPERTY Source/"`, ensuring read-only safety.
06Record your findings: Use `atlas todowrite "Investigate why MyModule.Build.cs depends on ThirdPartyPlugin"` to capture open questions about Unreal Build Tool configurations.
07Approve code changes and format: If Atlas proposes a Build.cs modification, review the unified diff, then approve it, letting Atlas apply the engine's .clang-format rules.

Frequently asked questions

How does Atlas understand Unreal Engine's specific C++ syntax and macros?: Atlas uses tree-sitter to parse the Abstract Syntax Tree (AST) of Unreal Engine C++ code, specifically recognizing UCLASS, UPROPERTY, and UFUNCTION macros. This allows it to build a semantic index that understands the engine's reflection system and module dependencies declared in Build.cs files.
Can Atlas help me understand Build.cs files and module dependencies in Unreal Engine?: Yes, Atlas can read and interpret Build.cs files, which are crucial for Unreal Build Tool. It understands how modules declare dependencies and can even propose adding new module dependencies, ensuring the correct order before adding includes.
How does Atlas ensure it doesn't accidentally modify my Unreal Engine project while I'm exploring?: Atlas employs a read-only plan agent and permission-gated tool calls. The explore subagent, specifically designed for wide sweeps, operates with a deny-by-default permission set, only allowing tools like grep and read to prevent any unintended changes to your .uproject or source files.
Does Atlas support Unreal Engine's clang-format style guide?: Absolutely. Atlas can apply the engine's .clang-format configuration to any C++ code it modifies or generates, ensuring that your project adheres to the Epic style guide and maintains consistent formatting.
How can I trace UFUNCTION or UCLASS definitions across different Unreal Engine modules with Atlas?: Atlas integrates with the Language Server Protocol (LSP). You can use the lsp tool's goToDefinition operation to precisely navigate from a UFUNCTION call or UCLASS usage to its definition, even if it resides in a different Source/ module.
What if I need to search for a specific UPROPERTY usage across the entire Unreal Engine codebase?: You can delegate this task to the explore subagent using `atlas task explore "grep -r UPROPERTY Source/"`. This will perform a comprehensive, read-only search across all Source/ directories, providing you with all instances of UPROPERTY usage.

Try Atlas in your terminal

The terminal-native AI coding agent. Free core, single binary.

Install Atlas

Related guides

Onboard to an Unfamiliar Codebase with Atlas in 2026

How to onboard to an unfamiliar codebase with Atlas in 2026: use codebase_search, glob, read, lsp, task, and todowrite to build a mental model fast.

Atlas for Unreal Engine: Terminal-Native AI Coding for UCLASS and Build.cs in 2026

Atlas is a terminal-native AI coding agent for Unreal Engine C++ in 2026, where UCLASS macros, the reflection system, and Build.cs module rules are the real API.

Automate GitHub issue and pull request triage in Unreal Engine with Atlas in 2026

Automate GitHub issue and pull request triage for Unreal Engine projects with Atlas in 2026. Safely respond to events, manage dependencies with Unreal Build Tool (Build.cs), and format code with clang-format, ensuring

Refactor a Legacy Unreal Engine Module in 2026 with Atlas

Learn how Atlas helps Unreal Engine developers refactor legacy C++ modules in 2026. Safely restructure code, manage dependencies with Build.cs, and verify behavior with Unreal Automation Framework.

Locate where a behavior is implemented in Unreal Engine with Atlas in 2026

Pinpoint Unreal Engine C++ behavior implementations with Atlas. Use semantic search, grep, and LSP tools to find exact files and symbols in your 2026 projects, integrating with Build.cs and clang-format.

Self-review your working diff before committing in Unreal Engine with Atlas in 2026

Catch your own mistakes in Unreal Engine C++ code before committing with Atlas. Review uncommitted diffs, run Unreal Automation Framework tests, and apply clang-format for Epic style.

Document a Module README in Unreal Engine with Atlas in 2026

Learn how Atlas, the terminal-native AI coding agent, helps Unreal Engine developers in 2026 generate accurate README documentation for modules by analyzing UCLASS, UFUNCTION, and Build.cs files.

Upgrade a Dependency and Fix the Breakage in Unreal Engine with Atlas in 2026

Upgrade Unreal Engine dependencies in 2026 with Atlas. Automate Unreal Build Tool (Build.cs) updates, fix C++ compile errors, and run Unreal Automation Framework tests. Atlas ensures safe, approved code changes and Epic

Browse this resource hub