Develop

Unreal Project Setup Tool

Updated: Apr 14, 2026

The Unreal Project Setup Tool checks your project settings against a set of predefined rules and reports any issues. For each issue found, the tool can automatically apply the recommended fix, or you can review and address rules individually. This tool is included with the Meta XR Plugin.

Important: The Unreal Project Setup Tool was introduced in Meta XR Plugin v62.

Using the tool

To access the tool, navigate to Edit > Project Settings > Plugins > Meta XR > Launch Meta XR Project Setup Tool, or Meta XR Tools > Meta XR Project Setup Tool. The status icon in the bottom-right corner of the Editor also opens the tool. The icon color indicates project status: red if Critical rules are pending, yellow if only Warning or Performance rules remain, and green when all rules are applied.

This is the main panel on which all the rules are displayed, per target platform and organized by category and severity level. The panel displays outstanding issues alongside rules that have already passed or been ignored.

Rules

Each rule checks a single project setting and can automatically fix it when you select Apply. Rules are organized by category and severity.

Categories: Compatibility, Rendering, Quality, Physics, Plugins, Features, and Miscellaneous.

Severity levels:

Critical: Appear in the Required section. These rules address settings that must be correct for your project to build and run on Meta Quest.

Warning: Appear in the Recommended section. These rules address settings that improve compatibility or behavior.

Performance: Appear in the Recommended section. These rules address settings that affect runtime performance.

Actions

The following actions are available for this tool:

Target Group Tabs: Switch between target platforms — Link, Quest 2, Quest 3, and Quest Pro — to see the rules that apply to each.

Apply All: Applies all outstanding rules in the current section for the selected platform. Rules that are already applied, ignored, not applicable, or that require only manual resolution are skipped.

Under the Settings menu in the upper right, the following actions are available:

Enable background rule checks: Uncheck to stop the tool from automatically rechecking rule status every 30 seconds.

Stop build on unapplied items: Uncheck to allow building even when Critical (Required) rules have not been applied.