Rank
Ranks
Count your blocks and get ranks!
Info
Please post a ticket, if you encounter any issue!
Overview:
This plugin will count many things, your players are doing and display them on a website:
Players can track their stats server-independent and can compete on a more global level. Later on, players can use the site to show it as a portfolio and proof of work/experience!
Players can view their statistics ingame with "/ranks".
You can change and localize all output of the plugin in locale.dat
For adding a sign with your name:
- Line 0:[Ranks]
- Line 1:yourname
- Line 2:Will be Block-Break
- Line 3:Will be Block-Place
Configuration
All plugin settings can be configured in config.yml.
Here is the default configuration as of Version 2.1.11:
#Bukkit deletes comments if you change something, this it the default-configuration! #enable the plugin? enabled: true #enable stats-tracking #if false, this renders the plugin useless! stats-tracking: true #auto-updates the plugin. Old versions will not be supported after some time! auto-update: true #if you prefer to give me usage-informations, please enable this. Has no effect on the plugin! enable-metrics: true #prints out optional data verbose: false #prints out debugging informations debug: false #here you can select your method of storage #MySQL is prefered, if false, sqlite will be used! Use MySQL: false #If used, here you can set your mysql-login! MySQL: MySQL-Database: DB MySQL-Hostname: localhost MySQL-User: user MySQL-Password: pw
You can see how the plugin interprets this configuration in the image below:
Stats tracking
This plugin depends on tracking your data. And i want to make this process as transparent as possible!
Below you can find all things i will track and for what they are used. If you have any question, feel free to drop me a pm!
All public view-able data can be seen at http://mcranks.org and there you can see, how your data will be displayed! If you have set enabled or stats-tracking to false in the config.yml nothing will be tracked by my plugin!
Name | Since Version | Used for | visibility |
---|---|---|---|
Server IP | 2.0.1 | Fraud protection | private |
Broken blocks per Player and Block type | 2.0.1 | Stats tracking | public |
Placed blocks per Player and Block type | 2.0.1 | Stats tracking | public |
Online Players | 2.0.3 | Stats tracking online time | public |
Plugin Version (server<->BukkitDev) | 2.0.3 | Update Checking | on your server |
Player Movement | 2.0.4 | Stats tracking Blocks walked | public |
Experience gained per Player | 2.0.4 | Stats tracking | public |
Downloading newest ranking | 2.0.5 | Ingame commands | on your server |
Killed entities per Player | 2.1.15 | Stats tracking | public |
Damaged entities per Player | 2.1.15 | Stats tracking | public |
Performance
SQLite in its nature is much slower than MySQL, so if you have a server with many players, you should consider using MySQL!
My plugin has to track many events that are happening on your server. It also has to upload all this data. This task can bring in many performance issues if implemented poorly (I/O in main thread etc.). I am trying to create a plugin, that in no way will impact the performance of any server you run it on. But there will be things i did not thought about, so if your server has issues with my plugin, please post a ticket explaining the problem.
Rest assured, that no networking is done on the Bukkit main thread and stats are highly cached, so it is normal for them to take some time, until they are viewed on the server.
Plugin Metrics
Also, beginning with version 2.1.1 there will be PluginMetrics included. The data collected by Metrics can be viewed at http://mcstats.org/ and you can always opt-out by changing enable-metrics to false in config.yml!
What is exactly read/sent by Metrics? (Copy from the metrics website)
It is not possible for Metrics to control the plugin in any way except for plugin-specific code the plugin author implements. Nothing is downloaded, so what you get is what the plugin author implemented.
The following data is read from the server in some way or another:
- File Contents of plugins/Plugin Metrics/config.yml (created if not existent)
- Players currently online (not max player count)
- Server version string (the same version string you see in /version)
- Plugin version of the metrics-supported plugin
- Mineshafter status - it does not properly propagate Metrics requests however it is a very simple check and does not read the filesystem
The following data is sent to http://mcstats.org:
- Metrics revision of the implementing class
- Server's GUID
- Players currently online (not max player count)
- Server version string (the same version string you see in /version)
- Plugin version of the metrics-supported plugin
- Any custom data the supporting plugin implements. This is variable and I am not responsible for this however usually it is just plugin-specific data (e.g for LWC, the database type: MySQL or SQLite, and Locale used (english, german)).
Update checking:
This plugin will automatically check for updates and keep your version up to date. You can disable this in the config by setting auto-update to false. But since api-features will change, after some time, old versions will not work anymore! So please update!
View on the future
If you dislike this change, go ahead and download my 1.1.0 Release and you have the last offline-version of my plugin.
http://dev.bukkit.org/bukkit-plugins/ranks/files/3-version-1-1-0/
This change is the first one in a series of bigger changes! I stated, that i want this plugin to be more a stats/ranks-plugin than simple counting of blocks. Your rank is now server-independent! And i will track more things like, kills, deaths, distance walked, exp collected, objects crafted, drops collected etc. I think, there are many things worth counted. And server-owners can give People rewards/permissions based on how high their rank is.
Features:
- Counts several statistics
- Dynamic scoring based on all players
- Will auto-check on startup for new updates!
- Players can view their score ingame
- You can place signs who will display your Rank to all Players passing by
ToDo:
- Rise custom levels (and get something from it)
- Add new things to track
- Overhaul Website to get detailed statistics!
KnownIssues:
none of today
This Is SoAWESOME MAKE A #2
@Naverholten
simply look inside the configuration file? Or look at the main page of this plugin, where you should be at the moment ;)
@Kostronor
How would I go about changing the sqlite to mysql?
@Naverholten
Hey, thanks for the bug report! The flooding message is already fixed in 2.1.2 so you can use this version.
To your Stacktrace: The plugin was designed around mysql but it seems, most people use sqlite over it. Because sqlite is slow, i am using a different thread to update things, but if the database cannot keep up with the new events, this will accumulate over time! Switching to mysql will solve this issue, in the meantime I will try to find a way to ignore updates the server cannot handle!
Hey so i recently had a server crash and i believe it was this plugin that caused it, although im not entirely sure as i can't interpret the crash report well enough, for a few days (since i installed the plugin) ive been getting a "material not unique" error with a few more lines beneath it and it floods my server console with it every few seconds, it didnt seem to cause any problems so i left it alone, although i got this today and i am assuming its your plugin as I havent had any problems with my server like this until now..
1st half of crash report:
http://pastebin.com/k8LC70wb
2nd half of crash report:
http://pastebin.com/rwcmXELZ
@KingFaris10
I am making sure that it is not! Protection plugins have much more things they need to log and they are working. You won't notice my plugin...
Isn't this very server-intensive? I'm not sure, but if it's logging so many things...
@SomaKhaos
Hey there,
please use a ticket for support!
i have my server running R03 with mysql and i am having no errors...
please please write a ticket... And include your startup log with one minute time ahead!
Hey there
I really want to use this plugin, but it doesn't work for me :(
I have an Bukkit Server on 1.7.2 R0.3 and the plugin doesn't count any of my breaks or places of blocks. And using my MySQL Database
In the Database i can see, there are changes and there he counts every block break and place, but it is not showed up in-game.
And the only thing your website is showing me are my online time and my distance
are there any permissions for this plugin, or how does it work?
I can't get it to work
@JaackMC
Hey TheChunkWorld, Thanks for telling me that! I will look at it and see if there is something obviously wrong, can you provide me with a test-server if it could be a problem with your server? http://dev.bukkit.org/bukkit-plugins/ranks/create-ticket/?comment=2021128
Edit: Version 2.1.7 should fix your issues!
If someone else is encountering bugs, laggs or errors, please open a ticket!
Crashes servers easily. Everything is fine until you run /ranks then it lags out.
I have found some bugs in the 2.0.5 Release, that could stop the plugin from totally working! To all the people, who tried it out yet: You have to delete all mysql-tables created by the plugin, the new version 2.1.0 will recreate them and solve these issues!
Also, i have added support for sqlite, so the plugin can work 'out of the box', i have added a new toggle to disable the plugin completely, if you want to use it, you have to add it to the config, it is enabled by default, so don't worry!
If you want to fix your MySQL-databases, please use this SQL-snippet on your database and after that restart the server!
@Danteland
i would have to manually parse the output of logblock...
This would be a one-time-conversion that could be done, i will try something out there!
Looks cool, but could you make it possible to merge with logblock so all the already mined blocks since before this plugin was installed also can be counted?
Hey all,
after some issues with my builds i hope i have it all sorted out now :)
A release version is waiting for approval at the moment, but you can use the approved Beta-Build if you want to be the first! The Release-Build will have an auto-updater that keeps Ranks up to date without you having any hassle! You can deactivate this in the "Update"-Folder in your plugins-folder!
The Beta-Build uses synchronous Connections and can lag your server, if you have a huge playerbase or a slow connection! This is fixed in the release!
please give me feedback!
For the overenthusiastic: Link Removed , file needs approval... this build uses URL_Connections! It will communicate with my website to keep track of your players archievements! they can be viewed here: http://ranks.marv-productions.de/
If there is someone with mad webskills, please contact me for a better website!
/* I will upload a finished build soon, but until then, you can let your Players have some starting Ranks with this build!
@Kostronor
Thank you :)
Doing a huge workover on the plugin now! please stand by for mysql and working online-stats :)
Thank you for update:) Any recent plans for mysql? Database is kinda huge, and lags server when top ten is asked :(
Thanks !
Hey Kostronor!
Great Plugin. Its on my server and i think its great. I have uploaded a plugin showcase of it here.
http://www.youtube.com/watch?v=-4vVYGBJ5uM
if you don't like it i can take it down.
Sincerly MrDATMAN2011