The REST server that powers the public API for mcstatus.io.
Go to file
2023-09-05 21:17:18 -05:00
.github/workflows Update Go version used by GitHub Actions 2023-09-05 21:17:18 -05:00
src Fix empty icon 2023-08-28 07:45:15 -05:00
.gitignore Undo blocked servers cache list 2022-08-21 01:00:13 -05:00
config.example.yml Ability to enable/disable locks 2023-07-19 21:16:22 -05:00
docker-compose.yml Dockerfile, Error handling, comments, docker-compose (#2) 2023-03-30 10:53:31 -05:00
dockerfile Dockerfile, Error handling, comments, docker-compose (#2) 2023-03-30 10:53:31 -05:00
go.mod Update dependencies and refactor config variable 2023-08-27 21:51:33 -05:00
go.sum Update dependencies and refactor config variable 2023-08-27 21:51:33 -05:00
LICENSE Add initial code 2022-07-30 22:13:16 -05:00
Makefile Update dependencies 2023-04-16 16:57:10 -05:00
README.md Update README 2023-08-19 14:14:47 -05:00

Ping Server

This is the source code for the API of the mcstatus.io website (api.mcstatus.io). This API server is built using Go with Fiber as the HTTP server of choice. This uses a custom Minecraft utility library found in the mcstatus-io/mcutil repository. You are free to modify and host your own copy of this server as long as the license permits. If you do not wish to self host, we host a public and free-to-use copy which you may learn more about by visiting the official API documentation.

API Documentation

https://mcstatus.io/docs

Requirements

Getting Started

# 1. Clone the repository (or download from this page)
$ git clone https://github.com/mcstatus-io/ping-server.git

# 2. Move the working directory into the cloned repository
$ cd ping-server

# 3. Run the build script
$ make

# 4. Copy the `config.example.yml` file to `config.yml` and modify details as needed
$ cp config.example.yml config.yml

# 5. Start the development server
$ ./bin/main

# The server will be listening on http://localhost:3001 (default host + port)

License

MIT License