Teams

The Team Module allows you to group players into teams, each with its own unique properties, colors, and game rules. This is essential for creating team-based games like Capture the Flag, Team Deathmatch, or cooperative challenges.

You can manage teams in /editmap -> Teams (Player Head).

Creating and Configuring a Team

1. Navigate to the Teams menu.
2. Click "Add Team" (Paper) and provide a name for your new team.
3. Click on the newly created team in the menu to open the Team Edit Menu.

Here, you can customize every aspect of your team:

• Name: The display name of the team.
• Icon: The item that represents the team in menus.
• Color: The color associated with the team. This will color the team's name in chat, on nameplates, and on the tab list.
• Persist Players: If Yes, players will remain on this team even after leaving and rejoining the map. If No, their team assignment is temporary for the current session.

Team Options

In the Team Edit Menu, click the "Options" (Iron Bars) item to configure game rules on a per-team basis. Each option can be set to TRUE, FALSE, or INHERIT (uses the region's flag settings).

• Friendly Fire: If FALSE, players on the same team cannot damage each other.
• See Invisibles: If TRUE, players on this team can see their invisible teammates.
• Nametag Visibility: Controls if nametags are always visible, hidden, or only visible to teammates.
• Collision: If FALSE, players on the same team can walk through each other without colliding.

Managing Team Members

While you can manually assign players for testing, the primary way to manage teams is through the Action system for dynamic gameplay.

Automatic Assignment (Using Actions)

For your actual game, you'll use actions to manage teams dynamically at the start of a round or when players join.

• Set Team Action: Directly assigns a player to a specific team. You could trigger this when a player walks into a "Red Team" selection area.
• Auto Balance Player Action: This action will automatically place a joining player onto the team with the fewest members from a specified list of teams. Ideal for drop-in/drop-out games.
• Distribute Teams Action: This powerful action shuffles all players currently in the map and distributes them among a list of teams, attempting to make them as even as possible. This is perfect for starting a match.
• Balance Teams Action: Similar to Distribute Teams, this action rebalances all players across a set of teams, useful between rounds.

Example: Creating a Red vs. Blue Game

1. Create Teams: Create two teams, "Red Team" and "Blue Team", and set their colors to Red and Blue respectively.
2. Create a Function: Make a function called StartGame.
3. Add Distribute Action: Inside StartGame, add a Distribute Teams action. In its configuration, add both "Red Team" and "Blue Team" to the list of teams to distribute players into.
4. Add Teleport Actions: After the distribute action, add two Teleport actions.
   • One that targets players on the "Red Team" and teleports them to the red spawn.
   • One that targets players on the "Blue Team" and teleports them to the blue spawn.
5. Trigger the Function: Call the StartGame function from an event, such as a countdown timer reaching zero or an admin pressing a start button.