Bedrock Server Versions

This repo serves as a quick hack to solve an issue I've had working on mcsm: how to get a list of valid versions for Minecraft Bedrock Edition's servers.

The solution I've gone with is having a binary that scrapes Gamepedia for all listed versions, sorts, and caches the response in a local JSON file. Now, to consume the cached response, clients can make an HTTP request for the raw content of the file from GitHub and parse the response into a JSON struct from there!

How to Use

From a Unix terminal, the following would work:

curl https://raw.githubusercontent.com/loksonarius/bedrock-server-versions/main/versions.json

Though realistically, any code that can make an HTTP request and parse JSON will work. Below is a snippet for doing this in Go:

package main

import (
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	source := "https://raw.githubusercontent.com/loksonarius/bedrock-server-versions/main/versions.json"
	resp, err := http.Get(source)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, err := ioutil.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}

	parsedResponse := struct {
		LastUpdated string
		Versions    []string
	}{}

	if err := json.Unmarshal(out, &parsedResponse); err != nil {
		panic(err)
	}

	for _, v := range parsedResponse.Versions {
		fmt.Println(v)
	}
}

Caveats

Needless to say, concessions are made with this approach. To be explicit:

• this is not an API, so please keep expectations reasonable
• this is a cached response, not a live fetch -- expect things to be out of date
• there is no validation done to ensure returned versions are available for download from Mojang's servers
• the versions being returned are server versions, not client versions

Updates

The repo is set up to scrape Gamepedia once a week for server versions and update the versions.json file. The last run scrape time for a response will be stored in the LastUpdated field of the struct in versions.json.

Running Locally

The following can be used to run a scrape locally:

go run main.go