# ExistentStage

## Overview

An Existent Stage is Existent's representation of your physical play area. It contains data about the dimensions and physical properties of the area, and is the foundation Existent uses to create many virtual [Spaces](https://docs.existent.com/documentation/resources/classes-components/existentspace) that Players can walk around in-game.

At present, Existent supports rectangular and circular Stages of customisable dimensions, and can also represent immovable objects in your play area such as a pillar - referred to in Existent as 'obstacles' - that Players need to be alerted to if they are about to walk into.

The dimensions and obstacles will become parameters for Existent in determining when a Player is about to bump into a physical obstacle or step outside the bounds of the Stage. By default, when this happens, the Player will be shown a 'safety view', with a 3D translucent wall outlining the boundary and any obstacles in the Stage. This behaviour can be customised by modifying the `Min Safe Distance from Edge` property or the `Should Trigger Safety Render` property on each obstacle.

<figure><img src="https://lh7-us.googleusercontent.com/jLhr4D1QC5f0hC0NAtzmHqQK1drTtYJRWGmE47TNracqII-o9MJrRHEa_xFJejVmyTT4nHJTRGYwEIWE2MyRWgqGQhel0Vi3dg_sIHGGeFmH5pAPhn7HB6QdviYJS5qdHFT2g6bGOPr0rEFwAIP9ew" alt=""><figcaption></figcaption></figure>

## How to use

Right-click on your content browser and select Existent→Stage. This will create a new Existent Stage object. Open the newly created asset and define the Stage parameters according to your physical area. Then you can either set this as the default Stage in project settings or set the Stage parameter of each Space you create if you want to take advantage of multiple Stages in a single project.

{% hint style="warning" %}
The real world origin of your motion tracking system (whether that is Vive Trackers, Optitrack or Vicon) must correspond to the exact centre of the Stage boundary you define here. Currently there’s no way to specify a different relationship between your tracking system origin and the Stage boundary.
{% endhint %}


---

# 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://docs.existent.com/documentation/resources/classes-components/existentstage.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.
