services/Scoreboards
ScoreBoards
Scoreboards are new functions that came with mc 1.5. It allows you to popup a gui in the screen of a player and put custom inferomation inside of it. This already has a very weak api in NMS but we decided to redo it and support global settings as well.
The Scoreboards from BKCommonLib allows you to merge with orther plugins unlike the NMS api.
Here is an example:
Player player = Bukkit.getOnlinePlayers()[0]; //just get an online player as example CommonScoreboard board = CommonScoreboard.get(player); //Get the scoreboard form the player CommonObjective sidebar = board.getObjective(Display.SIDEBAR); //Get the sidebar scoreboard sidebar.show(); //Shwo the sidebar (use siderbar.hide() to hide) sidebar.createScore("kills", 17); //Create a new score called 'kills' and make the value 17
You can also edit the score if the value needs to be changed.
CommonScore kills = siderbar.getScore("kills"); kills.setValue(18); //Change the value to 18 kills kills.update(); //Don't forget ot update the score after changing it!
And if the display name from the sidebar is not the thing you want, you can allways call this:
sidebar.setDisplayName("PvP Info");
You can also create Scoreboard teams:
CommonTeam team = CommonScoreboard.getTeam("example"); if(team == nul) { team = CommonScoreboard.createTeam("example"); team.setSendToAll(true); //set if team is visible for everyone team.show(); //Create team team.setDisplayName("Example"); //Not sure where this is used for team.setPrefix(ChatColor.RED.toString()); //Prefix (in front of name) team.setSuffix(" - Example"); } team.addPlayer(player);
These are all available displays:
- LIST - Tab list (i think)
- SIDEBAR - Right sidebar of your screen
- BELOWNAME - Below nametags
Showing off a BELOWNAME example:
Player player = event.getPlayer(); //Player who will see the food from lenis0012 Player lenis0012 = Bukkit.getPlayer("lenis0012"); //Example player to show food from CommonObjective obj = CommonScoreboard.get(player).getObjective(Display.BELOWNAME); obj.setDisplayName("Hunger"); obj.show(); //Allways call this obj.createScore("lenis0012", "lenis0012", (int) lenis0012.getFoodLevel());
Comments