rojo/.cursor/rules/roblox/players/teams.md

title	description
Implement teams	The Teams service allows you assign players to different teams within your experience.

You can divide players in your experience into multiple teams using the Class.Teams service. By configuring the Class.Teams service and assigning teams, players are automatically differentiated by their display name color, as well as their name in the default player list.

Add teams

By default, no teams are configured. To add teams:

1. In the Explorer hierarchy, hover over the Class.Teams object and click the ⊕ icon to show a list of objects.

2. Insert a new Class.Team object under the Class.Teams service.

   

3. Select the new Class.Team object and, in the Properties window, change the team Class.Team.Name|Name and assign a unique matching Class.Team.TeamColor|TeamColor. A team's name and color both appear in the experience's player list.

   

4. Repeat these steps to add more teams.

Assign players to teams

By default, Roblox auto-assigns new players joining the experience to the team with the fewest members, and you can still use the following steps to assign players to a specific team.

1. Select each Class.Team object in the Class.Teams service to display its properties.

2. Uncheck the Class.Team.AutoAssignable|AutoAssignable checkbox.

   

3. Assign a player to a specific team by changing their Class.Player.Team property to the team name in the format of Teams[TEAM_NAME], such as Teams["Blue Team"].

Team spawn locations

You can use Class.SpawnLocation objects to spawn players of different teams at specific locations when they join or respawn. By default, Class.SpawnLocation|SpawnLocations are neutral and any player can spawn upon them, so you need to lock each one to the team that can occupy it using the following steps:

1. Using the Explorer, insert a new Class.SpawnLocation into the workspace.

2. With the new Class.SpawnLocation selected, uncheck its Class.SpawnLocation.Neutral|Neutral checkbox in the Properties window.

3. Set the spawn's Class.SpawnLocation.TeamColor|TeamColor property to the Class.Team.TeamColor|TeamColor of an existing team. For example, if the intended team's Class.Team.TeamColor is Lapis, set the spawn's Class.SpawnLocation.TeamColor to Lapis as well.

   

   `Class.Team.TeamColor`

   

   `Class.SpawnLocation.TeamColor`

Note that the `Class.SpawnLocation.TeamColor` property is different from `Class.SpawnLocation.BrickColor` and `Class.SpawnLocation.Color` which represent the **visual** color of the spawn object and are not related to team functionality.