PVP Stats

73k Downloads

You want to keep track of your users' PVP actions? There you go. Drop the jar into your plugin folder, restart the server, change the config, restart for good measure - done!

>> download for 1.7 and earlier <<
>> download for 1.8 through 1.12 <<

API Documentation: Code examples for developers (GitHub)

Latest Builds: Invite to my Discord

This plugin features saving of kills, deaths and killstreaks to a configurable database. If you do not have a database, it will default to YML. We recommend using SQLite, as the servers support it out of the box.

PVP Stats will create the databases for you! You just need to setup the database connection/settings in the config if you want to go for MySQL.

Commands: Detailed example pages (GitHub)

Permission nodes: Detailed table (GitHub)

FAQ:

Q: How do I change the placeholder colors?

A: You can change the formatting of player outputs, including placeholders, in the lang.yml, look for "format:", by default it is red (&c) and gray (&7).

Q: How do I change the numbered output?

A: In the same file, lang.yml, look for "numbers:" it contains only two things, the number area (%0%) and the values (%1%), if you don't like the colon, or want different formatting here, you can change this.

Q: I kill someone and the kill is not counted!

A: Did you just kill the same player earlier? There is an abuse check to prevent this. Set checkAbuse to false if you do not want that.

Q: I died by myself and it reset my kill streak!

A: You can disable this by setting preventRegularDeaths to false

Configuration: Commented config (GitHub)

Database options:

  • a MySQL database
    OR
  • SQLite installed
    FALLBACK:
  • YML Files (probably slow)

Recommended Holographic Leaderboard Setup:

I recommend using Holographic Displays and Holographic Scoreboards (I fixed a small startup issue for MC 1.13: download).

With these plugins, you can set up holographic displays for example /pvpstats top kills 10 - if you only want a representation of a top-(or flop-)leaderboard, I suggest you use this setup.

Example for top 6 kills scoreboard:

<span style="color: #008000;">/hgs create YourBoardName 1m console pvpstats top kills 6</span>
(Thanks to RafaelAuler for pointing me in this direction!)

Alternative Setup with Placeholders:

You need

Then you can create more detailed holograms with the PAPI placeholders.

Placeholder API Player Placeholders: Detailed examples (GitHub)

Credits:

  • pandapipino for the idea :)

Source: GitHub

Phoning home

To determine popularity and usage of PVP Stats, the server contacts my private server for information purposes. It sends your port, IP (for proper server counting), and the plugin version. That's it! If you want to disable that, set "tracker" to false in the config!