Skip to main content

LoopMC Stats Website Addon

The Stats Website Addon is a separate Paper plugin. It hosts a public player statistics page with search, profiles, leaderboards, and history charts.

Install the plugin​

  1. Download the separate LoopMC Stats Website Addon from your BuiltByBit purchases and locate its loopmc-stats-*.jar. The main LoopMC setup download does not include this addon.
  2. Stop your LoopMC server and upload the JAR directly to its plugins folder. Do not extract it.
  3. Start the server. The addon needs LoopCore, Vault, and PlayerPoints, which are included in the setup. It creates plugins/LoopMCStats/config.yml on first start.
  4. Open http://YOUR_SERVER_HOST:8081/stats to check the page. Replace YOUR_SERVER_HOST with your server's reachable host or IP address.

The plugin runs its own website on port 8081 by default. If you access it directly, allow that port through your host's firewall or panel. For an HTTPS domain, route the domain through a reverse proxy to port 8081 and set web.host: 127.0.0.1 in the plugin config. If port 8081 is already in use, choose another web.port.

Customize the page​

Edit plugins/LoopMCStats/config.yml, then run /loopstats reload as an operator. Set server-name and server-address to your server's name and player join address. To show an icon, set server-icon-url to an HTTPS image URL. primary-color controls the main accents, while stat-colors controls individual charts and cards. The default Money color matches LoopMC's red primary color. The site section controls page text, section labels, and the initial stat and leaderboard.

The page reads money from Vault, Gems from PlayerPoints, and kills, deaths, playtime, mob kills, and mined blocks from Bukkit statistics. Placed blocks are estimated from Bukkit item-use counts for block items, so this figure may differ from the number of blocks actually placed.

History starts when the addon first runs. It records a new snapshot every five minutes by default, so charts will fill in over time; it cannot show activity from before installation. The website and its read-only endpoints are public.

If the page does not open, check that the plugin enabled in the server log, the configured port is free, and the port or reverse proxy is reachable. If you update the JAR later, an existing config.yml is kept; edit it directly to apply new default colors or icons.