Bukkit

v1.1

Features and Bug fixes

Note: This was built against Bukkit #1925 (1.7.6 - 1.7.9) but has been tested on versions 1.7.X of Minecraft! Use at your own risk for versions 1.6.4 and earlier.

Attention: An important bug has appeared in KotH v1.1, that prevents new users from actually using the plugin. While there is no new update, I have put together the steps for a manual fix here. KotH v1.2.1 fixes these issues for you.

• Fixed random class assignment bug on arena start. On certain Bukkit builds, in certain conditions, the arena would fail to give a class to a player who is undecided because the plugin believes they have a class, which is not so.
• Fixed bug with arena joining. This bug is that a player without the per-arena permission, and with the join permission, couldn’t join an arena. So, all players by default have access to all arenas now.
• Fixed occasional forcestop bug. There was a nested error in the code which would try to stop the hill timer after the arena ended, which broke the plugin sometimes by creating an infinite loop.
• Fixed math associated with calculating a hill boundary. Circular hills had an offset boundary that wasn’t very noticeable, but still has been addressed.
• Added team-only chat feature. If enabled in config, players can only talk to teammates. You do not need to enable secluded-chat for this. If team-only chat is disabled while secluded chat is not, players can only talk to other players in the arena (like before this update).
• Added a player stats tracker. So far, this stats tracker tracks kills, deaths, (kdr), wins, losses, draws, (wlr), and more! The stats tracker for each player for each arena is saved in a stats folder, much like the inventories folder. Without knowledge of whose UUID a player has, it is nearly impossible to find each individual player’s file; however, it is not necessary to ever touch these files.
• You can check your stats for any arena! The command /koth stats <arena> tells you your stats for that arena. (perm: koth.user.arenastats)
• Stats can now be viewed via command signs! Just like you would set up any other command sign, you can create stats signs for any arena.
• Lots of new command signs! You can enable and disable arenas as well as force start or end them!
• Added killstreaks to be given during an arena. You can give players rewards in the arena for getting lots of kills. These rewards are not kept at the end of the arena. You can specific killstreaks to specific classes.
• Added winstreaks to be given at the end of an arena. A player who has won several games in a row can be given items.
• Added an entry-fee setting. For each arena, you can charge players to join.
• Added a quit-charge setting. Conversely to the entry-fee, you can charge players for quitting an arena before the match ends. If they do not have enough money, their funds will be in overdraw. The plugin makes no attempt to stop the player if they are at a minimal bound.
• If enabled in the config, all players will receive a compass that points to the nearest hill. This compass will tell the player how far they are from the hill and will target the center of it. You can enable or disable this feature. If you are using WorldEdit, it is recommended you change your navigation-wand to an item other than the compass, otherwise your players will be told they don’t have permission, when they do. To do this, go into your WorldEdit config.yml, and change the item id of the navigation-wand to something other than 345.
• All block-related features associated with hills have been removed. With the compass introduction, there is no need for a laggy boundary around the hill that’s always shifting. You can delete your ‘hill-block’ setting in each arena.
• Added a /koth version command. You can view basic information regarding the plugin with this command; there are no permissions associated. When the config is reloaded, all relevant arenas will be ended.
• Help command is manually paginated so it's not one huge long string of commands for those with setup or admin permissions.
• Arena locations can no longer be changed while the arena is in progress.

v1.0.1

Lots and lots of features have been added!

Note: This was built against Bukkit #1925 (1.7.6 - 1.7.9) but has been tested on versions 1.7.X of Minecraft!

• Added a Choose Class Command. /koth chooseclass <class> (perm: koth.user.pickclass) gives you an existing class if you have permission for it. If the class specified does not exist, a helpful message displaying available classes is shown. If the class specified is ‘random’, you are given a random class.
• Added a Choose Team Command. /koth chooseteam <red|blue> (perm: koth.user.pickteam allows you to choose the team for the arena you are in. You must be in the lobby.
• Added Settings and Location commands. You can view current arena settings with /koth settings <arena> (perm: koth.setup.setting), or change them for an individual arena. Similarly, /koth locations <arena> (perm: koth.setup.location) allows you to view the current locations of either spawnpoints or hills. However, to change them you still need to use the setwarp or sethill commands.
• Players who did not pick a class in the lobby are assigned a random class. Players who do not pick a class utilizing the lobby signs will be given a random class that they have permission for. If they do not have permission for any class they will be removed from the arena.
• Various arena abilities have been added. You can now make landmines, spawn wolves, horses, and even zombies by using certain items!
• Added a prize manager. You can now configure rewards to give to players! Rewards are handed out at the end of a match to all players that did not quit. You can configure rewards for winners, losers, and all players. You can add any item with any enchantment or metadata.
• Added several events. Several events have been added that may change gameplay. For instance, when a world is loaded or unloaded, arenas are loaded or unloaded.
• You can toggle new settings. You can disable regeneration of health, the ability to drop items, and more for each arena! Note that players with koth.admin.dropitems will be able to drop items under any circumstance.
• Fixed NullPointerException when Player respawns. Players who did not pick a class triggered a null pointer exception because I gave items to players using ArenaClass.java, which would be null for these players. Since no null check was present, the exception followed suit.
• Fixed bug that caused massive error log if there was only one hill. I never took into account the possibility that there might only be one hill in any given arena. I fixed some math logic in my Hill utility class to prevent the hill timer from trying to switch hills, which is nonsensical.
• (API) Event structure has been changed. The ArenaEndEvent is no longer cancellable, and you can now get the winning and losing teams (Set<Player>). HillScoreEvent is now the ArenaScoreEvent. ArenaJoinEvent (cancellable) and ArenaLeaveEvent (Uncancellable) have now been added, which respectively listen for a player entering or leaving the arena.
• You can now create Arena Signs. If specified an arena, you can put many commands to sign form, such as join, leave, and spectate. Current class signs will cease to work with this update, because you now need a [koth] tag on the first line of every KotH sign.
• You can allow/block any command you want for players in the arena. The global section now has an “allowed-cmds” string in which you must allow all commands you want your players to be able to use while in the arena.
• You can now log certain KotH functions. If enabled in the global section (“logging” is set to true), commands issued and certain messages will be logged in a .log file. However, there is no method to try and limit the file size, so make sure you keep an eye on it.
• Vault support has been added! You can now configure economy rewards to give to players. For signs, you can add prices (4th line on command signs, 3rd line on class signs).
• Removed Media Folder from the final .jar file. The media folder includes all images for KotH and is a pro forma fix. All this does is boost your server RAM by removing about 200KB of wasted space.
• Fireworks are now launched when a hill switch and over winners' heads at the end of an arena! :)
• An arena argument is no longer required for certain commands if there is only one arena.

Before asking questions or suggesting bugs, please read the FAQ.

Any comments, concerns, or questions left unaddressed by the FAQ should be brought up in the comments section of the main post. This is not where bug reports go.

If you feel there is bug, report them via the ticket tracker so they can be addressed.

- An important bug has appeared in KotH v1.1, that prevents new users from actually using the plugin. While there is no new update, I have put together the steps for a manual fix here.
- Start, End, Enable and Disable signs do not work properly.

Keep the bug reports coming at https://github.com/AoHRuthless/King-of-the-Hill/issues