# Player Property Volumes (PPV's)

{% embed url="<https://www.youtube.com/watch?t=1s&v=jk2QPIv1RO0>" %}
Player Property Volumes Video
{% endembed %}

Player Property Volumes (PPV's) are a tool that allow you to control certain properties within an area of a Space. This area is defined by a box, mesh, or sphere collider.

Examples could include :&#x20;

* zero, lower, or higher gravity
* the effect of distorting the players vision
* allowing the player to walk or run slower or faster.

You can affect things such as gravity, post processing effects, and certain properties of the avatar. When taking these to the limit you can create some very interesting situations within your space.

![The PPV Script when dragged onto an object](/files/8ctbMH9vc0Ibi1R9jUxU)

The properties that are currently available include :&#x20;

* Gravity (Default -15)
* Jump Height (Default 6.5)
* Walk Speed (Default 2.7)
* Sprint Speed (Default 10)
* Bloom (Default 0.5)
* Chromatic Aberration (Default 0.5)
* Motion Blur (Default 0.5)

{% hint style="info" %}

* -1 will leave the parameter setting as is in the space. So only edit the ones you want to affect.
* Hover over the parameter text to see the default settings in editor.
* **Make sure to set the collider IsTrigger setting to true otherwise you will not be able to enter the collider.**
  {% endhint %}

Some of these can be set to negative, so be sure to play around and see what amazing things you can come up with!

## Creating a PPV

The Player Property Volume is a script that you apply to an object with a collider. The script can be found in the Mona/TemplateScripts folder. Simply drag and drop the MonaPPV.cs script onto the object with the collider. ***The Collider should have the IsTrigger set to On.***

For organisation purposes we recommend making an empty gameobject in your scene and applying the collider and script on that. This way the PPV can act as it's own gameobject to edit easily.

Adjust the settings on the script as you see fit.&#x20;

When the Avatar touches the collider, the settings of the PPV will override the settings of the default space, and return to the settings of the Space when the avatar exits it.

## Considerations

### Positive gravity without landing

If you want a volume to throw the Avatar in the air (without letting them land) the gravity setting should be above 100. If it is below this the Avatar can usually land and the gravity only kicks in again if they jump.

### Can't get into the volume

This is probably due to the PPV Collider 'IsTrigger' set to false. Make sure this is set to true/on.


---

# 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.monaverse.com/create/building-spaces/improve-your-space/player-property-volumes-ppvs.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.
