Getting Started

For this plugin to work, you need to already have a web server yourself! It is mainly meant for people that already have a website for their Minecraft server.

On Minecraft server

1. Download the .jar file from the latest release and place it in the plugins/ folder, like you would with any plugin.
   (note: if you downloaded from the Spigot resources page, you will get a .zip file with the files needed for both the minecraft server and the web server)

2. Open a port for the plugin to communicate over.

3. Restart your server to let it generate the config file. Change the port number in plugins/WebStats/config.yml to the one you opened in the previous step.

On Web server

1. Download the web.zip file from the latest release, and upload the .js files to a directory on your web server.
   (note: if you downloaded from the Spigot resources page, the files you need are in that zip file, along with the .jar)

2. Have a look at /web/example/index.html. It contains a basic starting point for you to use, along with some nice-to-have features. The most important things are:

   1. Include the JavaScript files
   2. Initialise WebStats when the page is loaded

Further steps

WebStats can gather statistics from multiple sources: the scoreboard, PlaceholderAPI and MySQL databases.

Scoreboard

By default only the scoreboard source is enabled. In order to populate the scoreboard, you will need other plugins or datapacks, like VanillaTweaks track (raw) statistics.
Since this is the simplest source, there is not a lot of configuration possible. You can list the scoreboard objectives you want to display in the objectives config file item. If you add '*' (default), the plugin will gather all objectives.

PlaceholderAPI

The PlaceholderAPI source is disabled by default. You need to uncomment placeholders in the config file to enable it. You can specify which placeholders to use and give the name of their columns.
Since many placeholders are not available for offline players, WebStats offers a way to store these when players are online so that they are still visible after players go offline. To do this, WebStats needs a database to store the placeholders in. Set store-placeholders-database to the name of the database to use for this and fill in the database access fields as mentioned in that link.

MySQL Database

Disabled by default. If you have a plugin that stores its data in a database but does not expose that through for example the PlaceholderAPI, you can use this to directly read from that database. You first need to fill in the database access details (hostname, username and password). Then, you can add a configuration for each table to read from. More detailed info can be found on the MySQL database connectivity page.