# Requirements Reference

### Player Spawns

The most common requirement. Your map needs at least one `RealityPlayerStart` actor for players to spawn into.

| Requirements | Meets Requirements   |
| ------------ | -------------------- |
| Sublevel     | `RGR_PLAYER_Spawns`  |
| Actor        | `RealityPlayerStart` |
| Hard Minimum | 1                    |
| Recommended  | 10                   |

#### Thresholds

The recommended count of 10 is the minimum our default gamemodes require -= your map won't get the `RGR_Player_Spawns` tag unless it meets this count. Beyond that, thresholds determine which gamemodes consider your map compatible based on player count support:

| Requirements | Meets Requirements            |
| ------------ | ----------------------------- |
| 1            | Minimum viable (hard minimum) |
| 2            | Supports 2-player modes       |
| 8            | Supports up to 8 players      |
| 16           | Supports up to 16 players     |
| 32           | Supports up to 32 players     |
| 64           | Supports up to 64 players     |

If your map has 20 spawn points, it qualifies for a 1,2,8 and 16 thresholds. A gamemode that needs 32-player support won't consider your map compatible.

#### Gameplay Tag Filtering

Spawn points can be filtered by gameplay tags. If a gamemode requires spawn tagged with specific tags (eg. `Spawns.VIP`), only spawns matching those tags are counted.

***

### Team Player Spawns

For team-based gamemodes. Each `RealityPlayerStart` is assigned to one or more teams via its `TeamIndex` property.

| Requirements | Meets Requirements                       |
| ------------ | ---------------------------------------- |
| Sublevel     | `RGR_TEAM_PLAYER_SPAWNS`                 |
| Actor        | `RealityPlayerStart`                     |
| Hard Minimum | 2 (Total)                                |
| Recommended  | 16 (Total), 6 per team, at least 2 teams |

Like player spawns, team spawns can be on the persistent level or the sublevel.

#### What's Checked

Three things are validated:

* **Total spawn count** - at least 16 across all teams
* **Number of teams** - at least 2 distinct teams represented
* **Spawn per team** - at least 6 spawns for each team

All three must pass for the requirement to be fully met.

| Threshold | Meaning                         |
| --------- | ------------------------------- |
| 2         | Minimum viable                  |
| 4         | Small team modes                |
| 8         | Supports up to 8 total players  |
| 16        | Supports to 16 total players    |
| 32        | Supports to 32 total players    |
| 64        | Supports up to 64 total players |
| 128       | Large-scale team modes          |

#### Setting Up Team Spawns

Each `RealityPlayerStart` has a `TeamIndex` array. Assign each spawn to a team (Team1, Team2, etc..). Make sure to spread spawns across teams - a map with 16 spawns all on Team1 won't pass the per-team or team-count checks.

***

### NavMesh

Required for AI navigation. Your map needs at least one `NavMeshBoundsVolume`

| Requirement  | Meets Requirements               |
| ------------ | -------------------------------- |
| Sublevel     | (None - world-level requirement) |
| Actor        | `NavMeshBoundsVolume`            |
| Hard Minimum | (none)                           |
| Recommended  | 1                                |

NavMesh is a **world-level requirement** - it doesn't have its own sublevel. The volume can be anywhere in the persistent level or any streaming level.\
The volume defines the area where the engine builds navigation data for AI. After placing one, resize it to cover your map's playable area and rebuild navigation.

***

### Requirement Groups

Requirements are organized into groups. Gamemodes require **all groups** to be satisfied, but within each group the logic varies:

#### Spawns (OR)

Contains: Player Spawns, Team Player Spawns\
Your map needs **either** player spawns **or** team spawns (or both). A free-for-all map only needs regular spawns. A team deathmatch map only needs team spawns. Either satifies the Spawns group.

#### World (AND)

Contains: NavMesh\
Your map needs **all** requirements in this group. Currently that's just NavMesh, but additional world-level requirements may be added in the fiture.

#### AI Compatible (composite)

This isn't a requirement you satisfy directly. Your map is automatically tagged as AI Compatible when both the Spawns and World groups are satisfied - meaning you have spawn points and a navmesh. Gamemodes that use AI bots look for this tag


---

# 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://beyond-sandbox.gitbook.io/realitysdk/documentation/level/map-requirements/requirements-reference.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.