How does Atlas handle Unreal Engine's reflection system macros like UCLASS?

Atlas indexes Unreal Engine C++ code by AST declarations using tree-sitter, allowing it to understand and leverage `UCLASS`, `UPROPERTY`, and `UFUNCTION` macros as core API elements for semantic search and symbol navigation, providing a deep understanding of your codebase.

Can Atlas help me find where a specific UFUNCTION is called in my Unreal Engine project?

Yes, Atlas's `lsp` tool includes a `findReferences` operation that can locate every callsite of a `UFUNCTION` or any other C++ symbol within your Unreal Engine codebase, providing concrete file and line references for comprehensive analysis.

Does Atlas integrate with Unreal Build Tool (Build.cs) for dependencies?

Absolutely. Atlas reads and understands your `Build.cs` module rules and can even propose adding new module dependencies, ensuring correct project configuration before modifying C++ includes, a crucial step for Unreal Engine development.

How does Atlas ensure code style consistency with Unreal Engine's guidelines?

Atlas can apply the engine's `.clang-format` configuration to your C++ files, ensuring that any code it generates or modifies adheres to Epic Games' style guide, after you approve the changes, maintaining consistency across your Unreal Engine project.

Can Atlas run Unreal Automation Framework tests to verify behavior?

Yes, Atlas can draft and run `Unreal Automation Framework` tests through `UnrealEditor-Cmd`, behind a permission prompt, allowing you to verify behavior changes or new implementations directly within your Unreal Engine project's testing framework.

What if Atlas suggests a wrong file path in my Unreal Engine project?

Atlas's `read` tool fails loudly with "File not found" and a "Did you mean" list if a path is incorrect, preventing you from wasting time on non-existent files and guiding you efficiently to the correct Unreal Engine source location.

Is my Unreal Engine C++ code sent to third-party servers when using Atlas?

No, Atlas can build its code index with local Ollama embeddings, ensuring your Unreal Engine C++ code remains on your machine and off third-party servers, maintaining privacy and security for your proprietary game development.

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

To locate where a behavior is implemented in Unreal Engine, Atlas combines semantic code search, precise `grep` operations, and `lsp` symbol graph analysis, allowing developers in 2026 to pinpoint exact files and symbols without knowing the code's name. Atlas integrates directly with your Unreal Engine project structure, understanding `UCLASS` macros and `Build.cs` dependencies, and can even run `Unreal Automation Framework` tests to confirm behavior.

How does Atlas find Unreal Engine C++ behavior without exact keywords?

Atlas locates Unreal Engine C++ behavior by leveraging a hybrid semantic and keyword retrieval system, indexing code by AST declarations using tree-sitter. This allows developers in 2026 to describe a behavior in natural language, and Atlas will return relevant `UCLASS` or `UFUNCTION` declarations even if the exact words are not present in the source code.

Atlas's `codebase_search` tool is designed to understand the meaning behind your queries, not just exact text matches. For Unreal Engine C++ projects, this means Atlas can interpret descriptions of gameplay mechanics or system interactions and map them to the underlying `UCLASS`, `UPROPERTY`, or `UFUNCTION` macros that define the behavior. It builds its code index using AST declarations, ensuring a deep understanding of the code's structure. Furthermore, Atlas can build its code index with local Ollama embeddings, keeping your proprietary Unreal Engine C++ code off third-party servers and ensuring data privacy. This semantic understanding is crucial for navigating large Unreal Engine codebases where specific function names might not be immediately obvious from a high-level behavior description.

How to confirm Unreal Engine code locations with Atlas's grep tool?

After an initial semantic search, Atlas confirms Unreal Engine code locations using its `grep` tool, which wraps `ripgrep` for fast, precise text matching. This allows developers in 2026 to validate semantic results with a real regex, applying include and path filters to narrow down searches within specific `Source/` module folders or `.cpp` files.

While semantic search provides a powerful starting point, the `grep` tool offers the precision needed to confirm exact code locations within your Unreal Engine project. Atlas's `grep` functionality allows you to use real regular expressions to search for specific text patterns, variable names, or function calls. You can refine your search by applying include and path filters, for example, targeting only `*.cpp` files within a specific module's private directory like `Source/MyGameModule/Private/`. This combination of semantic and exact text search ensures that you can quickly narrow down potential locations and verify the presence of specific code snippets, even across thousands of Unreal Engine source files.

How does Atlas use LSP to navigate Unreal Engine C++ symbols?

Atlas integrates `lsp` tools to work through the Unreal Engine C++ symbol graph, providing powerful operations like `findReferences` and `workspaceSymbol`. This enables developers in 2026 to jump directly to a `UFUNCTION` or `UCLASS` declaration by name, or to see every callsite of a specific method, ensuring a comprehensive understanding of code flow.

Once you have identified a candidate file or symbol, Atlas's `lsp` tool becomes invaluable for deeper exploration within your Unreal Engine project. The `findReferences` operation can show you every location where a specific `UFUNCTION`, `UCLASS`, or C++ variable is used, providing a complete picture of its call path and dependencies. Conversely, `workspaceSymbol` allows you to jump directly to the declaration of any symbol by name, making it easy to navigate complex Unreal Engine C++ code. When you use the `read` tool to open a file, Atlas ensures that a wrong guess fails loudly with 'File not found' and a 'Did you mean' list, preventing wasted time on incorrect paths and guiding you to the correct Unreal Engine source file.

How does Atlas ensure safe code changes in Unreal Engine projects?

Atlas ensures safe code changes in Unreal Engine projects through a multi-stage approval process, starting with a read-only plan agent and culminating in a unified diff for every file edit. Before any code is written, developers in 2026 must approve the proposed changes, which Atlas can then format using the engine's `.clang-format` to match Epic's style guide.

Safety and control are paramount when modifying an Unreal Engine codebase. Atlas operates with a permission-gated system, where every tool call is checked against allow, ask, and deny rules. Initially, Atlas drafts a plan in a read-only plan agent, outlining its intended actions without making any modifications. Only after your explicit approval does it switch to a build agent. For every file edit, Atlas computes a unified diff and surfaces it for your review and approval before writing. This allows you to inspect every proposed change to your Unreal Engine C++ files, `Build.cs`, or configuration. Atlas can also apply the engine's `.clang-format` to ensure that any new or modified code adheres to the Epic Games style guide, maintaining consistency across your project.

What is the setup for Atlas in an Unreal Engine project?

Setting up Atlas for an Unreal Engine project involves running it within a directory containing a `.uproject` file and `Source/` module folders. Atlas automatically reads `UCLASS`, `UPROPERTY`, and `UFUNCTION` macros, along with dependencies declared in each `Build.cs` file, providing a robust understanding of your 2026 codebase from the start.

To get started with Atlas in your Unreal Engine development environment, simply run Atlas in the root directory of your project, where the `.uproject` file and `Source/` module folders reside. Atlas is designed to understand the unique structure of Unreal Engine projects. It automatically parses your C++ files, recognizing `UCLASS`, `UPROPERTY`, and `UFUNCTION` macros as core API elements. Crucially, Atlas also reads the dependencies declared in each `Build.cs` file, which is vital for correct compilation and linking in Unreal Engine. When Atlas needs to add a new dependency, it will first ask to modify the `Build.cs` file, a step often missed by generic C++ agents, ensuring your project's module rules are correctly updated before any includes are added to your C++ source files.

Step by step

01Describe the behavior you want to locate in your Unreal Engine project using natural language: `atlas codebase_search "find where the character's sprint ability is implemented"`
02Confirm the semantic results with a precise text search using `grep`, specifying Unreal Engine file types and paths: `atlas grep "Sprint" --include="*.cpp" --path="Source/MyGameModule/Private/"`
03Open the most promising candidate file to inspect its contents: `atlas read Source/MyGameModule/Private/MyCharacter.cpp`
04Use the `lsp` tool to find all references to a specific `UFUNCTION` or `UCLASS` within your Unreal Engine codebase: `atlas lsp findReferences "AMyCharacter::Sprint"`
05Alternatively, jump directly to a symbol's declaration by name using `lsp workspaceSymbol`: `atlas lsp workspaceSymbol "AMyCharacter::Sprint"`
06Summarize the call path or implementation details back to you with concrete file and line references: `atlas summarize "Explain the call path for the Sprint ability in MyCharacter.cpp"`
07If modifications are needed, ask Atlas to add a module dependency in `Build.cs` before adding includes: `atlas ask "add a module dependency for 'GameplayTags' in MyGameModule.Build.cs"`
08Approve the diff for any proposed changes, then let Atlas apply the engine's `.clang-format` to maintain Epic's style guide: `atlas ask "apply the engine .clang-format to MyCharacter.cpp"`

Frequently asked questions

How does Atlas handle Unreal Engine's reflection system macros like UCLASS?: Atlas indexes Unreal Engine C++ code by AST declarations using tree-sitter, allowing it to understand and leverage `UCLASS`, `UPROPERTY`, and `UFUNCTION` macros as core API elements for semantic search and symbol navigation, providing a deep understanding of your codebase.
Can Atlas help me find where a specific UFUNCTION is called in my Unreal Engine project?: Yes, Atlas's `lsp` tool includes a `findReferences` operation that can locate every callsite of a `UFUNCTION` or any other C++ symbol within your Unreal Engine codebase, providing concrete file and line references for comprehensive analysis.
Does Atlas integrate with Unreal Build Tool (Build.cs) for dependencies?: Absolutely. Atlas reads and understands your `Build.cs` module rules and can even propose adding new module dependencies, ensuring correct project configuration before modifying C++ includes, a crucial step for Unreal Engine development.
How does Atlas ensure code style consistency with Unreal Engine's guidelines?: Atlas can apply the engine's `.clang-format` configuration to your C++ files, ensuring that any code it generates or modifies adheres to Epic Games' style guide, after you approve the changes, maintaining consistency across your Unreal Engine project.
Can Atlas run Unreal Automation Framework tests to verify behavior?: Yes, Atlas can draft and run `Unreal Automation Framework` tests through `UnrealEditor-Cmd`, behind a permission prompt, allowing you to verify behavior changes or new implementations directly within your Unreal Engine project's testing framework.
What if Atlas suggests a wrong file path in my Unreal Engine project?: Atlas's `read` tool fails loudly with "File not found" and a "Did you mean" list if a path is incorrect, preventing you from wasting time on non-existent files and guiding you efficiently to the correct Unreal Engine source location.
Is my Unreal Engine C++ code sent to third-party servers when using Atlas?: No, Atlas can build its code index with local Ollama embeddings, ensuring your Unreal Engine C++ code remains on your machine and off third-party servers, maintaining privacy and security for your proprietary game development.

Try Atlas in your terminal

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

Install Atlas

Related guides

Locate Where a Behavior Is Implemented with Atlas in 2026

How to locate where a behavior is implemented with Atlas in 2026: codebase_search for meaning, grep for exact text, and the lsp tool for the symbol graph.

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.

Write Unit Tests for Untested Unreal Engine Code with Atlas in 2026

Learn how Atlas helps Unreal Engine developers in 2026 write unit tests for existing modules. Atlas integrates with Unreal Automation Framework, Build.cs, and clang-format.

Rename a symbol across the repo in Unreal Engine with Atlas in 2026

Efficiently rename C++ functions, classes, or constants across your Unreal Engine 5.x project in 2026 using Atlas. Leverage LSP, grep, and automated diffs for precise, safe refactoring.

Run the test suite and triage the failures in Unreal Engine with Atlas in 2026

Run and triage Unreal Engine test suite failures with Atlas in 2026. Transform red output from Unreal Automation Framework into prioritized root causes, streamlining C++ development.

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.

Run Atlas Headless in CI for Unreal Engine in 2026

Automate Atlas sessions in your Unreal Engine CI/CD pipelines. Get machine-readable output, manage dependencies with Build.cs, and format code with clang-format.

Browse this resource hub