PVP Stats

Table of Contents

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

PlaceholderAPI
Holographic Displays
Holographic Extension
Dependencies of the plugins above

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!

Comments

FloowFs
- Join Date: 12/6/2021
- Posts: 1
- Member Details
#494 FloowFs

View User Profile

Send Message

Posted Dec 6, 2021
for some reason it doesnt support the PAPI Placeholders on my scoreboard,
any idea? :o

%pvpstats_kills% %pvpstats_deaths% %pvpstats_elo% %pvpstats_killstreak% %pvpstats_maxstreak%
Rollback Post to Revision RollBack
NotFirelex
- Join Date: 4/16/2021
- Posts: 1
- Member Details
#491 NotFirelex

View User Profile

Send Message

Posted Apr 16, 2021
Is there a way to change the rank of the player in the placeholder slipcorpvpstats_top_kills_1 by something else like a symbol * because it don't fit in my scoreboard
I can change the color of the player's rank but that's all I can do...

Last edited by NotFirelex: Apr 16, 2021

Rollback Post to Revision RollBack
slipcor
- Join Date: 7/9/2011
- Posts: 643
- Member Details
#492 slipcor

View User Profile

Send Message

Posted Apr 16, 2021
In reply to NotFirelex:

Well the rank is pasting a number into two language setting nodes:

first it places 1) name and 2) value [kills in your case] into the "info:" node,

then this gets put as 1) number and 2) above text into the "numbers:" node

Note that as this is coding stuff number 1) is %0% and number 2) is %1% :D

Rollback Post to Revision RollBack
slipcor
- Join Date: 7/9/2011
- Posts: 643
- Member Details
#493 slipcor

View User Profile

Send Message

Posted Jul 6, 2021
In reply to NotFirelex:

you can now change the placeholders to be much shorter, check out the github for more info, and update the plugin to a version above v1.11.18 before trying :D

You might have to wait for my file to be approved. Then: click me

Rollback Post to Revision RollBack
DoritozB
- Join Date: 11/14/2017
- Posts: 4
- Member Details
#490 DoritozB

View User Profile

Send Message

Posted Jan 17, 2019
Hi, I just need to add monsters kill counter support as well and it would be perfect for me
Rollback Post to Revision RollBack
_ForgeUser21835522
- Join Date: 9/19/2015
- Posts: 9
- Member Details
#487 _ForgeUser21835522

View User Profile

Send Message

Posted Jan 16, 2018
Works Perfectly, Can you put a variable like {kills} because i want to use it in Essentials Chat

Rollback Post to Revision RollBack
TheCactusMonkey
- Join Date: 8/10/2017
- Posts: 3
- Member Details
#488 TheCactusMonkey

View User Profile

Send Message

Posted Jul 6, 2018
In reply to Al3rb:

You can use those placeholders for this plugin:
%pvpstats_kills%
%pvpstats_deaths%
%pvpstats_elo%
%pvpstats_killstreak%
%pvpstats_maxstreak%

Rollback Post to Revision RollBack
_ForgeUser11670536
- Join Date: 6/15/2013
- Posts: 13
- Member Details
#486 _ForgeUser11670536

View User Profile

Send Message

Posted Nov 19, 2017
It`s not working for some reason.

When I do /pvpstats it says player not found. No error in console. I don`t know what to do

Rollback Post to Revision RollBack
Ji_Rath
- Location: NJ
- Join Date: 8/26/2011
- Posts: 4
- Member Details
#485 Ji_Rath

View User Profile

Send Message

Posted May 22, 2017
Great plugin, but I ran into some issues. Whenever players join, the server lags a bit and stutters. As shown in the timings, https://timings.aikar.co/?id=e8e0d73d7d1442f28059e79d2e5c2cc0 . This timings was taken during a stress test where multiple accounts would join then leave. Can we expect a solution or is it not possible?

EDIT: I can't get the plugin to update the ELO score after dying/killing a player. I have made sure the world is not disabled, and that the plugin is updated, any help would be appreciated.

Last edited by Ji_Rath: May 25, 2017

Rollback Post to Revision RollBack
_ForgeUser29738376
- Join Date: 12/28/2016
- Posts: 1
- Member Details
#483 _ForgeUser29738376

View User Profile

Send Message

Posted Dec 28, 2016
it says

mysql connection failed

mysql disabled, plugin disabled

Rollback Post to Revision RollBack
slipcor
- Join Date: 7/9/2011
- Posts: 643
- Member Details
#484 slipcor

View User Profile

Send Message

Posted Dec 29, 2016
Well, did you check that the connection details are correct? Without a mysql database, the plugin will not do anything, so it disables.

Rollback Post to Revision RollBack
_ForgeUser29469914
- Join Date: 12/14/2016
- Posts: 13
- Member Details
#481 _ForgeUser29469914

View User Profile

Send Message

Posted Dec 16, 2016
Do you know if this works with MC 1.11 or do you plan to update for 1.11? Thanks

Rollback Post to Revision RollBack
slipcor
- Join Date: 7/9/2011
- Posts: 643
- Member Details
#482 slipcor

View User Profile

Send Message

Posted Dec 16, 2016
it should work. if not, please tell me what does not and I will try to check. Sadly I have no server (with database) so I need info about what does not work or what kinds of errors you get

Rollback Post to Revision RollBack
_ForgeUser11863840
- Join Date: 7/15/2013
- Posts: 107
- Member Details
#480 _ForgeUser11863840

View User Profile

Send Message

Posted Oct 21, 2016
@SLiPCoR

I purge the database once a week as I use this plugin for weekly stats. To purge I run this command every sunday:

pvpstats purge both 0

Last edited by _ForgeUser11863840: Oct 21, 2016

Rollback Post to Revision RollBack
slipcor
- Join Date: 7/9/2011
- Posts: 643
- Member Details
#479 slipcor

View User Profile

Send Message

Posted Oct 13, 2016
@jet315

did you look into purging the database? Maybe you can remove some things, based on time?

Rollback Post to Revision RollBack
_ForgeUser11863840
- Join Date: 7/15/2013
- Posts: 107
- Member Details
#478 _ForgeUser11863840

View User Profile

Send Message

Posted Sep 25, 2016
Hi, "PSListener::onPlayerDeath(PlayerDeathEvent)" from this plugin seems to be causing quite bad lag on my server. Timings show PCT tick at 470%. I use a locally hosted MySQL setup for this plugin

Rollback Post to Revision RollBack
anemul2663
- Join Date: 1/30/2011
- Posts: 54
- Member Details
#477 anemul2663

View User Profile

Send Message

Posted Aug 31, 2016
@SLiPCoR

It did turn out that the database I was using , was sluggish at times . The database isnt a problem no more , as I finally installd a local mysql .

Rollback Post to Revision RollBack
slipcor
- Join Date: 7/9/2011
- Posts: 643
- Member Details
#476 slipcor

View User Profile

Send Message

Posted Jul 29, 2016
@ChimpGamer

What does it say when the server starts, does it say anythign about pvpstats at all? Check your config setting about your SQL server

Rollback Post to Revision RollBack
_ForgeUser23481353
- Join Date: 1/29/2016
- Posts: 33
- Member Details
#475 _ForgeUser23481353

View User Profile

Send Message

Posted Jul 27, 2016
Sorry but the plugin doesnt even work it doesn't register any kill or death or anything and no error in the console

Rollback Post to Revision RollBack
slipcor
- Join Date: 7/9/2011
- Posts: 643
- Member Details
#474 slipcor

View User Profile

Send Message

Posted Jul 22, 2016
@hichay

1) it should update instantly when stuff happens

2) so the database stays empty? What does the log say?

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

32908
Created

Oct 12, 2011
Last Released File

Jun 4, 2022
Total Downloads

81,850
License

GNU General Public License ver...

Bukkit

PVP Stats

Bukkit Plugins

PVP Stats

Table of Contents

API Documentation: Code examples for developers (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:

Recommended Holographic Leaderboard Setup:

Alternative Setup with Placeholders:

Placeholder API Player Placeholders: Detailed examples (GitHub)

Credits:

Source: GitHub

Phoning home

Comments

About This Project

Categories

Members

Recent Files

Bukkit

PVP Stats

Bukkit Plugins

PVP Stats

Table of Contents

API Documentation: Code examples for developers (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 falseConfiguration: Commented config (GitHub)

Database options:

Recommended Holographic Leaderboard Setup:

Alternative Setup with Placeholders:

Placeholder API Player Placeholders: Detailed examples (GitHub)

Credits:

Source: GitHub

Phoning home

About This Project

Categories

Members

Recent Files

Bukkit

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)