[Tutorial] Teams (with names & armor colors!)

Hello Bukkit Community!
Today I would like to share with you a way of creating teams in a really simple way!

First of all...

HOW IS IT SIMPLE?

You may ask yourself.
Well, by using certain methods implemented within Bukkit, it shouldn't be that hard!

Okay! Let's begin with the steps.

Teams Class
First, we need to make a teams class, so it can store all of our team objects.
Go ahead and create your class and its constructor this way:

Code:java

package me.fabegabe.teams.example;
 
/*
* lots of imports...
*/
 
public class Team {
 
//Store the team's name.
private String name;
//Store the team's name color.
private ChatColor displayColor;
//Store the team's armor color.
private Color armorColor;
//Store the team's wool display color.
private DyeColor woolColor;
//Store their UUID's instead of names. (Players)
private List<UUID> users = new ArrayList<UUID>();
//Store all the teams created so far.
private static List<Team> teams = new ArrayList<Team>();
 
//Teams Constructor (used to save variables)
 
public Team(String name, ChatColor displayColor,
Color armorColor, DyeColor woolColor){
this.name = name;
this.displayColor = displayColor;
this.armorColor = armorColor;
this.woolColor = woolColor;
}
 
//Retrieving all the info about the team is necessary!
 
//Getting the team's name.
public String getName() {
return name;
}
 
//Getting the team's display color.
public ChatColor getColor() {
return color;
}
 
//Getting the team's wool color.
public DyeColor getWoolColor() {
return woolColor;
}
 
//Getting the team's armor color.
public Color getArmorColor() {
return armorColor;
}
 
//Getting all the players in the team.
public List<UUID> getPlayers() {
return users;
}
 
//Getting all teams.
public static List<Team> getTeams() {
return teams;
}
 
//Let's create some join and leave methods
 
//Is in team check
public static boolean isInTeam(Player p) {
for(Team t : getTeams())
return t.getPlayers().contains(p.getUniqueID());
// if it doesn't contain the player, return false.
return false;
}
 
//Adding a player to a team.
public static void join(Player p, Team t) {
if(t == null || isInTeam(p))
return;
t.getPlayers().add(p.getUniqueID());
giveArmor(p);
}
 
//we don't need a second variable, since it will leave the player's current team.
public static void leave(Player p) {
if(!isInTeam(p))
return;
getTeam(p).getPlayers().remove(p.getUniqueID());
}
 
//Let's now get the team of a certain property
 
public static Team getTeam(String name) {
for(Team t : getTeams()){
if(t.getName().equalsIgnoreCase(name))
//If the team's name is 'name', we'll return that team.
return t;
}
//Otherwise, we return nothing.
return null;
}
 
 
public static Team getTeam(Player p) {
//Looping through all the teams.
for(Team t : getTeams()){
if(t.getPlayers().contains(p.getUniqueID()))
//If the player list contains  their UUID, we'll return the team.
return t;
}
//Otherwise, we will return nothing.
return null;
}
 
 
public static void giveArmor(Player p) {
if(!isInTeam(p))
return;
ItemStack helmet = new ItemStack(Material.LEATHER_HELMET, 1);
//We are using leather armor meta since we want to add the team's armor color.
LeatherArmorMeta hm = (LeatherArmorMeta) helmet.getItemMeta();
hm.setColor(t.getArmorColor());
//Setting the display name... and lore...
hm.setDisplayName(t.getColor() + t.getName() + " Cap");
hm.setLore(Arrays.asList(ChatColor.AQUA + "Fancy " + t.getColor()
+ t.getName() + ChatColor.AQUA + " cap."));
helmet.setItemMeta(hm);
ItemStack tunic = new ItemStack(Material.LEATHER_CHESTPLATE, 1);
LeatherArmorMeta tm = (LeatherArmorMeta) tunic.getItemMeta();
tm.setColor(t.getArmorColor());
tm.setDisplayName(t.getColor() + t.getName() + " Tunic");
tm.setLore(Arrays.asList(ChatColor.AQUA + "Fancy " + t.getColor()
+ t.getName() + ChatColor.AQUA + " tunic."));
tunic.setItemMeta(tm);
ItemStack pants = new ItemStack(Material.LEATHER_LEGGINGS, 1);
LeatherArmorMeta pm = (LeatherArmorMeta) pants.getItemMeta();
pm.setColor(t.getArmorColor());
pm.setDisplayName(t.getColor() + t.getName() + " Pants");
pm.setLore(Arrays.asList(ChatColor.AQUA + "Fancy " + t.getColor()
+ t.getName() + ChatColor.AQUA + " pants."));
pants.setItemMeta(pm);
ItemStack boots = new ItemStack(Material.LEATHER_BOOTS, 1);
LeatherArmorMeta bm = (LeatherArmorMeta) boots.getItemMeta();
bm.setColor(t.getArmorColor());
bm.setDisplayName(t.getColor() + t.getName() + " Boots");
bm.setLore(Arrays.asList(ChatColor.AQUA + "Fancy " + t.getColor()
+ t.getName() + ChatColor.AQUA + " boots."));
boots.setItemMeta(bm);
//We are adding the armor into the player's armor values/slots.
p.getInventory().setHelmet(helmet);
p.getInventory().setChestplate(tunic);
p.getInventory().setLeggings(pants);
p.getInventory().setBoots(boots);
//Finally, let's update the player's inventory, although it is deprecated.
p.updateInventory();
}
 
}

Using the variables

We've gotten so far... so... what do we do with our team colors?
We will use them in our armor, and our menu options.

Menu class:

Code:java

package me.fabegabe.teams.example;
 
/*
* lots of imports...
*/
 
public class Menu {
 
@SuppressWarnings("deprecation")
//Set the return type to an inventory.
public Inventory getTeamSelector() {
//Creating our inventory.
Inventory menu = Bukkit
.createInventory(null, 9, ChatColor.BLUE + "Team Selector");
//We're now iterating through all the teams' size so we can add those to our menu.
for (int i = 0; i < Team.getTeams().size(); i++) {
Team team = Team.getTeams().get(i);
//Creating a new item stack for the wool in the menu.
ItemStack wool = new ItemStack(Material.WOOL, 1, team
.getWoolColor().getData());
ItemMeta woolMeta = wool.getItemMeta();
woolMeta.setDisplayName(team.getColor() + team.getName() + " Team");
wool.setItemMeta(woolMeta);
menu.setItem(i, wool);
}
return menu;
}
 
}

Finally.. how do you register a team?!

You can call this method whenever you want!

Code:java

//Here we are telling the code to create a new team object for us and to add it to our existing teams.
public static void registerTeam(String name, ChatColor color,
Color armorColor, DyeColor woolColor) {
Team t = new Team(name, color, armorColor, woolColor);
Team.getTeams().add(t);
}

Of course, it would be easier if you would register them in your onEnable.. like me, for example ( ):

Code:java

public void onEnable() {
registerTeams();
}
 
public void registerTeams() {
TeamManager.registerTeam("Green", ChatColor.GREEN, Color.LIME,
DyeColor.LIME);
TeamManager.registerTeam("Red", ChatColor.RED, Color.RED, DyeColor.RED);
TeamManager.registerTeam("Blue", ChatColor.BLUE, Color.BLUE,
DyeColor.LIGHT_BLUE);
TeamManager.registerTeam("Yellow", ChatColor.YELLOW, Color.YELLOW,
DyeColor.YELLOW);
TeamManager.registerTeam("Dark Green", ChatColor.DARK_GREEN,
Color.GREEN, DyeColor.GREEN);
TeamManager.registerTeam("Gold", ChatColor.GOLD, Color.ORANGE,
DyeColor.ORANGE);
TeamManager.registerTeam("Purple", ChatColor.LIGHT_PURPLE,
Color.PURPLE, DyeColor.PURPLE);
TeamManager.registerTeam("Navy", ChatColor.DARK_BLUE, Color.NAVY,
DyeColor.BLUE);
TeamManager.registerTeam("Special", ChatColor.AQUA, Color.AQUA,
DyeColor.CYAN);
getLogger().log(Level.INFO, "Loaded teams.");
}

Screenshots


Team Selection Menu


Armor Dyes


Congratulations! You have created your own teams plugin! Feel free to use this on any plugin you want (minigame or not).

Please leave feedback and I hope this helped most of you.

Take care everyone and until next time! (I'm not leaving the forums )

~FabeGabe

 

Screenshots please?

 

FabeGabeMC I wouldn't call this a tutorial, as you barely explain anything that is done in your code. This is more of a snippet.

 

xTigerRebornx Niknea added and fixed

 

FabeGabeMC Is there a way to add multiple players from a list?

 

Instead of using a for loop, why don't you store the teams in a Map<Player, Team> so you can get the team by using
map.get(player)?

 

LCastr0
For me it is easier.
Chrusty45
Loop through all the players in a team and add the players (strings) to the other team.
Make sure to remove them first though

 

It's easier, but I think saving it in a map is safer...

 

FabeGabeMC Another question, I can't seem to get addPlayer to work. I can't use a string for the team name and I have no idea how to do this. My current code:

Code:java

for(String players : teamConfig.getStringList(key + ".Players")) {
                Player player = Bukkit.getPlayerExact(players);
                Team.addPlayer(player, key);
            }

 

Chrusty45
don't use getPlayerExact. use getPlayer.

 

It soothes me to read this, Its so good.

meow good tutorial.

 

FabeGabeMC No... no.. That's not the problem. the method addPlayer(Player player, Team team) is unusable. If I want to add a player to the team, I can't use addPlayer("PlayerName", "TeamName"); because "TeamName" is not a team, it is a string.

 

Chrusty45
Try Team.getTeam("TeamName");

 

ChipDev

?

 

Show Spoiler Hide Spoiler