Skip to content

Highly scalable Minecraft cluster

Posted on:November 3, 2023 at 05:20 PM

Are you planning a very large Minecraft LAN party? Then this article is for you. Here I show you how to set up a highly scalable Minecraft cluster.

What is a Minecraft cluster?

A Minecraft cluster is a Minecraft server network that consists of multiple Minecraft servers. These servers are connected to each other via a network and can therefore be shared. This means that you can play with your friends on a server that consists of multiple servers.

How does a Minecraft cluster work?

A Minecraft cluster consists of several components.

Minecraft cluster

Master database

First, there is the master database. This database allows servers to store data in a central location that all servers can access. Servers store chunks, maps, level.dat, player data, banned players, and more in this database. This database also records which chunk belongs to which server and coordinates communication between servers.


The master database is great for storing data, but not so good at synchronizing data in real time between servers. This is where peer-to-peer communication comes in. Each server establishes a connection to another server so that data between them can be updated in real time. When a player on server A attacks another player on server B, server A sends this data directly to server B so that server B can damage the player and apply any knockback.

Load Balancer

The load balancer is the last component of the cluster. A load balancer is required to distribute players evenly across your servers. A load balancer automatically distributes players between servers to distribute the load evenly across the individual servers.

Why do I need multiple servers?

By having multiple servers, we can distribute the load across multiple servers. This means that we can have more players on our servers without the servers becoming overloaded. With this setup, we can also easily add new servers if we get more players. If the number of players decreases again, the server can be removed again.


You should be familiar with Kubernetes and have set up a Kubernetes cluster. I recommend k3s.

You should also be familiar with Helm. I recommend Helm 3.


First, you should clone the repository.

git clone
cd MultiPaperHelm/

I installed the entire setup in a separate namespace. You can create this namespace with the following command.

kubectl create namespace minecraft

Next, we install the Minecraft cluster with Helm.

helm install multipaper . --namespace minecraf

Once the Helm chart is installed, you can view the port of the proxy service.

kubectl describe service multipaper-master-proxy -n minecraft

This port is the port that you need to enter in your Minecraft client.


The Helm chart creates several ConfigMaps. In these ConfigMaps, you can customize the configuration of your cluster.

For example, you can set the number of maximum players or change the description of the server.

For more information on the individual config files, see MultiPaper.


With this setup, you can easily set up a highly scalable Minecraft cluster. You can easily add new servers if you get more players and remove them again if the number of players decreases again.

You can test this setup under the following Server Address:

If you have any questions, feel free to contact me on Email or on Matrix.