ActivityHistory
Activity History
This plugin allows you to monitor who is active and when. If you also use Vault, it will log the permission group ratio. It will help determine who to make staff by supplying you with reliable information about who is often online when staff is needed. It has a variety of log query commands to interpret the information stored.(in development)
News:
- This plugin will be ported to vanilla, but this project is abandoned due to the shutting down of Bukkit.
- Web applet in beta!
- Group queries for SQL mode in beta!
- SQL mode released! Group queries for SQL still being developed.
- Localization feature added. If you would like to contribute a language, translate the en-us.yml file in the jar and submit it in a ticket.
- As of v0.1.3 /ahplayer will no longer work!
- Having a banner contest. Submit a ticket with the banner. If I like it, it will become the official banner and you will be added to the donor/contributor list. See here for details.
Upcoming Features:
- Converting files to yaml format
- Further develop group queries
- New way to display data (brand new mechanic!)
- Web app to show graphs of the data collected
- Automatic config updater
- Continual mode
- Ability to autokick inactive players from factions.
- Custom metrics?
- Ability to ignore afk players using essentials
- More configurables?
Current Commands:
- /ppercent <player> [start [end]] ["at" hour]: Shows the percent of online time between <start> and <end>. Restrict the search to a certain time using <hour>.
- /ptotal <player> [start [end]]: Shows the total online time between <start> and <end>.
- /phours <player> [start [end]]: Shows the percent of online time between <start> and <end> by hour.
- /ahrestore <date/time> - adds data from before the time specified from flat files to the database
Upcoming Commands:
- /online <player> <date/time> ["within" minutes] - checks records if player was online during the period specified; the within param defaults to the survey interval
- /online <player> between <date/time> <date/time> - checks records if player was online during the period specified
- /gpercent <group> [start [end]] ["at" hour]: Shows the percent of online time between <start> and <end>. Restrict the search to a certain time using <hour>.
- /staffdist [start [end]] - Shows the average percent of players that are staff during each hour of the day.
- /ahclean <date/time> - erases data from before the time specified
- /ahdump <date/time> - saves data from before the time specified to a flat file and removes it from the database
- /ahbackup <date/time> - saves data from before the time specified to a flat file without deleting it from the database
Notes:
- params in <> are required, params in [] are optional, params in "" should be typed word for word
- <time> uses format hh:mm:ss, <date> uses format MM/DD/YY, <date/time> uses format MM/DD/YY-hh:mm:ss, <hour> is an integer from 0 to 23.
- Example timestamps: 1/1/00-0:30:00, 3/24-5:10, 5/12-4, 3-18:20
- gpercent and staffdist require Vault
Permissions:
- ah.query.player - allows checking of player activity
- ah.query.group - allows checking of group distribution
- ah.admin - includes all of the above plus log cleaning
Contributors:
- Carmeops (IGN) - French localization
Milestones:
- As of August 8, this plugin is on the top 1000 plugins on Metrics!
- This plugin stayed on the top 1000 for at least 1 week April 11-20 2014!
Known Bugs:
The code for group queries is not as developed as player queries and may not work correctly.
Metrics:
This plugin utilizes Hidendra's plugin metrics system, collects information such as:
A unique identifier
The server's version of Java
Whether player authentication is enabled
The version of the server and plugin
The OS version/name and architecture
The core count for the CPU
The number of players online
The Metrics version
Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true
Source Code: https://github.com/psychic94/ActivityHistory/
An update is currently in the works. You can speed up development by sending test data. For file mode users, simply zip the player logs and send the archive. For SQL mode users, go here for SQL dumper downloads and instructions. Then zip the dump files and send them to me. PM me for my email address.
update coming?
Version 0.2.4 has been deemed unfit for use. It is strongly advised to downgrade immediately.
@psychic94
I'm getting: http://pastebin.com/QpMBwJSB When issuing /ptotal player and /ppercent player /phours doesn't throw an error but doesn't have anything but 1% on all records Using 0.2.4.
Haven't tested sql mode yet, but I assume you hadn't had enough time to fix it, just take your time, don't rush it. :D
@UnDrac Thanks. I had some free time between classes. In that time I converted the timestamps you gave. 64512536400000 converts to Apr 27 4014 17:00:00. That would definitely explain why there are no results.
Update: The time string doesnt have support for a 4 digit year. I was able to find time to fix this and make the system a little more accurate. The new version should be up shortly.
@psychic94
Alrighty ... I'll go ahead and test it to see if it works, GL on your finals.
@UnDrac There wouldn't be an error anyway, this looks like a mistake in the calculation algorithm. The coming week is finals week, so I dont have much spare time right now. Just downgrade to 0.2.2 for now and Ill look into this as soon as possible.
Noticed an issue with v0.2.3, When using SQL mode it doesn't seem to create any new tables within the database, and every time I try to use /ptotal /phours /ppercent all I get is "Player queries are disabled at this moment".
Using file mode it creates the logs but every time I try to use those commands again I get:
And using them without any date/time
The log file currently has only one player with 3 entries
Note debug is set to advanced to see if it gives off any error so this is about all I can supply.
A beta version of the web app has been uploaded! Go to http://dev.bukkit.org/bukkit-plugins/activityhistory/pages/graph-web-applet/ to find out how to install it.
Hello, We updated to the latest version of the plugin and we are getting an error trying to look up the total played time. http://pastebin.com/1jh1YJip
@shadowwalker97 You are putting the day before the month. It should be the other way around. As for the percent of the sum of the players' ontime, I'll look into it next time I update the plugin.
Hey, could you make some examples on commands cause it seems that they not always really work... at least for me.
The first command works just fine, but the second doesn't for some reason.
So my request would be could you write some examples where you show how to use the commands. Also it took me some time to understand that percentage since I thought it was percentage of server uptime and not percentage of the playtime of all players combined.
Thanks in advance.
I've decided to go through with the SQL mode. It should be fun to implement.
Done. We love this plugin.
Please vote on the poll so I know if I should bother taking time out of my homework to make SQL mode.
The new update (1.4.1) is not needed unless you plan to use the french localization. The french localization doesnt work. Don't bother downloading 1.4.1 at all.
@psychic94
I can help :)
I've worked with the pain which is MySQL for a couple years now.
@x_clucky Well if you can call yourself an amateur you're better than me. All I know about databases is ERDs and normalization.
@psychic94
Sorry about that, I meant when do you think it will be done xD I'd love to help with MySQL, but I'm barely good enough to call myself an amateur. lol
@x_clucky When you said EDT, I thought you meant Eastern Daylight Time lol. No, I do not have events. However, I am developing a web applet that sends requests to the server and displays a graphical representation of the data. See the pages tab at the top.