> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_formula/configuration/teams.md).

# Teams

Team-related settings for creation, roles and other team-related settings.

## Roles

* Roles are used to define permissions for team members, can be assigned to team members and are used to control which actions members can perform.
* Each role has a name, permissions and an order, order is used to sort roles in the team management menu.

{% hint style="info" %}
Members with permission `CHANGE_MEMBER_ROLE` can change roles of other members, but only to roles that are lower than their own role based on the Order value.
{% endhint %}

### `Order` Config Property

Order of the role is used to sort roles in the team management menu and to determine if member can change roles of other members.

### `Default` Config Property

Option to role for new members, must be unique among other roles.

### `Owner` Config Property

Option to role for team owners, must be unique among other roles.

### Permissions List

| Permission                           | Description                                                                                                      |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
| `TeamPermissions.ATTEND_RACE`        | Allow member to attend races                                                                                     |
| `TeamPermissions.DEPOSIT_MONEY`      | Allow member to deposit money to team balance                                                                    |
| `TeamPermissions.WITHDRAW_MONEY`     | Allow member to withdraw money from team balance                                                                 |
| `TeamPermissions.PAY_RACE_FEE`       | Allow member to pay race join fee, if member does not have that permission, they can join only races without fee |
| `TeamPermissions.MANAGE_TEAM`        | General permission to manage team, allows editing and performing actions not covered by other permissions        |
| `TeamPermissions.KICK_MEMBER`        | Allow member to kick other members from the team (except equal or higher roles)                                  |
| `TeamPermissions.ADD_MEMBER`         | Allow member to invite new player to the team                                                                    |
| `TeamPermissions.CHANGE_MEMBER_ROLE` | Allow member to change roles of other members (except equal or higher roles)                                     |
| `TeamPermissions.DISBAND_TEAM`       | Allow member to disband the team                                                                                 |
| `TeamPermissions.RENAME_TEAM`        | Allow member to rename the team, not applicable to base teams                                                    |
| `TeamPermissions.CHANGE_TEAM_ICON`   | Allow member to change team icon, not applicable to base teams                                                   |
| `TeamPermissions.MANAGE_UPGRADES`    | Allow member to manage team upgrades                                                                             |
| `TeamPermissions.VIEW_TRANSACTIONS`  | Allow member to view team transactions                                                                           |

## Upgrades

* The Upgrades section defines all available performance and service improvements for vehicles, pitstops, and repairs.
* Each upgrade is set in tiers, starting with a Base tier (free) and additional paid tiers with improved performance.

{% hint style="info" %}
Upgrades can be purchased by team members with permission `MANAGE_UPGRADES` in the team management menu.
{% endhint %}

### Vehicles

Determines which car models players can use and their progression.

* Name – Display name of the vehicle.
* Model – Vehicle spawn model.
* Base – If set to true, this tier is free and available from the start.
* Price – Cost to purchase the upgrade (if not base).

Example:

* Tier 1: F1 Car (openwheel1) – Base tier, free.
* Tier 2: F1 Car Upgraded (openwheel2) – Costs $5000.

### Pitstop

Controls how fast pitstops are performed.

* Name – Name of the pitstop type.
* Time.Min & Time.Max – Minimum and maximum duration in milliseconds for pitstop completion.
* Base – Free starting tier.
* Price – Cost to unlock faster pitstops.

Example:

* Standard Pitstop – 5–7 seconds, free.
* Improved Pitstop – 3–5 seconds, costs $2000.

### Repair

Defines the repair speed during races or events.

* Name – Name of the repair service.
* Time.Min & Time.Max – Time range for completing a repair (milliseconds).
* Base – Free starting tier.
* Price – Cost for faster repair services.

Example:

* Standard Repair – 30–40 seconds, free.
* Improved Repair – 20–25 seconds, costs $3000.

## Other

| Setting                    | Description                                             |
| -------------------------- | ------------------------------------------------------- |
| `PlayerMaxTeams`           | Maximum number of teams a player can be in.             |
| `Create.AdminOnly`         | Whether only administrators can create teams            |
| `Create.Price`             | Setting the price for team creation.                    |
| `Create.MaxTeams`          | Maximum number of teams that can be created and active. |
| `Create.MaxTeamNameLength` | Maximum length of team name.                            |
| `Manage.MaxMembers`        | Maximum of members in one team.                         |
| `Manage.Rename`            | Whether team can be renamed or not.                     |