# Getting started

<figure><img src="/files/7Nk4AYysc3IJqtonRxMc" alt=""><figcaption></figcaption></figure>

To add a planetary ocean to your level, follow these steps:

1. **Add BP\_PlanetaryOcean to your level**\
   Drag and drop the `BP_PlanetaryOcean` actor into your level. This actor controls the ocean’s quad tree and mesh generation settings, such as resolution, radius, and LOD (Level of Detail).
2. **If you don’t see the ocean** — you’re inside it. Since backface culling is enabled by default, there’s no visible geometry either. Disable `Nodes Backface Culling` in a `Quadtree` section of `BP_PlanetaryOcean` and press `F` to focus on the ocean sphere. You can then re-enable backface culling.
3. **Configure the ocean’s settings**\
   In `BP_PlanetaryOcean`, adjust the ocean’s mesh settings (radius, resolution, etc.) and quadtree settings to fit your needs. Hover over variables to see detailed explanations of what they do. Switch to wireframe mode to better understand how mesh generation behaves.

<div align="left"><figure><img src="/files/INf0izSdN1MeR3lhY1wt" alt=""><figcaption></figcaption></figure></div>

Explore the `Ocean Parameters` section of the BP that controls waves generation.

<div align="left"><figure><img src="/files/ip8mzU73IL3Dl7HxuJaQ" alt=""><figcaption></figcaption></figure></div>

1. **Additional notes**\
   Ocean material surface settings are defined in the `MI_PlanetOcean` material instance.

{% content-ref url="/pages/Yql3imulLbtqIZ96BSFq" %}
[Scalability and Precision](/guide-v.-2.1/scalability-and-precision.md)
{% endcontent-ref %}


---

# 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.planetaryoceans.com/guide-v.-2.1/getting-started.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.