aoirint_mcping_server logo

aoirint_mcping_server

by aoirint

This server monitors the status of multiple Minecraft Bedrock and Java servers. It uses a PostgreSQL database for persistence and provides a Web API with Read/Write API key authentication.

View on GitHub

Last updated: N/A

aoirint_mcping_server

Feature

  • Monitoring status of multiple Minecraft Bedrock/Java servers
  • Persistence by PostgreSQL database
  • Web API with Read/Write API key authentication

Supported Minecraft server versions

  • Bedrock 1.20.x
  • Java 1.20.x

Deploy

Docker Compose

Copy these files to a new directory and configure.

  • docker-compose.yml
  • template.env -> .env

Start Docker Compose services.

docker compose up -d

Then, apply database migrations.

Docker repository

Database migration

This repository uses golang-migrate.

To apply the migrations,

docker compose run --rm migrate -path=/migrations -database="postgres://postgres:postgres_password@postgres:5432/postgres?sslmode=disable" up

Library management

  • Python 3.12

This repository uses Poetry.

Code format

poetry run ruff check --fix
poetry run ruff format

poetry run mypy .