BeardStat

Table of Contents

BeardStat logo

BeardStat is statistics tracking plugin for bukkit. It tracks a wide variety of user statistics and makes them available to your playerbase and plugins.

Recorded stats

last Login and logout time
Total playtime
block placement and breaking (including sub/metadata blocks like wool, logs etc)
Items picked up/dropped
Damage dealt and recieved
Kills and deaths
Food consumed
Sheep sheared and dyed
TNT detonated
Distance travelled on foot/boat/cart/horse/pig
Items crafted
Animals tamed
Teleports
Fishing

Web interface (under development)

BeardStat also comes with a web interface for stats, this allows players to view their own and friends stats on your servers website. the Web interface also includes a scoreboard system to rank players based on various statistics (playtime, creepers killed)

Commands

Stats are recorded per world, and you can blacklist worlds/gamemodes from tracking. BeardStat also has a number of commands: * /stats - access to all stats information * /played - shows a players playyime. * /laston - Returns the last time the player was on * /statpage - Allows showing a selection of player stats, useful with Bukkit's command aliasing

Dev builds

Development builds of this project can be acquired at the provided continuous integration server.

These builds have not been approved by the BukkitDev staff. Use them at your own risk.

(Please note, zips in dev builds currently contain a broken implementation of the web interface, please instead download the .jar file instead. The web interface available on the right of this page) Development builds fresh from Jenkins

Issues

BeardStat has an issue tracker on github, https://github.com/tehbeard/beardstat/issues.

For error reports please include the following: * full stacktrace of the error * plugin version (inc. build number if using one from CI) * Bukkit version * Database type used (SQLite / MySQL)

Plugin integration

BeardStat provides a rich API for plugin developers to hook into BeardStat and read / record statistics.

For Developers

BeardStat stats are identifiable by a unique Id generated from 4 sub components: * Domain * World * Category * Statistic

Domain is the primary namespace for a collection of stats, the "default" domain is used by BeardStat, I ask that you use your own unique domain for your plugin (i.e. if you make a PvP arena plugin, you could use the domain "pvparena").
World represents the world in which this stat was recorded, these are for the most part the name of the world.
Two special cases exist however. "__global__" is a reserved world name, meant for stats that do not pertain to a world. The second case is "__imported__", this is a reserved world for stats that have been imported from an older version of BeardStat before per world storage was implemented.
While not intended, you can use the world id for a unique area that is not a whole world (Going back to our pvp arena example, you could use the arena names instead, such as old_forge, broken_bow instead of a world name)

Current plugins that are known to integrate BeardStat: * BeardAch - Achievements plugin * SimpleSpleef Evolution

Metrics

BeardStat includes the plugin metrics code developed by Hidendra (author of LWC), which collects anonymous information about the plugins deployment (minecraft, server, plugin version, assumed server location at country level and database type used by BeardStat, aggregated into graph form.) More information on this system, including how to disable it can be found here

Comments

_ForgeUser7660961
- Join Date: 10/6/2011
- Posts: 26
- Member Details
#159 _ForgeUser7660961

View User Profile

Send Message

Posted Jul 11, 2012
@1337minecrafer

no it doesnt and it wont because you cant put 1000 lines on a sign

Last edited by _ForgeUser7660961: Jul 11, 2012

Rollback Post to Revision RollBack
_ForgeUser7336661
- Join Date: 8/6/2011
- Posts: 120
- Member Details
#158 _ForgeUser7336661

View User Profile

Send Message

Posted Jul 10, 2012
Does this have (or can it have) some sort of signs showing stats that automatically update? If not I would really like this as players don't have to type any commands to see stats.

Rollback Post to Revision RollBack
_ForgeUser7660961
- Join Date: 10/6/2011
- Posts: 26
- Member Details
#157 _ForgeUser7660961

View User Profile

Send Message

Posted Jul 8, 2012
ah good to know thx for the info when could i expect that implemented?

Rollback Post to Revision RollBack
_ForgeUser7497716
- Join Date: 9/4/2011
- Posts: 269
- Member Details
#156 _ForgeUser7497716

View User Profile

Send Message

Posted Jul 6, 2012
@tomomosius

McMmo only offers up events for repairs and xp/lvl that i'd be able to track.

Ideally, the McMmo guys should be the ones who hook into BeardStat, but I should be able to make a bridge plugin that you drop in that passes these stats through.

Edit: further delving reveals I can get the xp and level of each skill. Now, provided they don't derp around the API, I should be able to get all the skills + any future ones easily w/o recoding on each release.

Last edited by _ForgeUser7497716: Jul 6, 2012

Rollback Post to Revision RollBack
_ForgeUser7497716
- Join Date: 9/4/2011
- Posts: 269
- Member Details
#155 _ForgeUser7497716

View User Profile

Send Message

Posted Jul 5, 2012
@tomomosius

Yes, there's a bug in grapefruit that makes the debug info for crafting stats show up even if debug is disabled.

Rollback Post to Revision RollBack
_ForgeUser7660961
- Join Date: 10/6/2011
- Posts: 26
- Member Details
#154 _ForgeUser7660961

View User Profile

Send Message

Posted Jul 5, 2012
this is from stats right? [INFO] ItemStack{WOOD x 4}

Rollback Post to Revision RollBack
_ForgeUser7660961
- Join Date: 10/6/2011
- Posts: 26
- Member Details
#153 _ForgeUser7660961

View User Profile

Send Message

Posted Jul 4, 2012
can you add mcmmo stats?

Rollback Post to Revision RollBack
_ForgeUser828069
- Join Date: 5/30/2008
- Posts: 95
- Member Details
#152 _ForgeUser828069

View User Profile

Send Message

Posted Jul 4, 2012
Hello,

How i can use a FR date time format :

generally i use

function dateFR( $time ){ setlocale( LC_TIME, "fr" ); return strftime( "%A %d %b %Y" , strtotime( $time ) ); }

How i can implement it easily ?

Last edited by _ForgeUser828069: Jul 4, 2012

Rollback Post to Revision RollBack
_ForgeUser8749090
- Join Date: 4/15/2012
- Posts: 173
- Member Details
#151 _ForgeUser8749090

View User Profile

Send Message

Posted Jul 3, 2012
@furdabip

I should start believing those readme files actually need to be read.

That API seems like a gift, also the huge amount of stats provided from the plugin, I am rly impressed.

Rollback Post to Revision RollBack
_ForgeUser8691068
- Join Date: 4/4/2012
- Posts: 15
- Member Details
#150 _ForgeUser8691068

View User Profile

Send Message

Posted Jul 3, 2012
@furdabip

Pouring lava/water from a bucket and picking up raw fish. Think that was it.

Rollback Post to Revision RollBack
_ForgeUser4086066
- Join Date: 2/24/2010
- Posts: 8
- Member Details
#149 _ForgeUser4086066

View User Profile

Send Message

Posted Jul 3, 2012
@nsordk

The API exists to do all this work for you. You can easily do this yourself using it, it's just that it doesn't have a built-in "stat box" thing - that needs to be done by the coder.

As a simple example (again, read the readme for info on the functions) you can do something like;

<?php require_once("beardstat.php"); BS_load_top_list("kills",0,"total"); while ($place = BS_next_top_list()) { echo suffix($place[0]).": ".$place[1]." with ".$place[2]."<br>"; } ?>
Rollback Post to Revision RollBack
_ForgeUser8749090
- Join Date: 4/15/2012
- Posts: 173
- Member Details
#147 _ForgeUser8749090

View User Profile

Send Message

Posted Jul 3, 2012
@vOneShot

You would be looking at doing a call to your database like:

SELECT * FROM stats WHERE category = 'kills' AND stat = 'total' ORDER BY value DESC LIMIT 20;
Last edited by _ForgeUser8749090: Jul 3, 2012

Rollback Post to Revision RollBack
_ForgeUser4086066
- Join Date: 2/24/2010
- Posts: 8
- Member Details
#146 _ForgeUser4086066

View User Profile

Send Message

Posted Jul 2, 2012
@S74Rshaped

Thanks!

Besides the gunpowder thing, what other errors were in it?

Also, the BeardAch Web API hasn't been a priority to me, sorry. At SOME point I will make it, I can at least promise that.

Rollback Post to Revision RollBack
_ForgeUser8691068
- Join Date: 4/4/2012
- Posts: 15
- Member Details
#145 _ForgeUser8691068

View User Profile

Send Message

Posted Jul 2, 2012
There were a few errors in format.ini that I have fixed. For example, gunpowder was called 'gunpowder', not 'sulphur' as its recorded in the db. Heres the updated file: http://dl.dropbox.com/u/17715694/format.ini

Whats the state of the achievements web page, on our server we have a web dev, any chance of getting a link for us to try it out?

Rollback Post to Revision RollBack
_ForgeUser4086066
- Join Date: 2/24/2010
- Posts: 8
- Member Details
#144 _ForgeUser4086066

View User Profile

Send Message

Posted Jun 30, 2012
@vOneShot

In order to customize the display of stats, you'll need to code it yourself. The default layout (index.php) can be read to see how that page is done. You'll need at least some knowledge of PHP, HTML, CSS, maybe even JS to make custom stat displays.

Read the readme.txt file that came with the BeardStat Web API to understand how to use the API properly. The functions you'll need to use are located in the Top Lists Functions category (shortcut: [FUNCTIONS_TOP]), though it is recommended to read the whole thing to better understand how it works. :-)

Rollback Post to Revision RollBack
_ForgeUser7981363
- Join Date: 11/30/2011
- Posts: 19
- Member Details
#143 _ForgeUser7981363

View User Profile

Send Message

Posted Jun 30, 2012
I gave 0.4.7 Honey beta a spin, and it seems to fix my pesky bug of stats being overwritten in YAML format. I'm very much looking forward to a stable release so I can move forward with my plans! :-)

Rollback Post to Revision RollBack
_ForgeUser9115340
- Join Date: 6/30/2012
- Posts: 1
- Member Details
#142 _ForgeUser9115340

View User Profile

Send Message

Posted Jun 30, 2012
Looking for a little assistance, I have created the following page, using the file given in the download,

http://www.craftboom.co.uk/forums/index.php?pages/stats/

I was hoping to create some sort of block on the homepage like the server status one on the right hand side, The block I plan to make would display be something like the top 20 slayers.

http://www.craftboom.co.uk/forums/index.php

Any ideas of this would be done?

Dan

Rollback Post to Revision RollBack
_ForgeUser7497716
- Join Date: 9/4/2011
- Posts: 269
- Member Details
#141 _ForgeUser7497716

View User Profile

Send Message

Posted Jun 29, 2012
@chaser66

Version? Copy of the config? Errors that appear on console?

Last edited by _ForgeUser7497716: Jun 29, 2012

Rollback Post to Revision RollBack
_ForgeUser6689318
- Join Date: 4/22/2011
- Posts: 1
- Member Details
#140 _ForgeUser6689318

View User Profile

Send Message

Posted Jun 29, 2012
Hi,

Is there a trick to get it working with mysql? Ever time I restart the server the config file restart to default and never use mysql, I check my DB and nothing is created :S, Anyone can help me?

Thanks in advance.

Rollback Post to Revision RollBack
Arcensoth
- Join Date: 6/14/2012
- Posts: 6
- Member Details
#139 Arcensoth

View User Profile

Send Message

Posted Jun 25, 2012
Hello, great plugin! I was wondering about certain case-sensitive variables/stats. In my BeardStats/stat.yml there is a variable for deaths via wolves but it is in upper case:

deaths-WOLF: 1

Does this have any implication on, say, BeardAch for referencing the stat as a threshold? For example, if you had an achievement that involved getting murdered by wolves:

triggers: - stat|deaths:wolf:1

Does it matter if this reference is also capitalized or not? I'd just like to confirm if this is an error, or perhaps just intentional for entities.

Also, is there an option to completely turn-off all stat-checking/adding while a user is in a certain group? For example, if I switch myself from the usual "player mode" to "editor mode" (by changing groups) I would not have my stats modified while in this group. I've considered doing this with permissions, and simply denying that users in the editor group have access to the BeardStat permission that allows having stats added (something you might also have for Guests) - the only problem is that I can't find these permissions! Do they exist and I'm being ignorant, or should I consider this a suggestion? x) (Perhaps a section in the BeardStat config file smiliar to the "worlds" section, for example, but instead of listing exempt worlds it lists exempt groups.)

(I had a couple of questions for you regarding BeardAch as well, so I moved them to that suggestion board.)

Thank you. =]
Last edited by Arcensoth: Jun 25, 2012

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

Project ID

32313
Created

Sep 21, 2011
Last Released File

Sep 5, 2013
Total Downloads

12,979
License

Beard License

Bukkit

BeardStat

Bukkit Plugins

BeardStat

Table of Contents

Recorded stats

Web interface (under development)

Commands

Dev builds

Development builds of this project can be acquired at the provided continuous integration server.

These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Issues

Plugin integration

For Developers

Metrics

Comments

About This Project

Categories

Members

Recent Files

Bukkit