# Team Definition

## Reality Team Definition

`Reality Team Definition` is a data asset used to configure how a team should look and behave.

It defines:

* Team display name
* Team color
* Team logo
* Maximum number of players
* Available character data
* Available character skins

> This asset is used as the configuration layer for a team, while the actual in-game team is represented by a `Reality Team` instance.

***

## Overview

| Feature         | Description                                               |
| --------------- | --------------------------------------------------------- |
| Team Identity   | Defines the display name, color, and logo of a team       |
| Player Limit    | Defines the maximum number of players allowed in the team |
| Character Setup | Defines which character data can be used by the team      |
| Character Skins | Defines which skins are available for the team            |

***

## Team Identity

### Properties

| Name              | Type              | Description                              |
| ----------------- | ----------------- | ---------------------------------------- |
| Team Display Name | String            | Display name of the team                 |
| Team Color        | Color             | Main color associated with the team      |
| Team Logo         | Texture Reference | Logo used to visually represent the team |

***

## Player Limit

### Properties

| Name               | Type    | Description                                   |
| ------------------ | ------- | --------------------------------------------- |
| Max Player In Team | Integer | Maximum number of players allowed in the team |

***

### Behavior

| Value       | Result                            |
| ----------- | --------------------------------- |
| `-1`        | No player limit                   |
| `0 or more` | Maximum number of players allowed |

***

## Character Configuration

### Properties

| Name            | Type  | Description                                     |
| --------------- | ----- | ----------------------------------------------- |
| Characters Data | Array | List of character data available for this team  |
| Character Skin  | Array | List of character skins available for this team |

***

## Typical Use Cases

| Use Case                              | Recommended Setup                                                        |
| ------------------------------------- | ------------------------------------------------------------------------ |
| Create a red vs blue game             | Set different Team Display Name, Team Color, and Team Logo for each team |
| Limit the size of a team              | Set Max Player In Team                                                   |
| Restrict playable characters per team | Configure Characters Data                                                |
| Give each team unique visual identity | Configure Character Skin and Team Logo                                   |

***

## Notes

| Topic               | Note                                                                                    |
| ------------------- | --------------------------------------------------------------------------------------- |
| Configuration Asset | This asset defines team setup, not the runtime team instance                            |
| Runtime Usage       | Active teams in-game are represented by `Reality Team` objects                          |
| Team Index          | Team Definitions are usually linked to a Team Index through Game Data or GameMode setup |
| Player Limit        | Team limits can later be overridden at runtime by the team instance                     |

***

## Related Pages

| Page                          | Description                            |
| ----------------------------- | -------------------------------------- |
| Reality Team                  | Runtime in-game team instance          |
| Reality GameMode              | Creates and manages team instances     |
| Reality Game Data             | Stores team definition overrides       |
| Reality Player Character Data | Defines playable character setup       |
| Reality Character Skin Data   | Defines available skins for characters |


---

# 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/gamemode/teams-system/team-definition.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.