Skip to content

marousta/mcstats

Repository files navigation

Nest Logo Nest Logo Nest Logo Nest Logo Nest Logo

Description

Minecraft server informative and statistic web app.

Can support theoretically an infinite number of servers with minors tweaks.

Only tested in docker containers.

Features

  • Support for Java and bedrock servers using GeyserMC (currently 2 servers simultaneously)
  • Web app adapt itself based on backend API response
  • Show online players with their skin in real time (thanks to PlayerDB)
  • Display graphs for server uptime, players logtimes and players count history with ChartJS
  • Graphs have customized hover tooltips for a better UX
  • Navigation links for Dynmap and/or Bluemap

Example

Home page

Home page

Graphs page

Graphs page

Running the app

  • Fill the 3 required enviroment files. Don't worry everything is explained in templates.
  • Include your external networks in the docker compose file and link them to backend

(Don't forget, it's a compose deployment so every IPs must be a DNS entry resolvable by docker)

# production
# (build and serve static files)
$ docker compose up

# development
# (every ports are mapped on localhost and live reload is enabled)
$ docker compose -f docker-compose.dev.yml up

Additional notes

My vscode settings are in the repository in order to have the same environment/formatting in case of pull requests and such.

I don't guarantee to maintain this repo.... feel free to fork it but don't forget to credit, thanks you.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published