# Project Settings

Unity project configuration optimized for industrial automation with realvirtual framework.

## Overview

The Apply Standard Settings feature configures Unity projects with optimal settings for industrial automation development. These settings ensure the best performance, stability, and user experience when working with realvirtual components.

{% hint style="info" %}
**Automatic Application**: Standard settings are usually applied automatically after a fresh installation or update of realvirtual.io. However, if you encounter compile errors, you may need to apply them manually.
{% endhint %}

## When to Apply Settings Manually

### After Resolving Compile Errors

If you encounter compile errors in the console window, it may be due to conflicts between your existing project assets and realvirtual.io:

1. **Address compile errors first** to ensure there are none remaining
2. Once errors are resolved, apply the standard settings by selecting **"realvirtual" > "Apply Standard Settings"** from the main menu

### Manual Application

You can manually apply these settings at any time through the realvirtual menu:

1. Go to **realvirtual** menu in Unity's main menu bar
2. Select **"Apply Standard Settings"**
3. Confirm the application when prompted

<figure><img src="/files/9uNTHExq4x0SVXXkZpHl" alt="Recommended Project Settings Dialog"><figcaption><p>Dialog asking to apply standard realvirtual project settings for optimal automation configuration</p></figcaption></figure>

{% hint style="warning" %}
**Use Carefully for Existing Projects**: The Recommended Project Settings feature makes significant changes to Unity project configuration. Review the changes carefully before applying to existing projects.
{% endhint %}

## Settings Applied

Applying standard settings will configure:

* **Standard layer naming** (for physics)
* **Standard physics collision matrix**
* **Standard light settings**

<figure><img src="/files/mjjIzrn0AbHTlm6dYYOr" alt="Applied Settings Summary"><figcaption><p>Summary of successfully applied settings showing layers, scene view, build settings, physics, and performance optimizations</p></figcaption></figure>

### Additional Optimizations

The system also configures additional Unity settings for optimal industrial automation performance:

#### Project Structure

* **Layers & Collision Matrix**: Configured for automation components
* **Scene View Optimization**: Hierarchy collapsed, shaded mode enabled
* **UI Layer Management**: Hidden from Tools visibility for cleaner interface

#### Development Tools

* **Transform Tools**: Move tool active with Pivot/Local mode enabled
* **realvirtual Tools**: QuickEdit toolbar and overlay enabled
* **Script Icons**: Configured in Gizmos folder for better visual identification

#### Build & Runtime Settings

* **Build Settings**: Linear color space, Mono backend, .NET Standard 2.0
* **Physics Optimization**: 50Hz update rate with improved solver accuracy
* **Performance Settings**: VSync disabled, background execution enabled

## Detailed Logging

The Console provides detailed information about each change made during the configuration process:

<figure><img src="/files/Wjc7XV6dL0dTrUme3Qiw" alt="Console Log Details"><figcaption><p>Console log showing detailed information about each setting applied, including specific Unity menu paths</p></figcaption></figure>

The console log shows:

* Timestamped entries for each change
* Specific Unity menu paths for verification
* Confirmation of successful application
* Reference information for troubleshooting

## Benefits

### Performance Optimization

* **Physics Settings**: Optimized for industrial simulation accuracy
* **Rendering**: Linear color space for better visual quality
* **Background Execution**: Continuous operation when Unity loses focus

### Development Experience

* **Clean Interface**: Optimized tool visibility and organization
* **Efficient Workflow**: Pre-configured tools and shortcuts
* **Visual Clarity**: Better scene organization and component identification

### Industrial Automation Focus

* **Collision Management**: Proper layer setup for automation components
* **Precision**: Enhanced physics solver for accurate movement
* **Compatibility**: .NET Standard 2.0 for broader platform support

## See Also

* [Installation Guide](https://github.com/game4automation/doc/blob/doc/installation.md) - Complete installation process
* [Project Path Display](https://github.com/game4automation/doc/blob/doc/user-interface/project-path-display.md) - Toolbar project path feature
* [Quick Edit](https://github.com/game4automation/doc/blob/doc/user-interface/quick-edit.md) - Quick edit overlay menu


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.realvirtual.io/basics/project-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.