# Quick Start Guide

## Quick Start Guide

### Install and Enable

#### 1. Install Plugin

1. Find the Replicated Gravity plugin in your Fab Library.
2. Install to your preferred engine version
3. Enable the plugin in Edit > Plugins
4. Restart the editor when prompted

### Try the Example Levels

#### 2. Enable Plugin Content

1. Open the Content Browser
2. Click the cogwheel in the upper right corner of the browser
3. Make sure Engine Content and Plugin Content are checked
4. This reveals plugin example content

#### 3. Open Example Level

1. Navigate to the example levels:
2. Go to Plugins > ReplicatedGravity Content > Example\_Levels
3. **Third Person**: Open Example\_Lvl\_ThirdPerson
4. **First Person**: Open Example\_Lvl\_FirstPerson
5. **Vehicle**: Open `Example_Lvl_Vehicle`.

<figure><img src="/files/xj05OPxRNVxcuqNLGy09" alt=""><figcaption></figcaption></figure>

#### 4. Play and Test

Press Play and explore:

* Walk on walls, ceilings, and planets with characters.
* Drive across vertical surfaces and planetary spheres with vehicles.
* Test gravity transitions between different surfaces
* Experience networked gravity in PIE multiplayer

### What's Included

#### Example\_Lvl\_ThirdPerson

Demonstrates:

* Planetary gravity (walking around spheres)
* Directional gravity (fixed orientation zones)
* Dynamic gravity (wall/ceiling walking)
* Smooth transitions between gravity modes
* Correct player orientation in all directions
* Network replication with prediction

#### Example\_Lvl\_FirstPerson

Demonstrates:

* First-person camera handling with arbitrary gravity
* Planetary gravity (walking around spheres)
* Directional gravity (fixed orientation zones)
* Dynamic gravity (wall/ceiling walking)
* Smooth transitions between gravity modes
* Correct player orientation in all directions
* Network replication with prediction

**Example\_Lvl\_Vehicle**

Demonstrates:

* Features two non-Z-down surfaces to test directional gravity using custom downward vectors (e.g., vertical or inverted floors).
* Features two spherical planets to demonstrate gravity attraction and navigation on curved surfaces.
* Authority-driven networked vehicle movement with Iris-ready replication and multiplayer support.

### Next Steps

#### For Third Person Template Integration

See the Third Person Template Integration Tutorial:

* Replace ChaosWheeledVehicleMovementComponent
* Setup animation blueprint
* Configure gravity modes
* Add gravity-relative animations

#### **For Vehicle Template Integration**

See the Vehicle Template Integration Tutorial:

* &#x20;Replace `ChaosWheeledVehicleMovementComponent`
* &#x20;Reparent vehicle controller.

#### For Custom Implementation

See the mode-specific Usage & Setup Guide:

* Directional Gravity: Usage & Setup Guide
* Planetary Gravity: Usage & Setup Guide
* Dynamic Gravity: Usage & Setup Guide

#### For Multiplayer Testing

Test network replication:

* Use Play in Editor with 2+ players
* Test as Listen Server and Dedicated Server
* Verify rotation replication on moving platforms
* Check animation correctness on clients

### Example Level Controls

#### Character Movement

* WASD: Move relative to camera
* Space: Jump
* Mouse: Look around

#### **Vehicle Movement**

* W/S: Throttle and Brake/Reverse
* A/D: Steering
* Space: Handbrake
* Tab: Toggle Camera (Front/Rear).

### Troubleshooting

#### Can't see plugin content

* Verify Engine Content and Plugin Content are enabled in Content Browser
* Restart editor after enabling plugin
* Check plugin is installed to correct engine version

#### Vehicle sliding on slopes

* Ensure `bUseGravityAwareSleep` is enabled in the `GravityVehicleMovementComponent`.

#### Character falling through floor in examples

* Ensure project collision settings are default
* Verify example level hasn't been modified
* Reimport plugin if levels are corrupted

#### Network replication not working

* Test in PIE with Net Mode = Play As Listen Server
* Verify dedicated server build includes plugin
* Check firewall settings for dedicated server testing

### Summary

You've now:

* Installed the plugin
* Explored character and vehicle example levels
* Tested networked gravity modes.&#x20;

Ready to integrate into your project? Start with the Third Person or Vehicle Template Integration guides.


---

# 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://replicated-gravity.gitbook.io/replicated-gravity-docs/getting-started/quick-start-guide.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.