Code Monkey home page Code Monkey logo

minetrack-s's Introduction

Minetrack

Minetrack makes it easy to keep an eye on your favorite Minecraft servers. Simple and hackable, Minetrack easily runs on any hardware. Use it for monitoring, analytics, or just for fun. Check it out.

This project is not actively supported!

This project is not actively supported. Pull requests will be reviewed and merged (if accepted), but issues might not be addressed outside of fixes provided by community members. Please share any improvements or fixes you've made so everyone can benefit from them.

Features

  • ๐Ÿš€ Real time Minecraft server player count tracking with customizable update speed.
  • ๐Ÿ“ Historical player count logging with 24 hour peak and player count record tracking.
  • ๐Ÿ“ˆ Historical graph with customizable time frame.
  • ๐Ÿ“ฆ Out of the box included dashboard with various customizable sorting and viewing options.
  • ๐Ÿ“ฑ(Decent) mobile support.
  • ๐Ÿ•น Supports both Minecraft Java Edition and Minecraft Bedrock Edition.

Community Showcase

You can find a list of community hosted instances below. Want to be listed here? Add yourself in a pull request!

Updates

For updates and release notes, please read the CHANGELOG.

Migrating to Minetrack 5? See the migration guide.

Installation

  1. Node 12.4.0+ is required (you can check your version using node -v)
  2. Make sure everything is correct in config.json.
  3. Add/remove servers by editing the servers.json file
  4. Run npm install
  5. Run npm run build (this bundles assets/ into dist/)
  6. Run node main.js to boot the system (may need sudo!)

(There's also install.sh and start.sh, but they may not work for your OS.)

Database logging is disabled by default. You can enable it in config.json by setting logToDatabase to true. This requires sqlite3 drivers to be installed.

Docker

Minetrack can be built and run with Docker from this repository in several ways:

Build and deploy directly with Docker

# build image with name minetrack and tag latest
docker build . --tag minetrack:latest

# start container, delete on exit
# publish container port 8080 on host port 80
docker run --rm --publish 80:8080 minetrack:latest

The published port can be changed by modifying the parameter argument, e.g.:

  • Publish to host port 8080: --publish 8080:8080
  • Publish to localhost (thus prohibiting external access): --publish 127.0.0.1:8080:8080

Build and deploy with docker-compose

# build and start service
docker-compose up --build

# stop service and remove artifacts
docker-compose down

Nginx reverse proxy

The following configuration enables Nginx to act as reverse proxy for a Minetrack instance that is available at port 8080 on localhost:

server {
    server_name minetrack.example.net;
    listen 80;
    location / {
        proxy_pass http://localhost:8080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
    }
}

minetrack-s's People

Contributors

cryptkeeper avatar dependabot[bot] avatar mjezek-dev avatar hugmanrique avatar eazyftw avatar minecrafter avatar redned235 avatar theminecoder avatar nothub avatar merded avatar tehneon avatar andrew1481432 avatar gianscode avatar hbrombeer avatar rmlyy avatar 0xs2 avatar moom0o avatar itzwam avatar chatasma avatar supaham avatar evoltr avatar winsdominoes avatar titanicfreak avatar telfrancesco avatar techcable avatar arjenpro avatar herrsammyde avatar niklaswa avatar minidigger avatar marcdif avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.