killStats REBORN + PAPI SUPPORT for 1.19!

!! this is simply an update of an old plugin here: !!
https://dev.bukkit.org/projects/killstats-v1-0
killStats on Bukkit has not been updated since 2014 (CB-1.7.4)
so i think its time for an update, as this is the only working PAPI cloud addon.

USING WITH PAPI

Step 1. Install killStats by me in your plugins folder.
Step 2. Download KillStats PAPI Addon from https://api.extendedclip.com/expansions/killstats/ and then put in in your PAPI/Expansions Folder.
Restart, and you are done!

PAPI Placeholders:
%killstats_kills%
%killstats_killrank%
%killstats_deaths%
%killstats_deathrank%
%killstats_streak%
%killstats_streakrank%
%killstats_kdr%
%killstats_kdrrank%

Please report any errors you find so I can get them fixed.

Thanks

Description
Features:

• PVP based statistics.
  • Keep track of a players kills, deaths, killstreak, and kill/death ratio!

• Ability to drop a players head upon death.

• Full mySQL support.

• Show top players on leaderboard signs.

• Reward players for reaching killstreaks.
  • You choose what streak the receive the item on, and what to give the player.
  • You can also execute a command upon a streak to award the player XP or maybe a group rank. All commands are run as OP.

• Broadcast messages when a player reaches a certain killstreak or when a player's killstreak is broken.
  • You can choose what killstreak to broadcast on and what to say!

• Anti-Boost
  • A player can only kill another player X amount of times per X number of minutes.
  • This cuts down on players boosting from their friends to get higher k/d and reward items.

• Multi-World Support
  • Each world can have its own set of statistics.
  • Any world that is not in the 'seperate world' list will all have the same stats

• Disable Certain Worlds
  • You can disable certain worlds from keeping up with any type of stats or streaks etc.
  • Maybe you have a hunger games world but don't want your players killStats to be ruined because of HG. This works great!

• Included is a lang.yml that can be used to translate all messages inside killStats to any language you need.

• Players can choose to show stats in chat or scoreboard

• The entire configuration has changed. The plugin will automatically update this for you. All your settings will be set to default, but your old config can be found in the folder "old_data_files" and you can change what you need to manually.

All player commands are issued by "/killstats" or the alias "/ks". A list of those commands and the descriptions of each command is below.

/ks ? - View a help page with a list of commands.
/ks - View your personal statistics.
/ks [playername] - View another players statistics(player must be online).
/ks startover - Reset your statistics.
/ks scoreboard - Enable/disable the scoreboard.
/ks rank - View your personal rankings.
/ks topkills [page] - View the top kills leaderboard.
/ks topdeaths [page] - View the top deaths leaderboard.
/ks topratio [page] - View the top ratio leaderboard.
/ks topstreak [page] - View the top streak leaderboard.



All admin commands are issued by "/killstatsadmin" or the alias "/ksa". A list of those commands and the descriptions of each command is below.


/ksa ? - View a help page with a list of commands.
/ksa reload - Reload the config and all data files. Also refreshes the leaderboards and signs.
/ksa enable - Enable the plugin. Only works if the plugin is disabled of course.
/ksa disable - Disable the plugin. Only works if the plugin is enabled of couse.
/ksa head [playername] - Get the head of a specified player.
/ksa reset [playername] - Reset a players statistics.

How to use rewards.yml
____
In order to give rewards to players for their killstreak, "Rewards_Enabled" must be true inside the config.

You are able to give a player items, and issue commands within the rewards system. I am going to show you an example of how to do both.

You can give rewards for individual killstreaks or give a reward for every kill a person gets. Maybe you want to reward your players with money everytime they kill another player. That is possible within the killStats rewards system.

() = Required
[] = Optional

Format: (ItemID)[ ataValue] (Amount) [Enchantment:Level] [name:The_Name] [lore:The_Lore;Lore2]

To input a space into item name or lore items, use an underscore("_").
To input a new line into lore items, use a semi-colon(";").

To issue a command within the rewards file just simply do "command;*command goes here* as one of the rewards.

Below is an example of a valid rewards.yml file with all of the options above.

Code (YAML):

Rewards:
  all :
  - command;/eco give %killer.name% 50
 
  5 :
  - 373:16273 2
   - 264 10
   - command;/xp give %killer.name% 825

  10 :
  - 264 25
   - 276 1 sharpness:2 fireaspect:1 name:Killer_Sword

  15 :
  - 264 25
   - 276 1 sharpness:4 fireaspect:2 name: %killer.name%'s_boss_sword lore:Lore_1;Lore_2;Lore_3
   - 264 25
   - 276 1 sharpness:2 fireaspect:1 name:Killer_Sword

  15 :
  - 264 25
   - 276 1 sharpness:4 fireaspect:2 name: %killer.name%'s_boss_sword lore:Lore_1;Lore_2;Lore_3

Leaderboard Signs
Below is how you create a leaderboard sign.

Create a sign where you want the leaderboard sign to be.

The first line will be "[ksrank]"

The second line will be the category you are wanting to show "kills/deaths/streak/ratio"

The third line will be the rank you want to show "1/2/3 etc"

Below is a list of all the admin permissions. By default none of these are enabled.

killstats_admin.reload - Reload the killstats configuration.
killstats_admin.enable_disable - Enable/Disable the plugin.
killstats_admin.player_head - Allow the player to get head of other players.
killstats_admin.reset_players - Allow the player to reset any players on the server.
killstats.admin.createsign - Allow the player to create a leaderboard sign.

Below is a list of all the player permisisons. By default all of these are enabled.

killstats.player.startover - Allows the player to reset their own stats

Replacement Variables in configs

These variables can be placed in any message within messages.yml and be replaced with the appropriate data where applicable.

• %victim.name% - The victims name
• %victim.kills% - The victims kill count
• %victim.deaths% - The victims death count
• %victim.streak% - The victims kill streak
• %victim.ratio% - The victims k/d ratio
• %killer.name% - The killers name
• %killer.kills% - The killers kill count
• %killer.deaths% - The killers death count
• %killer.streak% - The killers kill streak
• %killer.ratio% - The killers k/d ratio

These variables are only applicable within the "TS_X" messages.

Example "TS_Chat_Format"

• %stats.playername% - Shows the playername
• %stats.value% - Shows how many kills/deaths etc they player has
• %stats.position% - Shows the rank of the player
• %stats.currentpage% - Shows the page that is being viewed
• %stats.maxpage% - Shows the max number of pages
• %stats.lastupdate% - Shows how many minutes ago the top stats were updated

This variable is used in the '/ks rank' command and on signs.

Replaced with the players rank, or the rank you choose on signs.

• %ranking%