TeamAPI
About
TeamAPI is a small library that allows developers to create teams, store values, store custom data for players, and easily retrieve this data!
Commands/Permissions
NONE
Adding to plugin
Add this API to your build path, and if you put the plugin on Bukkit, make sure to mark TeamAPI as a dependency.
Usage
How to store API data
List<Participant> players = new ArrayList<Participant>();
List<Team> team = new ArrayList<Team>();
Creating a Team
TeamAPI api = new TeamAPI();
Team team = api.createTeam("Warrior", Color.BLUE);
// Create a team with the name Warrior and blue armor
Getting team armor
public void setArmor(Participant p){
Player player = p.getPlayer(); // get the player behind a participant
ItemStack[] armor = p.getTeam().getArmor(); // get the team's armor
player.setArmorContents(armor);
}
Adding points to a participant
public void addFivePoints(Participant p){
p.addPoints(5);
}
Getting a participant's points
// this assumes you have a Participant variable called p
Integer points = p.getPoints();
Removing a participant's points
public void takeFivePoints(Participant p){
p.removePoints(5);
}
Reset a participant's points
public void reset(Participant p){
p.resetPoints();
}
Get a team's colored names
public String getTeamName(Team t){
return t.getColoredName();
}
Get a team's points
public Integer getPoints(Team t){
return t.getPoints();
}
Manipulate a team's points
// this assumes you have a Team called t
t.addPoints(10); // add 10 points
t.removePoints(8); // remove 8 points
t.resetPoints(); // reset their points
Add / Remove Players
public void swapOut(Participant in, Participant out){
Team inTeam = in.getTeam();
Team outTeam = out.getTeam();
inTeam.addPlayer(out); // add out to in's team
outTeam().addPlayer(in); // add in to out's team
inTeam.removePlayer(in); // remove in from their team
outTeam().removePlayer(out); // remove out from their team
}
Get a team's color
public Color byPlayer(Participant e){
return e.getTeam().getColor();
}
public Color byTeam(Team t){
return t.getColor();
}
Get a list of players on a team
public List<Participant> byTeam(Team t){
return t.getPlayers();
}
public List<Participant> byPlayer(Participant e){
return e.getTeam().getPlayers();
}
Convert a player into participant
public Participant find(Player p, List<Participant> players){
TeamAPI api = new TeamAPI();
Participant e = api.findPlayer(players, p);
return e;
}
More examples will be added as needed!
Have a question? Post a comment!