# Folder structure

{% hint style="info" %}
Starting with version **6.3**, realvirtual is distributed as **UPM (Unity Package Manager) packages**. The folder structure changed significantly from the previous `Assets/realvirtual/` layout used in 6.0 and earlier.
{% endhint %}

## Package Overview

<figure><img src="https://260262196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpYxFg97YnJX96UzNNTSd%2Fuploads%2Fgit-blob-4464657e73a43a6e0c08289a12b65fc2c1852985%2Ffolder-structure.png?alt=media" alt=""><figcaption><p>realvirtual UPM package structure</p></figcaption></figure>

realvirtual is split into two UPM packages:

| Package                         | Location                                | Description                                                           |
| ------------------------------- | --------------------------------------- | --------------------------------------------------------------------- |
| **io.realvirtual.starter**      | `Packages/io.realvirtual.starter/`      | Core framework — drives, sensors, signals, transport, gripping, logic |
| **io.realvirtual.professional** | `Packages/io.realvirtual.professional/` | Professional add-on — IK, CADLink, interfaces, multiplayer, and more  |

{% hint style="warning" %}
UPM packages are **read-only** in Unity. You cannot edit files inside `Packages/`. Place your own scenes, scripts, and assets in the `Assets/` folder.
{% endhint %}

## Starter Package Layout

The Starter package (`Packages/io.realvirtual.starter/`) contains:

| Folder                  | Description                                                                                                                             |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Assets/**             | User-facing assets you drag into scenes                                                                                                 |
| Assets/3DPrefabs/       | Industrial 3D models (conveyors, robots, boxes, fences)                                                                                 |
| Assets/Materials/       | Industrial materials (plastics, metals, lamp indicators)                                                                                |
| Assets/Prefabs/         | Core functional prefabs (realvirtual.prefab, signal prefabs, interfaces)                                                                |
| Assets/UIPrefabs/       | Runtime UI overlay prefabs                                                                                                              |
| Assets/Settings/        | Editor gizmo options, camera presets                                                                                                    |
| Assets/RenderPipelines/ | URP pipeline configuration and settings                                                                                                 |
| **Runtime/**            | All runtime C# scripts (components, behaviors, interfaces)                                                                              |
| **Editor/**             | Editor tools, inspectors, and toolbar                                                                                                   |
| **Samples\~/**          | Demo scenes — import via [Demo Scenes Browser](https://doc.realvirtual.io/basics/user-interface/demo-scenes-browser) or Package Manager |

## Professional Package Layout

The Professional package (`Packages/io.realvirtual.professional/`) contains:

| Folder                   | Description                                                                                                                  |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| **Runtime/**             | Pro features organized by domain                                                                                             |
| Runtime/IK/              | [Robot Inverse Kinematics](https://doc.realvirtual.io/components-and-scripts/robot-inverse-kinematics) + robot prefabs       |
| Runtime/Interfaces/      | All Pro [interfaces](https://doc.realvirtual.io/components-and-scripts/interfaces) (OPC-UA, TwinCAT, KUKA, UR, Modbus, etc.) |
| Runtime/CADLink/         | [CAD file import](https://doc.realvirtual.io/basics/cad-import)                                                              |
| Runtime/PathTracer/      | Motion trail visualization                                                                                                   |
| Runtime/Statistics/      | Simulation statistics                                                                                                        |
| Runtime/Multiplayer/     | Multi-user networking                                                                                                        |
| Runtime/HighlightSystem/ | Object highlighting and selection                                                                                            |
| Runtime/DistanceSystem/  | Distance measurement and connectable objects                                                                                 |
| **Editor/**              | Pro editor tools                                                                                                             |
| **Samples\~/**           | Pro demo scenes (PLC Interfaces, Robotics, Robot Interfaces, Advanced Features)                                              |

## Key Asset Locations

When setting up scenes, you will frequently need these assets:

| What you need           | Where to find it                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Main framework prefab   | `Packages/io.realvirtual.starter/Assets/Prefabs/realvirtual.prefab`                                                                              |
| Industrial 3D prefabs   | `Packages/io.realvirtual.starter/Assets/3DPrefabs/`                                                                                              |
| Materials library       | `Packages/io.realvirtual.starter/Assets/Materials/`                                                                                              |
| PLC signal prefabs      | `Packages/io.realvirtual.starter/Assets/Prefabs/`                                                                                                |
| Interface prefabs (Pro) | `Packages/io.realvirtual.professional/Runtime/Interfaces/<Name>/`                                                                                |
| Robot prefabs (Pro)     | `Packages/io.realvirtual.professional/Runtime/IK/`                                                                                               |
| Demo scenes             | Import via [Demo Scenes Browser](https://doc.realvirtual.io/basics/user-interface/demo-scenes-browser) or **Window > Package Manager > Samples** |

## Your Project Content

Place all your project files in `Assets/`:

* **Scenes** — your simulation scenes
* **Scripts** — custom C# scripts and behaviors
* **Prefabs** — your own reusable prefabs
* **Materials** — custom materials
* **Imported CAD data** — files imported via CADLink

## Previous Folder Structure (6.0 and earlier)

{% hint style="info" %}
In versions before 6.3, realvirtual was distributed as a `.unitypackage` installed into `Assets/realvirtual/`. This folder no longer exists in UPM-based installations. See the [Upgrade Guide](https://doc.realvirtual.io/advanced-topics/upgrade-guide) for migration instructions.
{% endhint %}