PlayerStatistics

PlayerStatistics is an all inclusive plugin that is designed to track a range of statistics and provide an experience and leveling system for these statistics.

Before installing this plugin you should note that it is in beta, and still being heavily developed. Bugs are to be expected. You also should be prepared to have to wipe player statistics. While I will seek to not change the core data collected, it could happen due to new futures implemented.

The plugin currently records the following stats:

From this point on, any command argument wrapped with <> means optional while () means required.

The plugin currently supports three commands:
/xp <player-name>
Returns a chat message with currentxp/xp needed and player level.

Permissions:
- playerstatistics.xp.self
- playerstatistics.xp.others
If the arguments aren't provided, the player will self check their stats.

An example of a self check message:

An example of checking another player's level:

/stats <player-name>
Opens a GUI of collected statistics.
Permissions:
- playerstatistics.stats.self
- playerstatistics.stats.others

An example of an opened GUI:

/levels
Open a GUI containing items that have names corresponding to the level and the xp required
Permissions:
- playerstatistics.levels

The plugin also supports a built in API server to serve player data. This feature is catered towards developers than want to have their website display data, or have a discord bot to display data. If you're not going to do any of these, keep the proxy setting toggled off.

For now, the only api endpoint is
{yourip}:{yourport}/api/v1/players/player?user={player}

Note, that if you set the port to HTTP/S or the parent port of your server, an error will be thrown and the proxy won't start.

As this plugin is in heavy development, I'll just drop a todo list here:
[-] Add achievements
[-] Add leaderboards
[-] Add API endpoints for both
[-] Create developer API to add custom stats
[-] Add misc things like toggleable chat options, abilities, etcetera
[-] Add SQL support

Note, that I do not plan to add the ability to edit stats. Maybe I would add partial support for stats the plugin itself tracks, but most of the stats are pulled from MC's stats itself, and the data is updated right before the command is executed.

If you have any suggestions or issues, please report them to me via discord: Austin#9949